Installation Manager iFix for APAR PI76010 for Rational Development and Test Environment for System z Version 9.1

Product Description

Rational® Development and Test Environment (RD&T) may fail to obtain a license key with message RC 312: license server time out: not able to get licenses. This error may occur after applying updates to the Linux operating system.

The issue affects RD&T V8.5, 9.0, 9.1, 9.5, as well as IBM® z Systems Development and Test Environment (zD&T) V10.0 when running on Red Hat Enterprise Linux (RHEL) V7.3 and 7.2. An Installation Manager (IM) iFix is currently available for RD&T V9.1.

9.1.0.0-Rational-RDT-IFIX02

APAR PI76010

Installing the iFix for Rational Development and Test Environment for System z v9.1

This fix can only be installed on a system where Rational Development and Test Environment for System z® Version 9.1 is currently installed. To install this update, you need to use root privileges. Follow these steps to install the update:

  1. Uninstall the existing RDT9.1 installed on the machine.
  2. Download the 9.1.0.0-Rational-RDT-IFIX02 file from the support website.
  3. Extract 9.1.0.0-Rational-RDT-IFIX02.zip to a folder on your system. These files are temporary, and you can delete them after completing the installation.
  4. Use the following command from a terminal window to start IBM Installation Manager: /opt/IBM/InstallationManager/eclipse/IBMIM.
  5. From the menu bar, select File > Preferences, then click Add Repository.
  6. In the Add Repository dialog, browse to the directory where you extracted the updated installation files. Select the disk1 folder from inside the zdtbase folder, and then select the diskTag.inf file. Click OK.
  7. Click OK to add the new repository diskTag.inf file.
  8. Click OK in the Preference - Repositories dialog to return to the main menu.
  9. Click Install.
  10. Select Rational Development and Test Environment for System z and click next.
  11. Read the license and accept before clicking Next. Review your selections on the Summary panel. If you need to make any changes to your selections, click Back and make changes. When you are ready to install, click Install.
  12. When the Installation is complete, a message is displayed by IBM Installation Manager to inform you that the packages are installed. You can click View Log File to view the log file for the current Installation Manager session. When you are finished, click Finish.
  13. Exit IBM Installation Manager.

Installing product updates from a command line

You can install product updates, such as interim fixes and Fix Packs, in console mode or from the command line. Additionally, you can install product updates in silent mode so that you do not have to monitor or input information during the installation. For more information about installing product updates, see Working from the command line, Working in console mode, and Working in silent mode in the IBM Installation Manager help. In all of these modes, the same basic steps must be performed in a workstation installation; add the repository with the update, and perform the update itself. To perform a silent install to update an existing V9.1 system, follow these steps:

  1. Uninstall the existing RDT9.1 installed on the machine.
  2. From the root user id, use the cp command to copy the rdt91_response_file.xml file from the SilentInstall folder on the z Systems Development and Test Environment Installation disc to a location where you can edit the file.
  3. Open the editable response file in an editor and modify the following line <repository location=’..’/> as follows:
    <repository location=’/absolute path to the unzipped fix directory/disk1’/>
  4. Modify the following line <offering id=’..’ version=’..’/> as follows:
    <offering id='com.ibm.rational.development.test.environment.systemz' version='9.1.0.zdtbase910iFix2-I20170328_1505' profile='Rational Development and Test Environment for System z' installFixes='none'/>
  5. Save the updated response file.
  6. View the license text for Rational Development and Test Environment for System z in file xx.html, where xx is your language of preference. You can find this file in the License directory of the Rational Development and Test Environment for System z Installation disc.
  7. Enter the following command:
    /opt/IBM/InstallationManager/eclipse/tools/imcl input /absolute
      path to modified response file/rdt91_response_file.xml 
      -log log_file_name -acceptLicense

Verifying your installation

To verify the update you installed, go to the File->View Installed Packages menu item in Installation Manager. You should see Rational Development and Test Environment for System z 9.1.0.0 iFix2 listed. Also, run the command z1090instcheck to check if the conditions of your system are favorable for z Systems Development and Test Environment. You should run this command from the userid configured to run the z Systems Development and Test Environment application. The location of the program is: /usr/z1090/bin/z1090instcheck.

Uninstalling the update

Rational Development and Test Environment for System z Version 9.1.0.0 iFix2 does not need to be rolled back. If you must roll back, use the Rollback option of Installation Manager.