IBM i Installation - Upgrade Installation to New Release
Currently, IBM i runs Workload Automation 5.1.1. These pages provide information for that version.
Upgrade Procedures
To upgrade Workload Automation 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
V5R4 systems
Before installing Workload Automation for IBM i, either download and apply PTF SI27629 or verify that it is applied to the system.
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-5.1.1 release (5.1.0 or earlier) of Workload Automation for IBM i before installing a 5.1.1 release. You can do so either before or after installing the 5.1.1 release (see Product Removal).
However, if you want to install a 5.1.1 release to the previously used installation libraries of a pre-5.1.1 release, you must first uninstall that pre-5.1.1 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 Workload Automation release (5.1.1) 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 5.1.1 (or previous release) to Workload Automation, 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. At a minimum, the Workload Automation license entries must be entered into the configuration file members for the managers of each licensed product. |
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 likewise must customize the newly installed exit programs. The exit programs are located in the product library, UNVPRD511. Note You cannot replace UCMSJOBI for 5.1.0 with programs of the same name from previous releases without a possible conflict. If you must use older programs because their source is no longer available, rename them and call them from the new exit program. See UCMSJOBI in Universal Command Server for IBM i - Commands for additional information. |
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 Workload Automation for IBM i commands in QSYS to the untagged command names in UNVPRD511.
- Tag the pre-5.1.1 release command names in QSYS with the version / release / modification number of that release (for example, 320).
See UCHGRLS (Change Release Tag) Program for information on using UCHGRLS.
Change Port Address
No two Workload Automation 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. Workload Automation 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.