Creating a local mirror of the IBM Rational Product Updater update server

This file is available in the following national languages:

Brazilian Portuguese	Chinese - Simplified	Chinese - Traditional
French	German	Italian
Japanese	Korean	Spanish

Contents

1.0 Downloading and extracting updates

To create a local mirror of the IBM^® Rational^® Product Updater update server, download Rational Product Updater 6.0.0.4 from ftp://ftp.software.ibm.com/software/rationalsdp/updater/60/zips/rpu_6004.zip.

You may also download the updates available for your Rational software development platform products from IBM Software Support at www.ibm.com/software/support/.

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

Attention:

• You must remove outdated feature files from your local mirror of the update server.

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

Note: These instructions assume your update site will include updates for a Rational software development product in addition to the updates for the Rational Product Updater. If your mirror site will only contain updated for the Rational Product Updater, you should skip this section as there will be no need to edit the site_6004.xml file.

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\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 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_6004.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_6004.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_6001.xml and rsa\60\discovery\site_wbi_6001.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" version="6.0.0.1" url="features/com.ibm.rational.rose.model.import.rsa_6.0.0.1.jar"/>
   <feature id="proxy.rose.model.import.rsa.6001" version="1.0.0" url="features/proxy.rose.model.import.rsa.6001_1.0.0.jar"/>
   <feature id="proxy.rose.model.import.win32.rsa.6001" version="1.0.0" url="features/proxy.rose.model.import.win32.rsa.6001_1.0.0.jar"/>

   <!-- WBI -->
   <feature id="com.ibm.rational.wbi.rsa" version="6.0.0.1" url="features/com.ibm.rational.wbi.rsa_6.0.0.1.jar"/>
   <feature id="proxy.wbi.rsa.6001" version="1.0.0" url="features/proxy.wbi.rsa.6001_1.0.0.jar"/>
</site>

Note:
• Replace outdated feature information in the product\60\discovery\site.xml file with the latest feature information that is available.
• Do not replace the previous feature information in the product\60\update\site.xml file with the latest product fix information that is 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.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_6004.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.orca.product.updater" url="http://server1/rational_updates/rpu/60/update/site.xml/">
</update-policy>


Note: If your mirror site will only contain updated for the Rational Product Updater and you did not edit or create a new site.xml file in the previous section, then leave the URL map pointing to site_6004.xml instead of site.xml and skip to step 6 below.



4. Add the URL map information from all other product\policy_identifier.xml files.


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.


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" ?>
   <url-map pattern="com.ibm.orca.product.updater" url="http://server1/rational_updates/rpu/60/update/site.xml/">
   <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. Save the policy.xml file.
7. 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 IBM Rational software development platform product.

Restrictions:

• The Rational Software Development Platform cannot be open when you install an update.
• On Windows^® operating systems, you must use an account with Administrator privileges. On Linux^® operating systems, you must use the root user account.

To install an update, complete the following steps:

1. Start the Rational Product Updater:
   • On Windows operating systems, click Start > Programs > IBM Rational > Rational Product Updater.
   • On Red Hat Enterprise Linux 3.0 (GNOME desktop environment), open the main menu and click Programming > Rational Product Updater.
   • On SuSE Linux Enterprise Server 9.0 (K Desktop Environment), open the main menu and click IBM Rational > Rational Product Updater.

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.


You are prompted to install and update to the Rational Product Updater before continuing. Click OK to continue. The Rational Product Updater installs the update and restarts.


6. If you downloaded updates for additional products, select updates to install from the list that is displayed.


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.


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.