IBM Rational SoDA Integration Feature - Local installation and update instructions

For Rational Software Architect, Version 6.0 / Rational Software Modeler, Version 6.0
 

Contents

1.0 Overview

This document describes how to install or update a downloaded version of the IBM^® Rational^® SoDA Integration feature. This document also links to instructions that describe how to create a local mirror of your product update server.

Note: Some of the code samples in this document are specific to IBM Rational Software Architect. For users who work with IBM Rational Software Modeler, update variable names and directory names as appropriate.

2.0 Installation and update prerequisites

Before you can install or update this feature you must install either Rational Software Architect Fix Pack 6.0.0.1 or Rational Software Modeler Fix Pack 6.0.0.1.

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

Installation instructions for Rational Software Modeler Fix Pack 6.0.0.1 are available at www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rsm/60/install_instruction/6.0.0.1/install.html.

Warning for users upgrading from IBM Rational SoDA Integration version 6.0.0.003

Issues can occur when upgrading from SoDA integration version 6.0.0.003. For detailed information read the IBM Rational SoDA Integration Release Notes available at www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rsa/60/html/6.0.0.1/soda/readme.html.

This feature offers support for the integration of IBM Rational SoDA for Word version 2003.06.14 or later.

Caution:  Before you can use the Rational Software Modeling SoDA Integration, you must go to the SoDA Patch Download web page at:

http://www-1.ibm.com/support/search.wss?tc=SSSHLQ&rs=935&rankprofile=8&dc=D424&dtm

Select the link which indicates "Rational SoDA for Word V2003.06.14 - Rational Software Architect Integration". This web page includes a link to the SoDA RSA Integration patch and the readme file which describes the patch in detail and how to install it. The SoDA Integration will not work properly until this patch is installed.

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

3.0 Configuring the Rational Product Updater to install the local feature

Note: 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 Configuring the Rational Product Updater to update the local feature for instructions that describe how to update this feature.

Install the feature with the same user account that installed Rational Software Architect or Rational Software Modeler.

Restrictions:

• Rational Software Architect or Rational Software Modeler cannot be open when you install this feature.
• On Windows^® operating systems, you must use an account with Administrator privileges.

To install the feature, complete the following steps:

1. Start the Rational Product Updater by clicking Start > Programs > IBM Rational > Rational Product Updater.
   
2. Click Preferences > Update Sites.
3. Navigate to temp_dir/rsa/policy_soda_6001.xml, where temp_dir is the location of the extracted feature.
4. Click OK.
5. Click Find Optional Features.
6. Select IBM Rational SoDA Integration.


Tip: To view the description for this feature, click the feature. The description is displayed in the Detailed information pane.


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, the Rational Product Updater lists the installed features on the Installed Products page.


9. Close the Rational Product Updater.

4.0 Configuring the Rational Product Updater to update the local feature

Update the feature with the same user account that installed Rational Software Architect or Rational Software Modeler.

Restrictions:

• Rational Software Architect or Rational Software Modeler cannot be open when you update this feature.
• On Windows operating systems, you must use an account with Administrator privileges.

To update the feature, complete the following steps:

1. Start the Rational Product Updater by clicking Start > Programs > IBM Rational > Rational Product Updater.
   
2. Click Preferences > Update Sites.
3. Navigate to temp_dir/rsa/policy_soda_6001.xml, where temp_dir is the location of the extracted feature.
4. Click OK.
5. Click Find Updates.
6. By default, all available updates are selected. Ensure that you select IBM Rational SoDA Integration.


Tip: To view the description for this feature, click the feature. The description is displayed in the Detailed information pane.


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 feature might take an extended period of time to download and install.

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


9. Close the Rational Product Updater.

5.0 Creating a local mirror of the update server

You might want to create a local mirror of the Rational Software Architect update server or the Rational Software Modeler update server in the following situations:

• You administer a set of product installations that do not have direct access to the Internet.
• You administer a set of product installations that would benefit from a local mirror of the update server.

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

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

6.0 Uninstalling the feature

Uninstall the feature with the same user account that installed Rational Software Architect or Rational Software Modeler.

Restrictions:

• Rational Software Architect or Rational Software Modeler cannot be open when you uninstall this feature.
• On Windows operating systems, you must use an account with Administrator privileges.

To uninstall the feature, complete the following steps:

1. Start the Rational Product Updater by clicking Start > Programs > IBM Rational > Rational Product Updater.
   
   
2. Click the Rollbacks tab.


The Rollbacks page shows an inventory of updates and optional features that are currently installed for Rational Software Architect or Rational Software Modeler.


3. Select IBM Rational SoDA Integration.


Dependencies between updates are automatically enforced. If you select to roll back an update that is required by other installed updates, the updates that depend on the update are also selected to be rolled back.


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