IBM Informix 4GL to EGL Conversion Utility feature for IBM Rational
Application Developer Version 6.0 - local installation instructions
© Copyright IBM Corporation 2000, 2005. All Rights Reserved.
Contents
1.0 Overview
2.0 Installing the feature
2.1 Installation prerequisites
2.2 Creating policy.xml
2.3 Configuring the Rational Product Updater
to install the local feature
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 feature from the local
mirror of the update server
4.0 Trademarks
1.0 Overview
This document describes how to install a downloaded version of the IBM®
Informix® 4GL to EGL Conversion Utility feature for IBM Rational®
Application Developer Version 6.0, and how to create a local mirror of the
Rational Software Development Platform update server.
2.0 Installing the feature
2.1 Installation prerequisites
- Before you can install this feature you must install Rational
Application Developer Fix Pack 6.0.0.1.
(Note: For existing customers you may see both 6.0.0.1
and 6 .0.0.1a, select 6.0.01a only)
Installation
instructions for Rational Application Developer Fix Pack 6.0.0.1 are available
at www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/60/install_instruction/6001/install.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 feature.
2.2 Creating policy.xml
To create the policy.xml file, complete the following steps:
1.
Navigate to <temp_dir>\rad\,
where <temp_dir> is the
location of the extracted feature.
2.
Open policy_i4gl.xml
in a text editor.
3.
Edit the file to point to where
you extracted the feature. For example, if you extracted the feature to C:\temp,
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.application.developer.discovery"
url="file:///C:/temp/rad/60/discovery/site_i4gl.xml"/>
</update-policy>
Note: On Linux™ operating systems, if you extracted the feature 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.application.developer.discovery"
url="file:///root/rad/60/discovery/site_i4gl.xml"/>
</update-policy>
4.
Save the updated file as policy.xml. Keep the original policy_i4gl.xml
file as a reference.
5.
Close your text editor.
2.3 Configuring the Rational Product Updater to install the
local feature
Install the
feature with the same user account that installed IBM Rational Application
Developer.
Restrictions:
·
On Windows® operating
systems, you must use an account with Administrator privileges. On Linux
operating systems, you must use the root user account.
·
Rational Application Developer
cannot be open when you install this feature.
To install the
feature, complete the following steps:
1.
Start the Rational Product
Updater:
o
On Windows operating systems,
click Start > Programs > IBM Rational > Rational Product Updater.
o
On Red Hat Enterprise Linux 3.0, open the main menu and
click Programming > Rational Product Updater.
o
On SuSE
Linux Enterprise
Server 9.0 (GNOME desktop environment), open the main menu and click
Applications > Programming > Rational Product Updater.
o
On SuSE
Linux Enterprise
Server 9.0 (K Desktop Environment), open the main menu and click IBM Rational
> Rational Product Updater.
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 Optional Features.
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 6.0.0.4.
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 Informix 4GL to EGL
Conversion Utility.
Tip: To view the description for this update, click the update. The description
is displayed in the Detailed information pane.
7.
Click Install 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 feature might take an extended period of time to install.
After the installation is complete, the Rational Product Updater lists the
installed features 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:
·
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 Rational Software
Development Platform update server.
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:
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 6.0.0.4.
·
You must remove outdated feature
files from your local mirror of the Rational Software Development Platform
update server.
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 a site_<identifier>.xml
file in a text editor. For example, open site_i4gl.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_i4gl.xml into the <site></site> section of site.xml.
3.
Copy the <feature/> information from each site_<identifier>.xml
file into site.xml.
Note:
o
Replace outdated
feature information in the <product>\60\discovery\site.xml
file with the latest feature information available.
o
Do not replace the previous
feature information in the <product>\60\update\site.xml
file with the latest interim fix information available.
o
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.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. For example, open policy_i4gl.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.rational.application.developer.discovery"
url="http://server1/rational_updates/rad/60/discovery/site.xml/">
</update-policy>
4.
Your policy.xml
file should have one URL map for the update site and another URL map for the
discovery site. If your policy.xml file
does not have a url map for
both the update site and the discovery site, duplicate the URL map and edit the
copied URL map to point to either the update site or the discovery
site. The result would look similar to the following example:
<?xml version="1.0" encoding="UTF-8" ?>
<update-policy>
<url-map
pattern="com.ibm.rational.application.developer.update"
url="http://server1/rational_updates/rad/60/update/site.xml/">
<url-map
pattern="com.ibm.rational.application.developer.discovery"
url="http://server1/rational_updates/rad/60/discovery/site.xml/">
</update-policy>
5.
Add the URL map information from
all other <product>\policy_<identifier>.xml
files.
For each product that can be updated from your local mirror of the Rational
Software Development Platform 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.
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.
<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 feature 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 feature by using the following
instructions.
Install the
feature with the same user account that installed IBM Rational Application
Developer.
Restrictions:
·
On Windows operating systems, you
must use an account with Administrator privileges. On Linux operating systems,
you must use the root user account.
·
Rational Application Developer
cannot be open when you install this feature.
To install the
feature, complete the following steps:
1.
Start the Rational Product
Updater:
o
On Windows operating systems,
click Start > Programs > IBM Rational > Rational Product Updater.
o
On Red Hat Enterprise Linux 3.0, open the main menu and
click Programming > Rational Product Updater.
o
On SuSE
Linux Enterprise
Server 9.0 (GNOME desktop environment), open the main menu and click
Applications > Programming > Rational Product Updater.
o
On SuSE
Linux Enterprise
Server 9.0 (K Desktop Environment), open the main menu and click IBM Rational
> Rational Product Updater.
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.
If the Rational Product Updater requires an update, you are prompted to install
that update before continuing. Click OK to continue.
6.
Select Informix 4GL to EGL
Conversion Utility.
Tip: To view the description for this feature, click the feature. The
description is displayed in the Detailed information
pane.
7.
Click 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.
4.0 Trademarks
IBM, Informix, and Rational are trademarks of International Business
Machines Corporation in the United
States, other countries, or both.
Windows is a trademark of Microsoft Corporation in the United States,
other countries, or both.
Linux is a trademark of Linus Torvalds
in the United States,
other countries, or both.
Other company, product, or service names may be trademarks or service marks
of others.