Creating a local mirror of the IBM Rational Software Architect update server

For Rational Software Architect Fix Pack 6.0.1.2

© Copyright International Business Machines Corporation 2004, 2008. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

This file is available in the English language only.

Contents

1.0 Downloading and extracting updates
2.0 Creating and updating site.xml files
3.0 Creating a policy.xml file
4.0 Installing updates from the local mirror of the update server
5.0 IBM Rational Software Support
6.0 Trademarks and service marks

1.0 Downloading and extracting updates

To create a local mirror of the IBM® Rational® Software Architect update server, download the following updates. If you previously created a local mirror of the update server, remove any outdated feature files before downloading these updates.

Update FTP location Note
IBM Rational Product Updater, Version 6.0.2 ftp://ftp.software.ibm.com/software/rationalsdp/updater/60/zips/rpu_602.zip -
IBM Rational Software Architect Fix pack 6.0.1.2 (Part 1) ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa60_6011_for_6012.zip The compressed file contains Fix Pack 6.0.1.1.
 IBM Rational Software Architect Fix Pack 6.0.1.2 (Part 2) ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa_pre6012.zip The compressed file contains the following updates to Fix Pack 6.0.1.1:
  • Daylight Saving Time Update
  • Interim Fix 001
  • Interim Fix 002
  • Interim Fix 003a
  • Interim Fix 004
IBM Rational Software Architect Fix Pack 6.0.1.2 (Part 3) ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa60_6012.zip This compressed file contains the updates since Interim Fix 004 for Fix Pack 6.0.1.1.
Interim Fix 001 for Rational Software Architect 6.0.1.2 ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa6012_interim_fix001.zip -
IBM 32-bit Runtime Environment for Java 2, v1.4.2 SR9 update ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa6012_JRE_Update.zip -
IBM Rational Rose® Model Import 6.0.1.6 ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa6012_RMI6016.zip -
IBM Rational XDE Model Import 6.0.1.7 ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa6012_XMI6017.zip -
J2EE Connector Tools, Version 6.0.1.5 ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa601_J2C6015.zip -
Rational DoDAF modeling 6.0.1.1.0.3 ftp://ftp.software.ibm.com/software/rationalsdp/rsa/60/zips/rsa6012_DODAF601103.zip -

Attention: You must download IBM Rational Product Updater 6.0.1.

After you download the updates, extract the compressed files to a target directory that will stage your local mirror of the update server. You can extract all the updates to the same target directory. The updates do not overwrite each other.

2.0 Creating and updating site.xml files

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

Note: Rational Product Updater does not have a discovery site.

Each downloaded product 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 product fix or feature and product identifies the product. The site_identifier.xml files for updates to 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_6011_RMI6013.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_6011_RMI6013.xml into the <site></site> section of site.xml.
  3. Copy the <feature/> information from each site_identifier.xml file into site.xml.

  4. For example, the following code displays the result of copying the <feature/> information from rsa\60\discovery\site_6011_RMI6013.xml and rsa\60\discovery\site_6011_XDE6013.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.rsa" patch="false" url="features/com.ibm.rational.rose.model.import.rsa_6.0.1.3.jar" version="6.0.1.3">
          <category name="refreshpack"/>
       </feature>
       <feature id="updater.rmi.nl1.plugins.6011" patch="false" url="features/updater.rmi.nl1.plugins.6011_1.0.0.jar" version="1.0.0">
          <category name="proxies"/>
       </feature>
       <feature id="updater.rmi.plugins.6011" patch="false" url="features/updater.rmi.plugins.6011_1.0.0.jar" version="1.0.0">
          <category name="proxies"/>
       </feature>
       <feature id="updater.rmi.win32.plugins.6011" patch="false" url="features/updater.rmi.win32.plugins.6011_1.0.0.jar" version="1.0.0">
          <category name="proxies"/>
       </feature>

       <!-- XDE Model Import -->
       <feature id="com.ibm.rational.rsa.xde.model.import" patch="false" url="features/com.ibm.rational.rsa.xde.model.import_6.0.1.3.jar" version="6.0.1.3">
          <category name="refreshpack"/>
       </feature>
       <feature id="updater.xde.nl1.plugins.6011" patch="false" url="features/updater.xde.nl1.plugins.6011_1.0.0.jar" version="1.0.0">
          <category name="proxies"/>
       </feature>
       <feature id="updater.xde.plugins.6011" patch="false" url="features/updater.xde.plugins.6011_1.0.0.jar" version="1.0.0">
          <category name="proxies"/>
       </feature>
       <feature id="updater.xde.win32.plugins.6011" patch="false" url="features/updater.xde.win32.plugins.6011_1.0.0.jar" version="1.0.0">
          <category name="proxies"/>
       </feature>

       <!-- Category Definition -->
       <category-def label="Fix Packs" name="fixpack">
          <description>Fix Packs</description>
       </category-def>
       <category-def label="Interim Fixes" name="interimfix">
          <description>Interim Fixes</description>
       </category-def>
       <category-def label="Proxy Features" name="proxies">
          <description>Proxy Features</description>
       </category-def>
    </site>


    Note:
  5. Save and close the updated site.xml file. Keep the original site_identifier.xml files for reference.
  6. Close your text editor.

3.0 Creating a policy.xml file

Each downloaded product 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_60_6012.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:


  4. <?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>


  5. Add the URL map information from all other product\policy_identifier.xml files, such as rsa\policy_6011_XDE6013.xml.

  6. For each product that you can update from your local mirror of the 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.
  7. Edit each URL map to point to site.xml instead of site_identifier.xml. Your file will be similar to the following example:


  8. <?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.rsa.xde.model.import" url="http://server1/rational_updates/rsa/60/discovery/site.xml"/>
    </update-policy>


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


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

  11. Save the policy.xml file.
  12. Close your text editor.

4.0 Installing updates from the local mirror of the update server

After the local mirror of the update server is available, users can install updates by completing the following instructions.

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

Restrictions:

To install an update, complete the following steps:

  1. Start Rational Product Updater:

  2. 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.
  3. Click Preferences > Update Sites.
  4. Type the path to the policy.xml file that is in the main directory of the local mirror of the update server.
  5. Click OK.
  6. Click Find Updates or Find Optional Features.

  7. 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.
  8. Select the update that you want to install.
  9. Click Install Updates or Install Optional Features.
  10. To accept the license agreement and continue the installation, click OK.

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

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

  1. Start IBM Rational Product Updater and complete one of the following steps:
  2. Click the Installed Products tab.

For contact information and guidelines or reference materials that you will need when you require support, read the IBM Software Support Handbook at: http://techsupport.services.ibm.com/guides/handbook.html

For FAQs, lists of known problems and fixes, and other support information, visit the product support page for Rational Software Architect at www.ibm.com/software/awdtools/architect/swarchitect/support/index.html.

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

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:

6.0 Trademarks and service marks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds 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.