Profound Pro Tips is a blog series focused on issues that our support team receives and questions our Profound Logic customers have. Don't see your question/concern in Profound Pro Tips? Please feel free to contact our team or leave us a comment below. 

With the release of Profound UI Version 5, Fix Pack 14.0, this week we will show you how easy it is to upgrade your older version of Profound UI.

Upgrading to the latest version of Profound UI can help you with bug fixes and give you the newest features. It might seem like upgrading is more of a hassle than it is worth. But upgrading Profound UI is actually easier than you might think! The instance tool PUICPYINST and these four easy steps will make updating Profound UI a breeze. 

Important Note! We do not suggest that you install a new version directly to production! Always install a test instance first to determine any potential issues before sending to production!

Step 1: Download the Current Version of Profound UI

This step is easy: head over to our Download Page and select Profound UI from the drop-down menu. Then, select your installer (GUI or SAVF) and click the 'Download' button. You may need to login before accessing the download screen. Just make an account if you don't already have one to access the downloads. 

PLEASE NOTE: PTFs may be required in order for newer versions to work properly on some systems. 

Step 2: PUICPYINST

Open a Genie or 5250 session. Make sure a post Version 5, Fix Pack 4.0 instance is in your library list so that you have access to the Instance Management Tools that became available in Version 5, Fix Pack 4.0. If your current instance is pre Version 5, Fix Pack 4.0, please install the current version of Profound UI, Version 5, Fix Pack 14.0, to a new instance and add it as the first library in your library list. With your library list up-to-date in your instance you can then enter the following line:

PUICPYINST FROMINST([instanceToCopy]) TOINST([newInstanceName]) TOPORT([Port])

Be sure to replace the [ ] with the information related to your instances. Remember to use a different name and different port for this new instance. This might result in some musical chairs action with your ports and instance names, but the bug fixes and new features are well worth it! Here is a complete example of copying an instance PROFOUNDUI on PORT 8080 to a new instance PUITEST on PORT 8081:

PUICPYINST FROMINST(PROFOUNDUI) TOINST(PUITEST) TOPORT(8081)

If you need additional assistance using PUICPYINST, please refer to the following documentation pages:

http://www.profoundlogic.com/docs/display/PUI/Installing+a+Test+Instance
http://www.profoundlogic.com/docs/display/PUI/Instance+Management+Tools
http://www.profoundlogic.com/docs/display/PUI/Copy+Profound+UI+Instance+Tool

Step 3: Upgrade the Test Instance

Since the steps for installation differ between GUI and SAVF, please refer to our installation guides on our documentation website for details on how to install a new instance. 

GUI:
http://www.profoundlogic.com/docs/display/PUI/Installing+Profound+UI

SAVF:
http://www.profoundlogic.com/docs/display/PUI/Installing+ProfoundUI+using+the+Green+Screen+Installer

As an example, for the GUI, run the installer using the instance name and port you specified when using PUICPYINST. You do this by selecting the Customize... button in the installer and changing the port and instance name in the popup.

Step 4: Check Out the Results

Remember, this is a test instance to test out the new version before taking it to production. You can start by going to your Welcome Page and going through each of your components and programs to make sure everything is correct. 

http://[Host]:[Test Port]/profoundui/welcome

If everything checks out, then you are ready to install to your production instance. Just run the installer again and upgrade your production instance by clicking the Customize... button and entering your production instance name and port in the popup. When you are done, you can continue to use the test instance you created for testing or you can delete it using the PUIDLTINST instance tool.

PUIDLTINST INST(PUITEST) RMVUSRDTA(*YES)

You can learn more about our PUIDLTINST instance y going to our documentation page:

http://www.profoundlogic.com/docs/display/PUI/Delete+Profound+UI+Instance+Tool

Now you should be ready to use the brand new version of Profound UI and be able to upgrade future versions as they are released.!