IBM Rational SoDA Integration Feature - Local installation instructions

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

© Copyright IBM Corporation 2005. All Rights Reserved.

Contents

1.0 Overview

This document describes how to install a downloaded version of the IBM^® Rational SoDA^® Integration feature, and how to create a local mirror of the Rational^® Software Development Platform update server.

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

2.0 Installing the feature

2.1 Installation prerequisites

Before you can install this feature you must install either Rational Software Architect Interim Fix 003 or Rational Software Modeler Interim Fix 003.

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

Installation instructions for Rational Software Modeler Interim Fix 003 are available at www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rsm/60/install_instruction/interim_fix003/install.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.

2.2 Creating policy.xml

To create the policy.xml file, complete the following steps:

1. Navigate to <temp_dir>\rsa\, where <temp_dir> is the location of the extracted feature.
2. Open policy_soda.xml in a text editor.
3. Edit the file to point to where you extracted the feature. For example, if you extracted the feature to C:\temp, your modified file will be similar to the following example:


<?xml version="1.0" encoding="UTF-8"?>
<update-policy>
<url-map pattern="com.ibm.rational.software.architect.discovery" url="file:///C:/temp/rsa/60/discovery/site_soda.xml"/>
</update-policy>


4. Save the updated file as policy.xml. Keep the original policy_soda.xml file as a reference.
5. Close your text editor.

2.3 Configuring the Rational Product Updater to install the local feature

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

Restrictions:

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

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 Site.
3. Type the path to the updated policy.xml file that you created in the previous section.
4. Click OK.
5. Click Find Optional Features.
6. Select IBM Rational SoDA Integration.


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


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

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


9. Close the Rational Product Updater.

3.0 Creating a local mirror of the Rational Software Development Platform update server

You should create a local mirror of the Rational Software Development Platform update server if either of the following conditions are true:

• 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 Rational Software Development Platform update server.

3.1 Downloading and extracting the files for the local mirror of the update server

To create a local mirror of the Rational Software Development Platform update server, download the updates in the following tables:

Rational Software Architect update	FTP location
IBM Rational Product Updater 6.0.0.3	ftp://ftp.software.ibm.com/software/rationalsdp/updater/60/zips/rpu_6003.zip
Interim Fix 001 - IBM Rational Software Architect	ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa60_interim_fix001.zip
Interim Fix 002 - IBM Rational Software Architect	ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa60_interim_fix002.zip
Interim Fix 003 - IBM Rational Software Architect	ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa60_interim_fix003.zip
IBM Rational Rose® Model Import	ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa60_rose_mi_ifeature001.zip
IBM Rational SoDA® Integration	ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa60_soda_ifeature001.zip
IBM WebSphere® Business Integration Modeler Integration	ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa60_wbi_import_ifeature002.zip

After you download the updates, extract the files to a target directory that will stage your local mirror of the Rational Software Development Platform update server.

Attention:

• You must download the IBM Rational Product Updater 6.0.0.3.
• You must remove outdated feature files from your local mirror of the Rational Software Development Platform update server.

Note: You can extract all the updates to the same target directory. The updates do not overwrite each other.

3.2 Creating and updating site.xml files for the local mirror of the update server

Generally, an update site and a discovery site exist for each product. The update site contains interim fixes and the discovery site contains optional features.

Note: There is no discovery site for updates to the Rational Product Updater.

Each downloaded interim fix contains a site_<identifier>.xml file in the <product>\60\update\ directory, and each downloaded feature contains a site_<identifier>.xml file in the <product>\60\discovery\ directory, where <identifier> identifies the interim fix or feature and <product> identifies the product. The site_<identifier>.xml files for updates to the Rational Product Updater are located in the rpu\60\update\ directory.

The update site and the discovery site each require a separate site.xml file. To create each site.xml file, you must combine the <feature/> information from the appropriate site_<identifier>.xml files.

To create or update a site.xml file, complete the following steps:

1. Open a site_<identifier>.xml file in a text editor. For example, open site_rmi.xml.
2. Save the file as site.xml in the same directory. If the directory already contains a file named site.xml, copy the <feature/> information from site_rmi.xml into the <site></site> section of site.xml.
3. Copy the <feature/> information from each site_<identifier>.xml file into site.xml.


For example, the following code displays the result of copying the <feature/> information from rsa\60\discovery\site_rmi.xml and rsa\60\discovery\site_wbi_002.xml into rsa\60\discovery\site.xml:

<?xml version="1.0" encoding="UTF-8" ?>
<site>
   <!-- Rose Model Import -->
   <feature id="com.ibm.rational.rose.model.import" version="6.0.0.0" url="features/com.ibm.rational.rose.model.import_6.0.0.0.jar"/>
   <feature id="new.rose.model.import.600" version="1.0.0" url="features/new.rose.model.import.600_1.0.0.jar"/>
   <feature id="new.rose.model.import.win32.600" version="1.0.0" url="features/new.rose.model.import.win32.600_1.0.0.jar"/>

   <!-- WBI -->
   <feature id="com.ibm.rational.wbi" version="6.0.0.003" url="features/com.ibm.rational.wbi_6.0.0.003.jar"/>
   <feature id="new.wbi.600003" version="1.0.0" url="features/new.wbi.600003_1.0.0.jar"/>
</site>

Note:
• Replace outdated feature information in the <product>\60\discovery\site.xml file with the latest feature information available.
• Do not replace the previous feature information in the <product>\60\update\site.xml file with the latest interim fix information available.
• The order of the feature information is not significant.




4. Save and close the updated site.xml file. Keep the original site_<identifier>.xml files for reference.
5. Close your text editor.

3.3 Creating policy.xml for the local mirror of the update server

Each downloaded interim fix and feature contains a <product>\policy_<identifier>.xml file that references its site_<identifier>.xml file. You must combine all of the policy_<identifier>.xml files into a single policy.xml file. After you create this file, you can use it for all product updates and reference the site.xml file that you created in the previous section.

To create the policy.xml file, complete the following steps:

1. Open a <product>\policy_<identifier>.xml file with a text editor. For example, open policy_003.xml.
2. In the main directory of your mirror site, save the file as policy.xml.
3. Edit the URL map to point to site.xml instead of site_<identifier>.xml. Ensure that you specify a universally accessible absolute path to site.xml. For example, if your mirror site is on a Web server named server1, your policy.xml file will be similar to the following example:


<?xml version="1.0" encoding="UTF-8" ?>
<update-policy>
   <url-map pattern="com.ibm.rational.software.architect.update" url="http://server1/rational_updates/rsa/60/update/site.xml/">
</update-policy>


4. Add the URL map information from all other <product>\policy_<identifier>.xml files, such as rsa/policy_wbi_002.xml.


For each product that can be updated from your local mirror of the Rational Software Development Platform update server, you should have one URL map for the update site and another URL map for the discovery site. Additional URL maps are required for feature discovery sites. The patterns are provided in each <product>\policy_<identifier>.xml file.


5. Edit each URL map to point to site.xml instead of site_<identifier>.xml. Your file will be similar to the following example:


<?xml version="1.0" encoding="UTF-8" ?>
<update-policy>
   <url-map pattern="com.ibm.rational.software.architect.update" url="http://server1/rational_updates/rsa/60/update/site.xml/">
   <url-map pattern="com.ibm.rational.software.architect.discovery" url="http://server1/rational_updates/rsa/60/discovery/site.xml/">
   <url-map pattern="com.ibm.rational.wbi.rsa" url="http://server1/rational_updates/rsa/60/discovery/site.xml/">
</update-policy>


6. Create a URL map for the updates to the Rational Product Updater by typing a universally accessible absolute path to its site.xml file.


<url-map pattern="com.ibm.orca.product.updater" url="http://server1/rational_updates/rpu/60/update/site.xml"/>


7. Save the policy.xml file.
8. Close your text editor.

3.4 Installing the feature from the local mirror of the update server

After the local mirror of the Rational Software Development Platform update server is available for use, users can install the feature by using the following instructions.

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

Restrictions:

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

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 Site.
3. Type the path to the policy.xml file that is in the main directory of the local mirror of the Rational Software Development Platform update server.
4. Click OK.
5. Click Find Optional Features.
6. Select IBM Rational SoDA Integration.


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


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

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


9. Close the Rational Product Updater.

4.0 Trademarks

IBM, Rational, Rational Rose, SoDA, and WebSphere are trademarks of International Business Machines Corporation in the United States, other countries, or both.

Windows is a trademark of Microsoft Corporation in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.