IBM Rational COBOL Generation Extension for zSeries Interim Fix 001 - Local installation instructions

For Rational COBOL Generation Extension for zSeries, Version 6.0.1

© Copyright IBM Corporation 2004, 2006. All Rights Reserved.

Contents

1.0 Overview
2.0 Installation prerequisites
3.0 Installing the interim fix
4.0 Installing product updates from a command line
5.0 Creating a local mirror of the update server
6.0 Uninstalling the interim fix
7.0 Customer support

1.0 Overview

This document describes how to install a downloaded version of Interim Fix 001 for IBM® Rational® COBOL Generation Extension for zSeries, Version 6.0.1. This document also links to instructions that describe how to create a local mirror of your product update server.

2.0 Installation prerequisites

To download, extract, and install the interim fix, you will require 200 MB of disk space.

Before you can install this interim fix, you must install:

To verify the current version numbers of the product and installed interim features:

  1. Start Rational Product Updater:

  2. Click the Installed Products tab.

If you disabled any product features by modifying the feature.xml files or through the Update Manager by clicking Help > Software Updates > Manage Configuration, you must enable them before you install this interim fix.

3.0 Installing the interim fix

Install the interim fix with the same user account that installed the product.

Restrictions:

To install the interim fix, complete the following steps:

  1. Start Rational Product Updater:

    2. Note: On Red Hat Enterprise Linux 3.0 and SuSE Linux Enterprise Server 9.0, if you use a desktop environment other than the default, the product shortcuts might not appear in the default location.

  2. Click Preferences > Update Sites.
  3. Navigate to temp_dir\rad\policy_60110301_interim_fix001.xml, where temp_dir is the location of the extracted interim fix.
  4. Click OK.
  5. Click Find Updates.


    6. If your computer does not have Internet access, or cannot connect to the live IBM update server, a warning appears in Rational Product Updater that states that other update sites are not available. You can ignore this warning if you installed IBM Rational Product Updater 6.0.1.

    If your computer has Internet access and can connect to the live IBM update server, and if Rational Product Updater requires an update, you are prompted to install it before you can continue. Click OK. Rational Product Updater installs the update, restarts, and retrieves a list of available updates.

  6. Select Interim Fix 001 for Rational COBOL Generation Extension for zSeries 6.0.1.
  7. Click Install Updates.
  8. In the License Agreement window, read the license agreement and, if you accept the terms and conditions, click I accept the terms in the license agreement; then click OK.


    9. After the installation is complete, Rational Product Updater lists the installed updates on the Installed Products page.

  9. Close Rational Product Updater.

4.0 Installing product updates from a command line

You can install product updates, such as interim fixes, fix packs, and refresh packs, from a command line so that you do not have to monitor or input information during the installation.

For more information about installing product updates from a command line, see Running Rational Product Updater from a command line in the product updater help.

5.0 Creating a local mirror of the update server

You might want to create a local mirror of the update server in the following situations:

For instructions on how to create a local mirror of the Rational Application Developer update server, visit www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/60/local_mirror/6011/local_mirror.html.

For instructions on how to create a local mirror of the Rational Software Architect update server, visit www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rsa/60/local_mirror/6011/local_mirror.html.

If you create a local mirror of the Rational Application Developer or Rational Software Architect update server, then you can add Interim Fix 001 for IBM Rational COBOL Generation Extension for zSeries, Version 6.0.1 to your local mirror. To add the interim fix to your local mirror:

  1. Create a local mirror of the Rational Application Developer or Rational Software Architect update server. For instructions, visit www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/60/local_mirror/6011/local_mirror.html for Rational Application Developer or www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rsa/60/local_mirror/6011/local_mirror.html for Rational Software Architect. Ensure that your mirror site contains the prerequisites for Interim Fix 001 for IBM Rational COBOL Generation Extension for zSeries, Version 6.0.1.
  2. Download the interim fix from ftp://ftp.software.ibm.com/software/rationalsdp/bdcz/60/zips/bdcz601_interim_fix001.zip.
  3. Extract the interim fix to the same target directory you are using to stage your local mirror site.
  4. Edit the policy.xml file that you created for your local mirror site and add a URL map for the updates to Rational COBOL Generation Extension for zSeries. The URL map must contain a path to the site.xml file (site_60110301_interim_fix001.xml) provided in the extracted zipped file.

    For example, if you created your mirror site on your local machine, your URL map would be:
    <url-map pattern="com.ibm.rational.egl.cobolgen.feature.update" url="file:./../bdcz/60/update/site_60110301_interim_fix001.xml"/>

    If your mirror site is on a Web server named server1, and the updates were extracted in a folder named rational_updated, then your URL map would be:
    <url-map pattern="com.ibm.rational.egl.cobolgen.feature.update" url="http://server1/rational_updates/bdcz/60/update/site_60110301_interim_fix001.xml"/>

    Your policy.xml file would look similar to the following example:
    <?xml version="1.0" encoding="UTF-8" ?>
    <update-policy>
       <url-map pattern="com.ibm.rational.application.developer.update" url="http://server1/rational_updates/rad/60/update/site.xml"/>
       <url-map pattern="com.ibm.rational.application.developer.discovery" url="http://server1/rational_updates/rad/60/discovery/site.xml"/>
       <url-map pattern="com.ibm.rational.egl.cobolgen.feature.update" url="http://server1/rational_updates/bdcz/60/update/site_60110301_interim_fix001.xml"/>
       <url-map pattern="com.ibm.orca.product.updater" url="http://server1/rational_updates/rpu/60/update/site.xml"/>
    </update-policy>

6.0 Uninstalling the interim fix

Uninstall the interim fix with the same user account that installed the product.

Restrictions:

To uninstall the interim fix, complete the following steps:

  1. Start Rational Product Updater:

    2. Note: On Red Hat Enterprise Linux 3.0 and SuSE Linux Enterprise Server 9.0, if you use a desktop environment other than the default, the product shortcuts might not appear in the default location.

  2. Click the Rollbacks tab. An inventory of installed product updates and features is displayed on the Rollbacks page.
  3. Select Interim Fix 001 for Rational COBOL Generation Extension for zSeries 6.0.1.


    4. Dependencies between updates are enforced automatically. If you select to roll back an update on which other installed updates depend, the dependent updates are also selected to roll back.

  4. Click Roll Back Updates.
  5. Close Rational Product Updater.

7.0 Customer support

When you contact customer support, the support representative will require the versions of the installed products or interim features on your system.

To determine the versions, complete the following steps:

  1. Start IBM Rational Product Updater:
  2. Click the Installed Products tab.

For product news, updates, and fixes, consult the following sites for information regarding EGL COBOL Generation: