IBM Rational Software Modeler Version 6.0 Interim Fix 002 - Local installation instructions

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

Contents

1.0 Overview
2.0 Installing the interim fix
   2.1 Installation prerequisites
   2.2 Creating policy.xml
   2.3 Configuring the Rational Product Updater to install the local interim fix
3.0 Creating 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
   3.2 Creating and updating site.xml files for the local mirror of the update server
   3.3 Creating policy.xml for the local mirror of the update server
   3.4 Installing the interim fix from the local mirror of the update server

1.0 Overview

This document describes how to install a downloaded version of IBM® Rational® Software Modeler Interim Fix 002, and how to create a local mirror of the Rational Software Development Platform update server.

2.0 Installing the interim fix

2.1 Installation prerequisites

Before you can install this interim fix, you must install the IBM Rational Product Updater Interim Fix 002. You can download the interim fix from ftp://ftp.software.ibm.com/software/rationalsdp/updater/60/zips/rpu_ifix0002.zip.

Installation instructions for the IBM Rational Product Updater Interim Fix 002 are available at http://www3.software.ibm.com/ibmdl/pub/software/rationalsdp/updater/60/zips/install_ifix0002.html.

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

2.2 Creating policy.xml

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

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


    4. <?xml version="1.0" encoding="UTF-8"?>
    <update-policy>
    <url-map pattern="com.ibm.rational.software.modeler.update" url="file:///C:/temp/rsm/60/update/site_002.xml"/>
    </update-policy>

    Note: On Linux™ operating systems, if you extracted the interim fix to the root directory, 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.modeler.update" url="file:///root/rsm/60/update/site_002.xml"/>
    </update-policy>

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

2.3 Configuring the Rational Product Updater to install the local interim fix

Install the interim fix with the same user account that installed IBM Rational Software Modeler.

Restriction: On Windows® operating systems, this account requires Administrator privileges. On Linux operating systems, you must use the root user account.

To install the interim fix, complete the following steps:

  1. Start the Rational Product Updater.


    2. Attention: If you start the Rational Product Updater from the product main menu (by clicking Help > Software Updates > IBM Rational Product Updater), you must close IBM Rational Software Modeler. IBM Rational Software Modeler cannot be open when you install this interim fix.

  2. Click Preferences > Update Sites.
  3. Type the path to the updated policy.xml file that you created in the previous section.
  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 the Rational Product Updater that states that other update sites are not available. You can ignore this warning if you installed the IBM Rational Product Updater Interim Fix 002.

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

  6. Select Interim Fix 002 - IBM Rational Software Modeler.


    7. Tip: To view the description for this update, click the update. 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.


    9. 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 is true:

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 table:
Update FTP location
Interim Fix 002 - IBM Rational Product Updater ftp://ftp.software.ibm.com/software/rationalsdp/updater/60/zips/rpu_ifix0002.zip
Interim Fix 002 - IBM Rational Software Modeler ftp://ftp.software.ibm.com/software/rationalsdp/rsm/60/zips/rsm60_interim_fix002.zip
IBM Rational Rose® Model Import ftp://ftp.software.ibm.com/software/rationalsdp/rsm/60/zips/rsm60_rose_mi_ifeature001.zip
IBM WebSphere® Business Integration Modeler Integration ftp://ftp.software.ibm.com/software/rationalsdp/rsm/60/zips/rsm60_wbi_import_ifeature001.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 Interim Fix 002.

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 each site_<identifier>.xml file in a text editor.
  2. Copy the <feature/> information from each file into a new file named site.xml in the same directory. If the directory already contains a file named site.xml, copy the <feature/> information into the <site></site> section of that file.


    3. For example, the following code displays the result of copying the <feature/> information from rsm\60\discovery\site_rmi.xml and rsm\60\discovery\site_wbi.xml into rsm\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.0" url="features/com.ibm.rational.wbi_6.0.0.0.jar"/>
       <feature id="new.wbi.600" version="1.0.0" url="features/new.wbi.600_1.0.0.jar"/>
    </site>

    Note: The order of the feature information is not significant.

  3. Save and close the updated site.xml file. Keep the original site_<identifier>.xml files for reference.
  4. 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 site_<identifier>.xml. 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.
  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:


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

  4. Duplicate the URL map and edit the copy to point to the discovery site:


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

  5. For each product that can be updated from your local mirror of the Rational Software Development Platform update server, create two URL maps (one for the update site and the other for the discovery site). The patterns are provided in each <product>\policy_<identifier>.xml file.
  6. Create a URL map for the updates to the Rational Product Updater by typing a publicly accessible absolute path to its site.xml file.


    7. <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 interim fix 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 interim fix by using the following instructions.

Install the interim fix with the same user account that installed IBM Rational Software Modeler.

Restriction: On Windows operating systems, this account requires Administrator privileges. On Linux operating systems, you must use the root user account.

To install the interim fix, complete the following steps:

  1. Start the Rational Product Updater.


    2. Attention: If you start the Rational Product Updater from the product main menu (by clicking Help > Software Updates > IBM Rational Product Updater), you must close IBM Rational Software Modeler. IBM Rational Software Modeler cannot be open when you install this interim fix.

  2. Click Preferences > Update Sites.
  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 Updates.


    6. If the Rational Product Updater requires an update, you are prompted to install that update before continuing. Click OK to continue.

  6. Select Interim Fix 002 - IBM Rational Software Modeler.


    7. Tip: To view the description for this update, click the update. 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.


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