(877) 224-7768 <>
sales@profoundlogic.com <mailto:sales@profoundlogic.com>

iModernize - The Profound Logic Software Blog

Profound Pro Tips: How to Upgrade Profound UI Easily

Posted by Tim Losee on Jan 31, 2018 12:57:15 PM

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. 

PUI Upgrade 1.png

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


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:


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


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. 



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.

PUI Upgrade 2.png PUI Upgrade 3.png


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.


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


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.!

Learn how to Make Modern Applications That You Will Love With IBM i RPG and Node.js with Profound UI and Profound.js! This live webinar will be hosted by Alex Roytman and Liam Allan | February 14th at 10:30am PT.


Topics: RPG Development, Application modernization, IBM i applications, Node.js, Profound.js, IBM i, RPG, AS400 modernization, IBM i Modernization, Agile modernization, iSeries, Legacy Modernization, Profound UI, AS 400, AS_400, Profound Logic

Subscribe to Blog Updates

...and get The 2017 State of IBM i Modernization White Paper FREE!

cover page.png

Recent Posts