Creating a local mirror of the IBM Rational Performance Tester update server

For Rational Performance Tester, Version 6.1

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

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

1.0 Downloading and extracting updates

To create a local mirror of the IBM Rational Performance Tester update server, download the updates in the following table:
Rational Performance Tester update FTP location
IBM Rational Product Updater 6.0.0.4 ftp://ftp.software.ibm.com/software/rationalsdp/updater/60/zips/rpu_6004.zip
IBM Rational Performance Tester 6.1 IFix000a ftp://ftp.software.ibm.com/software/rationalsdp/rpt/61/zips/rpt61_ifix000a.zip
IBM Rational Performance Tester 6.1 IFix001 ftp://ftp.software.ibm.com/software/rationalsdp/rpt/61/zips/rpt61_ifix001.zip
IBM Rational Performance Tester 6.1 IFeature001 ftp://ftp.software.ibm.com/software/rationalsdp/rpt/61/zips/rpt61_siebel_ifeature001.zip

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

Attention:

Note: 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 and fix packs, and the discovery site contains optional features.

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

Each downloaded product fix contains a site_identifier.xml file in the product\61\update\ directory, and each downloaded feature contains a site_identifier.xml file in the product\61\discovery\ directory, where identifier identifies the product fix or feature and product identifies the product. Rational Performance Tester does not use the _identifier suffix. The site.xml files are located in the rpt\61\update\ and rpt\61\discovery directories. The site_identifier.xml files for updates to the Rational Product Updater are located in the rpu\61\update\ directory.

Generally, the update site and the discovery site each require a separate site.xml file. However, because Rational Performance Tester already has site.xml files, it does not require this editing unless there are additional updates.

To update a site.xml file, copy the <feature/> information from each site_identifier.xml into the <site></site> section of site.xml.

Your rpt\61\dicovery\site.xml will look similar to the following:

<?xml version="1.0" encoding="UTF-8" ?>
<site>
   <feature
      id="com.ibm.rational.performance.tester" version="6.1.0"
      url="features/com.ibm.rational.performance.tester_610.jar">
   </feature>
   <feature
      id="updater.rpt.siebel.plugins.610.ifeature001" version="1.0.0"
      url="features/updater.rpt.siebel.plugins.610.ifeature001_1.0.0.jar">
      <category name="proxies">
   </feature>
   <feature
      id="updater.rpt.siebel.dlls.610.ifeature001" version="1.0.0"
      url="features/updater.rpt.siebel.dll_dir.610.ifeature001_1.0.0.jar">
      <category name="proxies">
   </feature>
</site>

Your rpt\61\update\site.xml will look similar to the following:

<?xml version="1.0" encoding="UTF-8" ?>
<site>
   <feature patch="true"
      id="com.ibm.rational.performance.tester.610.if001" version="1.0.0"
      url="features/com.ibm.rational.performance.tester.610.if001_1.0.0.jar"/>
   <feature
      id="updater.rpt.common.plugins.610.if00" version="1.0.0"
      url="features/updater.rpt.common.plugins.610.if001_1.0.0.jar"/>
   <feature
      id="updater.rpt.common.wb.plugins.610.if001" version="1.0.0"
      url="features/updater.rpt.common.wb.plugins.610.if001_1.0.0.jar"/>
   <feature
      id="updater.rpt.common.nl.plugins.610.if001" version="1.0.0"
      url="features/updater.rpt.common.nl.plugins.610.if001_1.0.0.jar"/>
   <feature
      id="updater.rpt.common.doc.plugins.610.if001" version="1.0.0"
      url="features/updater.rpt.common.doc.plugins.610.if001_1.0.0.jar"/>
</site>

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. Rational Performance Tester does not use the _identifier suffix. Consequently, the policy.xml can be used for all product updates and reference the site.xml file that you created in the previous section.

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

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


    2. <?xml version="1.0" encoding="UTF-8" ?>
    <update-policy>
       <url-map pattern="com.ibm.rational.performance.tester.update" url="http://server1/rational_updates/rpt/61/update/site.xml/">
       <url-map pattern="com.ibm.rational.performance.tester.discovery" url="http://server1/rational_updates/rpt/61/discovery/site.xml/">
    </update-policy>

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


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

  3. Edit each URL map to point to site.xml instead of site_identifier.xml. Your file will be similar to the following example:


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

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


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

  5. Save the policy.xml file.

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 Rational Performance Tester.

Restrictions:

To install an update, complete the following steps:

  1. Start the 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.

  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 update server.
  4. Click OK.
  5. Click Find Updates or Find Optional Features.


    6. 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 the update that you want to install.


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

  7. Click Install Updates or Install Optional Features.
  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.