J2EE Connector Tools Feature for Rational Software Architect - Local installation instructions

For Rational Software Architect, Versions 6.0.0.1 and 6.0.1

This file is available in the following national languages:

Brazilian Portuguese	Chinese - Simplified	Chinese - Traditional
French	German	Italian
Japanese	Korean	Spanish

Contents

1.0 Overview

This document describes how to install or update a downloaded version of the J2EE Connector Tools Feature for IBM^® Rational^® Software Architect. This document also links to instructions that describe how to create a local mirror of your product update server.

2.0 Installation and update prerequisites

To download, extract, and install or update the feature from a ZIP file, you will require 280 MB of disk space.

Before you can install this feature you must install either Rational Software Architect Refresh Pack 6.0.1 or Rational Software Architect Fix Pack 6.0.0.1. Note: It is recommended that you install Rational Software Architect Refresh Pack 6.0.1 if you have not already installed either Refresh Pack 6.0.1 or Fix Pack 6.0.0.1.

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

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

3.0 Installing the feature

If you have already installed a previous version of this feature, you do not have to install the feature again. Please see section 4.0 Updating the feature for instructions that describe how to update this feature.

Install the feature with the same user account that installed the product.

Restrictions:

• The product cannot be open when you install this feature.
• 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 feature, 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\rsa\policy_j2c_601.xml, where temp_dir is the location of the extracted feature.
4. Click OK.
5. Click Find Optional Features if an earlier version of the J2EE Connector Tools feature is not already installed.
6. Select J2EE Connector Tools.
7. Click Install Features.
8. To accept the license agreement and continue the installation, click OK.


Depending on the speed of your computer processor and the amount of RAM in your computer, the feature might take an extended period of time to install.

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


9. Close Rational Product Updater.

4.0 Updating the feature

Update the feature with the same user account that installed the product.

Restrictions:

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

To update the feature, 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\rsa\policy_j2c_601.xml, where temp_dir is the location of the extracted feature.
4. Click OK.
5. Click Find Updates if an earlier version of the J2EE Connector Tools feature is already installed.
6. By default, all available updates are selected. Ensure that you select J2EE Connector Tools.
7. Click Install Updates.
8. To accept the license agreement and continue the installation, click OK.


Depending on the speed of your computer processor, the amount of RAM, and the speed of your Internet connection, the update might take an extended period of time to download and install.

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


9. Close Rational Product Updater.

5.0 Installing features from a command line

You can install features from a command line so that you do not have to monitor or input information during the installation.

For more information about installing features 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 Software Architect update server, visit www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rsa/60/local_mirror/601/local_mirror.html.

7.0 Uninstalling the feature

Uninstall the feature with the same user account that installed the product.

Restrictions:

• The product cannot be open when you uninstall this feature.
• 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 feature, 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 J2EE Connector Tools.


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 Customer support

For product news, events, support, and other information, see the Rational Software Architect home page at www.ibm.com/software/awdtools/architect/swarchitect/.