IBM Rational COBOL Generation Extension for zSeries Fix Pack 6.0.1.2 - Installation instructions

For Rational COBOL Generation Extension for zSeries, Version 6.0.1

Contents

1.0 Overview

This document describes how to install Fix Pack 6.0.1.2 for IBM^® Rational^® COBOL Generation Extension for zSeries^®, Version 6.0.1 by using IBM Rational Product Updater. This fix pack is provided as a cumulative update.

You should use Rational Product Updater to install this fix pack directly from the IBM update server; however, you can also download a ZIP file that contains this fix pack and then use Rational Product Updater to perform local installations. The following sections describe how to install this fix pack.

2.0 Installation prerequisites

This section describes the installation prerequisites specific to this fix pack.

2.1 Hardware prerequisites

To install the fix pack directly from the IBM update server, you will require 10 MB of disk space. If you download, extract, and install the fix pack, you will require 20 MB of disk space.

2.2 Software prerequisites

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

• Rational COBOL Generation Extension for zSeries, Version 6.0.1.
• IBM Rational Product Updater 6.0.1 or later.

If you use the default update site preferences, IBM Rational Product Updater 6.0.2 is automatically installed when you search for updates or optional features. However, if you change the default update site preferences by clicking Preferences > Update Sites, you must restore the default settings before you can install the fix pack.

• Rational Application Developer Fix Pack 6.0.1.2 or Rational Software Architect Fix Pack 6.0.1.2.

  Installation instructions for Rational Application Developer Fix Pack 6.0.1.2 are available at www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/60/install_instruction/6012/install.html.

  Installation instructions for Rational Software Architect Fix Pack 6.0.1.2 are available at www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rsa/60/install_instruction/6012/install.html.

2.3 Other prerequisites

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 fix pack.

3.0 Installing the fix pack from the IBM update server

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

Restrictions:

• The product cannot be open when you install this fix pack.
• On Windows^® operating systems, you must use an account with Administrator privileges. On Linux^® operating systems, you must log in as root.

To install the fix pack directly from the IBM update server, complete the following steps:

1. Start Rational Product Updater:
   • On Windows operating systems, click Start > Programs > IBM Rational > Rational Product Updater.
   • On Red Hat Enterprise Linux 3.0 (GNOME desktop environment), open the main menu and click Programming > Rational Product Updater.
   • On SuSE Linux Enterprise Server 9.0 (K Desktop Environment), open the main menu and click IBM Rational > Rational Product Updater.

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 Find Updates.


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.


3. By default, all available updates are selected. Ensure that you select ECG Fix Pack 6012.
4. Click Install Updates.
5. 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.


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


6. Close Rational Product Updater.

4.0 Installing from a compressed file containing this fix pack

You can install the fix pack directly from the IBM update server as described above; however, it is also available for download.

You might want to download a compressed file and install the fix pack locally in the following situations:

• You have a slow or unstable Internet connection and want to use a download manager that can resume the download.
• You have difficulty accessing the live IBM update servers from behind a firewall.
• You prefer to download the fix pack and install it later.

4.1 Downloading the compressed file and extracting the fix pack contents

You should install the fix pack directly from the IBM update server as described above; however, it is also available for download. You might want to download and install the fix pack in the following situations:

• You have a slow or unstable Internet connection and want to use a download manager that can resume the download.
• You have difficulty accessing the live IBM update servers from behind a firewall.
• You prefer to download the fix pack and install it later.

To download and install the fix pack, complete the following steps:

1. Download the fix pack from ftp://ftp.software.ibm.com/software/rationalsdp/bdcz/60/zips/bdcz6012_fixpack.zip.
2. Extract the fix pack to a temporary directory, such as C:\temp.

4.2 Installing the intermim fix

After you have downloaded the compressed file that contains this intermim fix, you can install the fix pack from the extract contents by using the same user account that installed the product.

Restrictions:

• The product cannot be open when you install this fix pack.
• On Windows operating systems, you must use an account with Administrator privileges. On Linux operating systems, you must log in as root.

To install the fix pack, complete the following steps:

1. Start Rational Product Updater:
   • On Windows operating systems, click Start > Programs > IBM Rational > Rational Product Updater.
   • On Red Hat Enterprise Linux 3.0 (GNOME desktop environment), open the main menu and click Programming > Rational Product Updater.
   • On SuSE Linux Enterprise Server 9.0 (K Desktop Environment), open the main menu and click IBM Rational > Rational Product Updater.

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_6012_6012.xml, where temp_dir is the location of the extracted fix pack.
4. Click OK.
5. Click Find Updates.


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 or later.

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 fix pack 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.


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


9. Close Rational Product Updater.

5.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.

6.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:

• You administer a set of product installations and want to control which updates are available to users.
• You administer a set of product installations that do not have direct access to the Internet.

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/6012/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/6012/local_mirror.html.

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

1. Create a local mirror of the Rational Application Developer or Rational Software Architect update server. Ensure that your mirror site contains the prerequisites for Fix Pack 6.0.1.2 for IBM Rational COBOL Generation Extension for zSeries, Version 6.0.1.
2. Download the fix pack from ftp://ftp.software.ibm.com/software/rationalsdp/bdcz/60/zips/bdcz6012_fixpack.zip.
3. Extract the fix pack 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__6012_6012.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_6012_6012.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_6012_6012.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_6012_6012.xml"/>
      <url-map pattern="com.ibm.orca.product.updater" url="http://server1/rational_updates/rpu/60/update/site.xml"/>
   </update-policy>

7.0 Uninstalling the fix pack

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

Restrictions:

• The product cannot be open when you uninstall the fix pack.
• On Windows operating systems, you must use an account with Administrator privileges. On Linux operating systems, you must log in as root.

To uninstall the fix pack, complete the following steps:

1. Start Rational Product Updater:
   • On Windows operating systems, click Start > Programs > IBM Rational > Rational Product Updater.
   • On Red Hat Enterprise Linux 3.0 (GNOME desktop environment), open the main menu and click Programming > Rational Product Updater.
   • On SuSE Linux Enterprise Server 9.0 (K Desktop Environment), open the main menu and click IBM Rational > Rational Product Updater.

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 ECG Fix Pack 6012.


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.

8.0 IBM Rational Software Support

IBM Rational Software Support provides you with technical assistance.

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:
   • If the product is running, click Help > Software Updates > IBM Rational Product Updater.
   • On Windows operating systems, click Start > Programs > IBM Rational > Rational Product Updater.
   • On Red Hat Enterprise Linux 3.0 (GNOME desktop environment), open the main menu and click Programming > Rational Product Updater.
   • On SUSE Linux Enterprise Server 9.0 (K Desktop Environment), open the main menu and click IBM Rational > 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:

• The product home page for Rational Application Developer is www.ibm.com/software/awdtools/developer/application/. For FAQs, lists of known problems and fixes, and other support information, visit the support page at www.ibm.com/software/awdtools/developer/application/support/.
• The product home page for Rational Software Architect is www.ibm.com/software/awdtools/architect/swarchitect/. For FAQs, lists of known problems and fixes, and other support information, visit the support page at www.ibm.com/software/awdtools/architect/swarchitect/support/.
• More information on EGL COBOL Generation is available here: www.ibm.com/software/awdtools/eglcobol/index.html
• Visit the EGL zone on developerWorks at www.ibm.com/developerworks/rational/products/egl/

Before you contact IBM Rational Software Support, gather the background information that you will need to describe your problem. When describing a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:

• What software versions were you running when the problem occurred?
• Do you have logs, traces, or messages that are related to the problem?
• Can you reproduce the problem? If so, what steps do you take to reproduce it?
• Is there a workaround for the problem? If so, be prepared to describe the workaround.

9.0 Trademarks and service marks