Installing a Test Instance

Profound Logic highly recommends testing new versions of Profound UI in a test instance before installing it in your production instance. The Instance Management Tools that you will need for this are available in Profound UI starting with Version 5, Fix Pack 4.0. If you have a version that is older than Version 5, Fix Pack 4.0, you will need to install an instance of Profound UI that is at the most recent version so that you can have these tools. You can install as many instances of Profound UI on the same server/LPAR as you'd like by simply going through the installation process for each new instance you'd like to have. Once you have the necessary tools for creating a test instance, you can follow the steps given below. 

Step 1: Create a Copy of the Existing Instance

To create a copy of your existing instance, you will use the Copy Profound UI Instance Tool. You'll need to give this copy a different name and port number from the original instance. For example, if the original instance was named PROFOUNDUI and used port 8080, you might call your test instance 'PUITEST' and use port 8081. You would copy with the instance with the following command: 

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

Step 2: Upgrade the Test Instance

Once you have your instance created, you will need to upgrade your test instance to the most recent version of Profound UI. It can be downloaded from our website here:  http://www.profoundlogic.com/download. Once you've downloaded the current version, you should follow the installation instructions here: Installing Profound UI. Make sure that you use the library and port number that match the test instance name (PUITEST and 8081) as we've used in the example above. 

If you choose to use the green-screen installer, you would use this command:

PUIINSTALL HTTPINST(PUITEST) HTTPPORT(8081) SAMPLES(*NO)

You can also prompt the PUIINSTALL command for additional parameters that you might want to specify.

Step 3: Test Profound UI

Once the installation has completed, test each Profound UI component that you are using to make sure everything works properly. You can start by accessing the Welcome page with this URL:  http://your-system:port/profoundui/welcome.

Step 4:  Run the Installer Again

When the testing is complete, you can run the installer again using the 'production' instance name and port. The default instance name is PROFOUNDUI and the default port is 8080, but you may have changed these when you installed Profound UI originally. This will require your users to log off of Profound UI during the upgrade. When it has completed, your Profound UI installation should be running the new version.

When you no longer need the test copy of the instance, it can be deleted by using the Delete Profound UI Instance Tool:

PUIDLTINST INST(PUITEST) RMVUSRDTA(*YES)