IBM i Installation - Upgrade Installation to New Release
- Stonebranch (Deactivated)
- Tony Partin
Currently, Universal Agent 7.7.0 for IBM i does not include Universal Command (UCMD) or Universal Data Mover (UDM). Customers who require those components should use an older version of Workload Automation for IBM i. The latest version containing those components is 5.1.1. Older versions of Workload Automation for IBM i can be installed alongside version 7.7.0.
Upgrade Procedures
To upgrade Universal for IBM i from a currently installed pre-5.1.1 release (release 5.1.0 or earlier) to a 5.1.1 release, the following procedures are required:
- Install (Default or Custom)
- Post-Install Tasks
- Pre-Production Tasks
Print Files Removal
In releases 4.1.0 - 4.3.0, Job Log Copy Keep used the USBMJPRTF and UCMSVRPRTF print files.
Starting with release 5.1.0, these print files are no longer used and will be removed during the installation process. The spooled job logs will not be lost because they are spooled to the QEZJOBLOG output queue.
To print job logs from a previous release, use the CHGSPLFA command to associate the job logs with a different printer file.
Currently Installed Release
You are not required to delete a currently installed pre-7.7.0 release (5.1.1 or earlier) of Universal Agent for IBM i before installing a 7.7.0 release. You can do so either before or after installing the 7.7.0 release (see Product Removal).
However, if you want to install a 7.7.0 release to the previously used installation libraries of a pre-7.7.0 release, you must first uninstall that pre-7.7.0 release:
Step 1 | Save configuration, component, NLS, and any other files from the product library (UNVPRD*** / UNIVERSAL) that may contain information needed after the new installation. |
|---|---|
Step 2 | Save any files from the command reference library (UNVCMDREF) and temporary library (UNVTMP*** / UNVTMP) that are needed, as these libraries will be deleted by the uninstall process. |
Step 3 | Follow the release-appropriate uninstall process (see Product Removal) and the New Release installation procedure (see Install (Default or Custom), below, to install the new release. |
Step 4 | After the new installation is complete, merge required configuration and any other saved information as well as any needed files and/or members from the previous release into the new release. |
Install (Default or Custom)
The processes (default or custom) for the upgrade installation to a new Universal Agent release (7.7.0) are the same as the processes for a new installation.
See New Installation (Default) and New Installation (Custom) to determine which process is most appropriate for your environment.
Post-Install Tasks
After the installation upgrade of 7.7.0 (or previous release) to Universal Agent, perform the following steps:
Step 1 | Copy any customized code page files from the UNVNLS file members from the previous release to the newly installed UNVNLS file. Note Do not simply copy the old UNVNLS file to replace the new UNVNLS file. The new files contain many updates. |
|---|---|
Step 2 | If needed, manually update the newly installed configuration file, UNVCONF, from the file of the previous release. The new file contains many new configuration options. |
Step 3 | If the original component file (UNVCOMP) was modified, update the newly installed UNVCOMP file for each of the modified members. |
Step 4 | If either or both of the exit programs (UCMSJOBI and UCMSJOBT) in the previous release had been customized, you may want to customize the related newly installed exit programs for UAG (UAGSJOBI and UAGSJOBT). The exit programs are located in the product library, UNVPRD770. |
Pre-Production Tasks
Change Release Tags
When you are ready to take the new release to production, you can use the UCHGRLS (Change Release Tag) program to:
- Rename the Universal Agent for IBM i commands in QSYS to the untagged command names in UNVPRD770.
- Tag the pre-7.7.0 release command names in QSYS with the version / release / modification number of that release (for example, 511).
See UCHGRLS (Change Release Tag) Program for information on using UCHGRLS.
Change Port Address
No two Universal Agents installed under the same IBM-i can have the same port number associated with the Universal Broker subsystem (UBROKER). Change the default port address, 7887, to another port number for all but one of the UBROKER subsystems. Universal Agent components and utilities intended to use the altered port number must specify a port number in the commands or program calls. Whether or not a command or program call is used depends on the platform from which the request is sent.
Note
Do not replace a configuration file with one from a different release.