IBM Rational Data Architect Fix Pack 6.1.0.1 - Local installation instructions
For Rational Data Architect, Version 6.1
Contents
1.0 Overview
2.0 Installation prerequisites
3.0 Configuring the Rational Product Updater to install the local fix pack
4.0 Creating a local mirror of the update server
1.0 Overview
This document describes how to install a downloaded version of IBM(R) Rational(R) Data Architect Fix Pack 6.1.0.1. This document also links to instructions
that describe how to create a local mirror of your product update server.
2.0 Installation prerequisites
Before you can install this fix pack, you must install IBM Rational Product
Updater 6.0.1, available at ftp://ftp.software.ibm.com/software/rationalsdp/updater/60/zips/rpu_601.zip.
Installation instructions for the IBM Rational Product Updater 6.0.1 are
available at http://www3.software.ibm.com/ibmdl/pub/software/rationalsdp/updater/60/zips/install_601.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 fix pack.
3.0 Configuring the Rational Product Updater to install the local fix pack
Install the fix pack with the same user account that installed IBM Rational
Data Architect.
Restrictions:
- Rational Data Architect cannot be open when you install this fix pack.
- 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 the fix pack, complete the following steps:
- 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.
- Click Preferences > Update Sites.
- Navigate to temp_dir\rdafp1\policy_61_6101.xml, where temp_dir is the location of the extracted fix pack.
- Click OK.
- Click Find Updates.
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 IBM Rational Product Updater 6.0.1.
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.
- Select IBM Rational Data Architect 6.1.0.1.
Tip: To view the description for this update, click the update. The description is displayed in the Detailed information pane.
- Click Install Updates.
- 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.
- Close the Rational Product Updater.
- If you are planning to use the data model import and export feature, you
must manually set the path to this feature in your environment variables.
For example, on Windows systems:
- Click Start > Control Panel.
- Open System.
- On the Advanced tab, click Environment Variables.
- Under System variables, select PATH and click Edit.
- Add the following path value, separated by a semicolon (;):
<RDA_install_dir>\rda_prod\eclipse\plugins\com.ibm.datatools.metadata.wizards.miti.win32_1.0.0\MetaIntegration\bin
where <RDA_install_dir> is the directory in which you installed Rational Data Architect.
4.0 Creating a local mirror of the update server
You might want to create a local mirror of the Rational Data Architect
update server in the following situations:
- 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 update server.
4.1 Downloading and extracting updates
To create a local mirror of the IBM(R) Rational(R) Data Architect update server, download the updates in the following table:
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 download the IBM Rational Product Updater 6.0.1.
- 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.
4.2 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. 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:
- Open a site_identifier.xml file in a text editor. For example, open site_J2C.xml.
- 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_J2C.xml into the <site></site> section of site.xml.
- 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 fromrad\60\discovery\site_J2C.xml and
rad\60\discovery\site_i4gl.xml into rad\60\discovery\site.xml:
<?xml version="1.0" encoding="UTF-8" ?>
<site>
<!-- J2C feature-->
<feature patch="true" id="com.ibm.j2c.win32" version="1.0.0" os="win32" url="features/com.ibm.j2c.win32_1.0.0.jar">
<category name="fixpack" />
</feature>
<feature patch="true" id="com.ibm.j2c.linux" version="1.0.0" os="linux" url="features/com.ibm.j2c.linux_1.0.0.jar">
<category name="fixpack" />
</feature>
<feature patch="false" id="updater.rad.ifeature.001" version="1.0.0" url="features/updater.rad.ifeature.001_1.0.0.jar">
<category name="proxies" />
</feature>
<feature patch="false" id="updater.rad.ifeature.001.nl1" version="1.0.0" url="features/updater.rad.ifeature.001.nl1_1.0.0.jar">
<category name="proxies" />
</feature>
<feature patch="false" id="updater.rad.ifeature.RAR" version="1.0.0" url="features/updater.rad.ifeature.RAR_1.0.0.jar">
<category name="proxies" />
</feature>
<!--I4GL conversion utility-->
<feature patch="false" id="com.ibm.etools.i4gl.conversion.win32" version="6.0.0" url="features/com.ibm.etools.i4gl.conversion.win32_6.0.0.jar" os="win32">
</feature>
<feature patch="false" id="com.ibm.etools.i4gl.conversion.linux" version="6.0.0" url="features/com.ibm.etools.i4gl.conversion.linux_6.0.0.jar" os="linux">
</feature>
<feature patch="false" id="updater.rad.ifeature.i4glconversion.001" version="1.0.0" url="features/updater.rad.ifeature.i4glconversion.001_1.0.0.jar">
</feature>
<feature patch="false" id="updater.zips.i4glconversion.win32.001" version="1.0.0" url="features/updater.zips.i4glconversion.win32.001_1.0.0.jar">
</feature>
<feature patch="false" id="updater.zips.i4glconversion.linux.001" version="1.0.0" url="features/updater.zips.i4glconversion.linux.001_1.0.0.jar">
</feature>
</site>
Note:
- Replace outdated feature information in the product\61\discovery\site.xml file with the latest feature information that is available.
- Do not replace the previous feature information in the product\61\update\site.xml file with the latest product fix information that is available.
- The order of the feature information is not significant.
- Save and close the updated site.xml file. Keep the original site_identifier.xml files for reference.
- Close your text editor.
4.3 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:
- Open a product\policy_identifier.xml file with a text editor. For example, open policy_6101.xml.
- In the main directory of your mirror site, save the file as policy.xml.
- 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.data.architect.update"
url="http://server1/rational_updates/rda/61/update/site.xml/">
</update-policy>
- Add the URL map information from all other product\policy_identifier.xml files, such as rda\policy_J2C.xml.
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.
- 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.data.architect.update" url="http://server1/rational_updates/rda/61/update/site.xml/">
<url-map pattern="com.ibm.rational.data.architect.discovery" url="http://server1/rational_updates/rda/61/discovery/site.xml/">
</update-policy>
- 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"/>
- Save the policy.xml file.
- Close your text editor.
4.4 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 Data
Architect.
Restrictions:
- Rational Data Architect cannot be open when you install an update.
- On Windows(R) operating systems, you must use an account with Administrator privileges. On Linux(R) operating systems, you must use the root user account.
To install an update, complete the following steps:
- 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.
- Click Preferences > Update Sites.
- Type the path to the policy.xml file that is in the main directory of the local mirror of the update server.
- Click OK.
- Click Find Updates or Find Optional Features.
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.
- Select the update that you want to install.
Tip: To view the description for an update, click the update. The description is displayed in the Detailed information pane.
- Click Install Updates or Install Optional Features.
- 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.
- Close the Rational Product Updater.