IBM Rational Web Developer for Windows and Linux, Version 6.0 Installation Guide
Chapter 1. Introduction
Chapter 2. Installation requirements for Rational Web Developer
Chapter 3. IBM Rational Software Development Platform
Chapter 4. Installing and uninstalling Rational Web Developer for Windows
Chapter 5. Installing and uninstalling Rational Web Developer for Linux
Chapter 6. Installing Agent Controller
Chapter 7. Setting up Rational Web Developer for working in a team environment
Chapter 8. Installing WebSphere Application Server 5.x as an integrated test environment
Chapter 9. Installing updates
Chapter 10. Copyright and notices
This installation guide provides instructions for installing and
uninstalling Rational(R) Web Developer, optional features, and additional
products provided with Rational Web Developer.
Refer to the Migration
Guide for information about migrating from WebSphere(R)
Studio.
Refer to the readme file for
information about product problems and limitations.
Refer to http://www.ibm.com/developerworks/rational
for updated documentation and troubleshooting information.
The following hardware must be installed before you install Rational Web
Developer:
- Intel(TM) Pentium(R) III 800 MHz processor minimum (Higher is
recommended).
- 768 MB RAM minimum (1 GB RAM is recommended)
- Disk space:
- To install the full Rational Web Developer, you will require 3.0 GB
of disk space. Additional disk space will be required for the resources
that you develop. Note: Disk space requirements can be reduced if
optional features and run-time environments are not installed.
- You will also require additional disk space if you download the electronic
image to install Rational Web Developer.
- If your file system is FAT32 instead of NTFS, more space will be required
- You will require 500 MB in the TEMP directory
- Display resolution:
The following software must be installed before you install Rational Web
Developer:
- One of the following operating systems:
- Windows(R) XP Professional with Service Packs 1 and 2
- Windows 2000 Professional with Service Packs 3 and 4
- Windows 2000 Server with Service Packs 3 and 4
- Windows 2000 Advanced Server with Service Packs 3 and 4
- Windows Server 2003 Standard Edition
- Windows Server 2003 Enterprise Edition
- Red Hat Enterprise Linux(TM) Workstation, Version 3.0 (all service
packs)
- SuSE Linux Enterprise Server (SLES) Version 9 (all service packs)
- The above listed Windows and Linux operating systems support all of the
national languages that Rational Web Developer supports.
- If you are working on Linux, you will need the GTK, Version
2.2.1 or later.
- You will need a Web browser to view the readme files and the installation
guide. If you are working on Linux, you must have Mozilla 1.4
GTK2 installed before you can run Rational Web Developer. Mozilla
1.5 GTK2 or Mozilla 1.6 GTK2 can also be used with SWT
3.0. In addition, Mozilla 1.7 GTK2 or above can be used
starting with SWT 3.1 v3104. The version of Mozilla installed on
your system varies with your Linux distribution.
- In order to view certain tours and tutorials that are included with the
online help you will require a Macromedia Flash Player. For Windows,
you will need Version 6.0r65 or later, and for Linux, Version
6.0r69 or later.
- For information about supported database servers, Web application servers,
and other software products, refer to the online help and the readme
files.
- If you want to profile your applications, ensure that Java(TM) Runtime
Environment (JRE) 1.3 or higher is installed.
The IBM(R) Rational Software Development Platform is a common
development environment that is shared by the following products:
- Rational Web Developer
- Rational Application Developer
- Rational Software Architect
- Rational Software Modeler
- Rational Functional Tester
- Rational Performance Tester
If you install any of these products, the Rational Software Development
Platform is automatically installed as part of the product. If you have
more than one of these products installed, the development platform is
installed only once. All of these products have the same user
interface, called a workbench, and each product adds functionality to the
workbench by contributing plug-ins. A plug-in is
a software module that adds function to an existing program or
application.
Launching Rational software products that are installed together on
Windows
When you open the Start menu, the top level menu, regardless of
which product you have installed, will always be IBM
Rational.
Depending on how many products you have installed, you will have one or
more subfolders (one for each product) available from the top level
menu. If, for example, you have both Rational Functional Tester and
Rational Application Developer installed, a subfolder will exist for each of
these. These subfolders will contain links to product specific
information (such as readme files), as well as a launchpoint for the user
interface. The launchpoint will have the name of the product (such as
Rational Application Developer), but it will actually launch the common user
interface.
You can also launch the common user interface by clicking the Rational
Software Development Platform option, under the IBM Rational
menu.
Launching Rational software products that are installed together on
Linux
When you are working in Red Hat Enterprise Linux, the product launchpoints
are found in the main menu under Programming. This location
will contain links to product specific information (such as readme files), as
well as a launchpoint for the Rational Software Development Platform.
When you are working in SuSE Linux Enterprise Server (SLES), the product
launchpoints are found in the main menu under IBM Rational.
This location will contain links to product specific information (such as
readme files), as well as a launchpoint for the Rational Software Development
Platform.
Migration and coexistence
he following chart illustrates what happens when you attempt to install
more than one product, common to the Rational Software Development Platform,
on the same machine. (In the following chart, the vertical axis
represents products already installed, while the horizontal axis represents
products that you are attempting to install):
| Attempt to install
| Rational Software Modeler
| Rational Web Developer
| Rational Application Developer
| Rational Software Architect
| Rational Functional Tester
| Rational Performance Tester
|
| Rational Software Modeler
| N/A
| Share
| Share
| Upgrade
| Share
| Share
|
| Rational Web Developer
| Share
| N/A
| Upgrade
| Upgrade
| Share
| Share
|
| Rational Application Developer
| Share
| Block
| N/A
| Upgrade
| Share
| Share
|
| Rational Software Architect
| Block
| Block
| Block
| N/A
| Share
| Share
|
| Rational Functional Tester
| Share
| Share
| Share
| Share
| N/A
| Share
|
| Rational Performance Tester
| Share
| Share
| Share
| Share
| Share
| N/A
|
Definitions:
- Block - When you are blocked from installing a product (for
example, if you have Rational Software Architect installed, and you try to
install Rational Application Developer) you cannot install the second product
while the first one is installed. This occurs when you try to install a
product that offers less functionality than the one you currently have
installed.
- Upgrade - When you install a product that contains all of the
functionality that your current product contains, as well as additional
functionality (for example, if you have Rational Web Developer installed, and
want to install Rational Application Developer), you will be upgraded to the
product with the higher functionality. The first product will be
uninstalled, but both the user interface and the workspace that contain your
work for the first product will remain in the same location.
- Share - When this occurs, more than one product shares the
installation of the user interface. The second product extends the
capabilities of an existing product without installing another copy of the
user interface. So, for example, if you install Rational Performance
Tester , and then you install Rational Application Developer, they will both
share the same copy of the user interface, and the user interface will contain
all the functionality that both Rational Performance Tester and Rational
Application Developer offer.
Uninstallation
- Upgraded products - When a product is upgraded, it is removed
and replaced by the higher-function product. If a newly upgraded
product is subsequently uninstalled, the entire product is removed from the
system. For example, if you install Rational Application Developer,
then upgrade to Rational Software Architect, and later choose to uninstall
Rational Software Architect, all plug-ins, including the common user
interface, will be uninstalled - you will not revert back to Rational
Application Developer. To replace Rational Application Developer, you
must reinstall it.
- Products that share - If you have two or more products
installed in a sharing scenario, the user interface is left in place until the
last product is uninstalled. For example, if you have Rational
Application Developer and Rational Performance Tester installed, and you
uninstall Rational Application Developer, Rational Performance Tester (and the
user interface) will still be on your system.
- Note:
- The user interface is installed in the installation directory of the first
Rational Software Development Platform based product you install. It is
not reinstalled with any other products, so if you upgrade your first product,
you should not remove your first installation directory after the upgrade has
completed, as it will still contain the user interface contents.
This section contains information about installing Rational Web Developer
on Windows. You can install Rational Web Developer either from the
CD-ROM or from electronic images that you download. An installation
wizard is provided, but you can also install Rational Web Developer either
from a command prompt, or perform a silent installation, as outlined later in
this documentation.
The installation program can also be run in an interactive console mode,
which may be better suited for persons with accessibility requirements.
The Accessibility Mode command line option:
-accessibility
makes the run-time console mode wizard more friendly for screen reader
programs. To run in console mode, run this command from the \setup
directory on the first Rational Web Developer installation CD:
setup.exe -is:javaconsole -log @NONE -accessibility
Follow the prompts to complete the installation. Note that the
-is:javaconsole option is critical when specifying the
-accessibility option. If you do not specify this option,
the installation program will hang. The -log @NONE option
turns logging off to eliminate log information being listed in the command
prompt window. If you experience any problem during the install, you
may want to eliminate this option in order to collect log information.
You cannot migrate from WebSphere Studio Site Developer or WebSphere Studio
Application Developer v4.x.x. or 5.0.x to
Rational Web Developer. Rational Web Developer can, however, coexist
with either of these products. If desired, you can manually migrate
workspaces, artifacts, and projects from Rational ClearCase(R), Clear Case
LT, and CVS to Rational Web Developer
You can migrate from WebSphere Studio 5.1.x to Rational Web
Developer, or you can choose to coexist. Refer to the Migration Guide for Rational Web
Developer more migration information.
Refer to Chapter 3, "IBM Rational Software Development Platform" for more information about the IBM Rational Software Development
Platform and coexistence between other products based on this development
platform.
If you have a previous version of Agent Controller or any software derived
from the Hyades Data Collection Engine, you should stop it, uninstall it, and
clean up any leftover files before installing this version of Agent
Controller. For more information, refer to Chapter 6, "Installing Agent Controller"
Before you install the product, check the following things:
- In addition to the space required to install the product, your environment
variable TEMP or TMP must point to a valid temporary directory with at least
500 MB free.
To install Rational Web Developer from the first product installation CD,
follow these steps:
- Read "Migration, upgrade, and coexistence issues" before you begin the installation procedure.
- Ensure that the user ID that you are using does not contain
double-byte characters.
- Insert the CD into your CD drive.
- If autorun is enabled on your system, the installation launchpad program
automatically opens. If autorun is disabled on your system, run
launchpad.exe from the root of the first installation CD to
display the Rational Web Developer Installation Launchpad window.
Tips:
- You can bypass the launchpad and go straight to the Rational Web Developer
installation wizard by running setup.exe from the \setup
directory on the first installation CD.
- If you want to install Rational Web Developer from a command prompt
without using the graphical interface, run the following command from the
\setup directory on the first installation CD:
setup.exe -console
- Note:
- Canceling the installation of Rational Web Developer through the console mode
is limited. Once the installation of Rational Web Developer begins, the
installation cannot be canceled. You can cancel the installation during
the preparation steps of the installation process, but there is not a
supported method of canceling the installation after files have begun to be
copied to the hard drive. Clicking Ctrl+C will force the installation
process to quit, but this is not recommended.
- From the Rational Web Developer installation launchpad, select
Install IBM Rational Web Developer V6.0.
- Wait for the installation wizard to open, then click Next to
continue the installation.
- Follow the on-screen instructions for tasks such as reading the license
agreement and specifying the target installation directory.
- The default target installation directory is
system_drive:\Program Files\IBM\Rational\SDP\6.0
(where system_drive is the hard drive where Windows is
installed).
- The installation program checks to see if any other Rational Software
Development Platform products are installed. See Chapter 3, "IBM Rational Software Development Platform" for more details.
- In the Features window, you can select the Rational Web Developer features
that you would like to install. You can return to the installation
wizard and install the optional features later.
- By default, the installation program installs the Integrated Development
Environment and the optional WebSphere Application Server, Version 6.0
as the run-time environment for testing.
- If you want to install the user interface and documentation for supported
national languages other than English, select to install the Language
Pack. By default, this feature is not selected if your system
locale is English. It is selected if your system locale is one of the
other supported national languages.
Supported national languages are Brazilian Portuguese, French, German,
Italian, Japanese, Korean, Simplified Chinese, Spanish, and Traditional
Chinese.
Note: If you select to install the optional Language Pack
feature and then cancel the installation shortly afterwards while files are
being copied, subsequent installs will show some anomalies. On a
subsequent installation, the Language Pack feature will show an (installed)
status on the Feature panel even though the files that make up the language
pack are not installed. You can select to reinstall the Language Pack
feature and the proper files will be copied to your disk. In this
situation, at the end of the installation you may receive a message stating
that One or more errors occurred during replacement of
files. You can safely ignore this error message.
- By default, the Enterprise Generation Language (EGL) feature is not
installed. EGL is a powerful, high-level language for creating complex
business applications. It handles the complexities of underlying
technologies (such as, database access, message queues, and J2EE) so
application developers can focus on their business logic. To install
the EGL plug-in, select the Enterprise Generation Language (EGL)
check box.
- By default, the examples for Eclipse plug-in development are not
installed. These examples are for developers who want to extend the
workbench by creating their own plug-in tools. To install the examples
for Eclipse plug-in development, select the Examples for Eclipse Plug-In
Development check box.
- Click Next to display summary information of the Rational Web
Developer install.
- Note:
- The disk space requirement shown is the total number of bytes needed for all
the files. The actual disk space needed can be considerably
greater. In particular, if your disk is formatted as FAT32, the many
small files can use disk space inefficiently due to the disk blocking
structure that FAT32 uses.
- Click Next to install Rational Web Developer.
- If you receive a warning about a problem with registering the license
towards the end of the install, follow these steps:
- Go to the \logs subdirectory in your installation directory.
- Open license.log with a text editor.
- If license.log contains either of the following lines:
486604803 The requested license has expired
486604805 The start dates for all licenses have not yet occurred
ensure that your system clock is set correctly, and then start Rational
Web Developer.
- The installation program takes some time to set up the development
environment and initialize Eclipse. Eventually you will see a message
confirming that the installation is complete. Click Next to
complete the installation.
- The next screen will contain a message advising you to check for updates
to your installed features using Rational Product Updater. (Refer to Chapter 9, "Installing updates" for more information.) Click Finish to close
the installation window.
- If you plan to develop applications that will run on other application
servers, you can optionally select to install additional legacy run-time test
environments with Rational Web Developer. For more information, refer
to Chapter 8, "Installing WebSphere Application Server 5.x as an integrated test environment"
- Before you can use the profiling, runtime analysis and logging features of
Rational Web Developer to collect data remotely, you must install Agent
Controller on both the local and remote host. Refer to Chapter 6, "Installing Agent Controller" for details.
- Note:
-
- At any time after installing Rational Web Developer, you can add optional
features by rerunning setup.exe from the \setup directory on the
installation CD. The Rational Web Developer installation program is
launched so you can then select the optional features that you want to
add. (Previously installed features will have installed
listed next them in parentheses on the feature selection panel.) You
must use the same user ID that you used to install the required
features.
- If you rerun the installation program to add additional features and
select to cancel the modification before it finishes, you may receive the
following error:
Errors occurred during the installation - User cancelled installation
When you attempt to uninstall the product in this state, you may receive
the following error:
A suitable JVM could not be found. Please run the program again using
the option -is:javahome <JAVA HOME DIR>.
To work around this, you must rerun the installation program again to
complete the previously canceled modification, and then proceed to uninstall
the product.
Refer to the product readme file for a description of the electronic images
that you need to download.
Before you install the product, check the following things:
- Your environment variable TEMP or TMP must point to a valid temporary
directory with at least 500 MB free. This is in addition to the space
required to install the product.
- You must have approximately 3 GB of disk space to store the full set of
downloadable images plus another 4 GB of disk space to unpack the
images.
To download and create the electronic installation image:
- Download all required parts and desired optional parts to the same
temporary directory. If any optional parts are needed later, download
the additional optional parts and rerun the extraction tool prior to
attempting the install.
- Launch the extractor.exe file located in your temporary
directory. This starts the wizard that creates the installation
image.
- Follow the instructions in the wizard to specify where you want to create
the image and which features you want to include.
- After the image is created, if you want to install the product
immediately, click Finish. Alternatively, you can clear the
Start the installation wizard check box, and run the installation
program later by launching disk1\launchpad.exe from the directory where
you created the installation image.
- Follow the instructions described in the "Installing from the CD-ROM" section.
You can place a copy of the installation image on a network drive so that
users can install across a network.
In order to run the installation program from a network drive, you must
either work with a downloaded electronic image of Rational Web Developer or
copy the contents of the CDs as described below.
You need approximately 4 GB of disk space to store CD content on the
disk. To copy the files from the CDs:
- Insert the first Rational Web Developer installation CD into your CD
drive.
- Create a temporary directory on a network drive where you want to store
the image (for example, network_drive:\install_image).
- Under the temporary directory, create a subdirectory called
disk1. This subdirectory must be called disk1 and
it must be in lower case.
- Copy all the files and directories on the first installation CD to the
disk1 subdirectory in the temporary directory.
- Repeats steps 3 and 4 to copy the contents of the other two CDs to
subdirectories called disk2 and disk3.
These are all the core installation files. If you want the
installation files for any of the optional features:
- Agent Controller
- WebSphere legacy test environments
copy the contents of the appropriate CDs into your temporary
directory.
Notes:
- If you map to a network drive without specifying a device name (for
example, \\computername\sharename), you may get the following message when you
try to install Rational Web Developer:
The wizard cannot continue because of the following error: could not load wizard
specified in /wizard.inf(104)
The drive will need to be locally mapped by specifying a device name (for
example, x:\sharename).
- If your machine goes into standby mode during an installation from a
network installation image, the installation may fail.
The Rational Web Developer installation program can be run silently if you
do not want to interact with the installation wizard.
Prior to silently installing Rational Web Developer, you must set up your
local images:
- Read "Migration, upgrade, and coexistence issues" before you begin the installation procedure.
- Ensure that the user ID that you are using does not contain
double-byte characters.
- Create a local or network installation image as described in "Creating a network installation image". If you only want to install Rational Web Developer, you
only need to copy the information from the first three CDs.
The following features are installed by default when silently installing
Rational Web Developer:
- Integrated Development Environment
- WebSphere Application Server, Version 6.0 (run-time environment for
testing)
- Language Pack (if your system locale is non-English)
To install Rational Web Developer silently with only the default selected
features to the default directory system_drive:\Program
Files\IBM\Rational\SDP\6.0 :
- Copy your images as described in "Setting up your local images", if you have not done so already.
- From the command line, change to the \disk1\setup directory in the
temporary directory (for example,
network_drive:\install_image\disk1\setup) that you created in
a previous section.
- Run the following command:
setup.exe -silent
- Silently installing Rational Web Developer may take a while to
complete. To determine when the installation completes, you may monitor
the \logs directory in the default installation directory periodically.
If the license.log file appears, then the silent installation has
completed.
By changing the installLocation parameter, you can install
Rational Web Developer to a different directory. For example, if you
want "d:\my softdev" to be your installation directory, follow the same
steps that were just described, but run the following command:
setup.exe -silent -P installLocation="d:\my softdev"
(In this example, only the default features are installed.)
Rational Web Developer provides you with a sample response file
that silently installs all the default features. This response file is
called responsefile.txt and it is located in the \disk1\util
directory. If you want to change the response file to install other
features, it is recommended that you first make a backup copy of
responsefile.txt.
You can update the response file to install one or more optional Rational
Web Developer feature. The following table shows the response file
options and their corresponding entries in the response file.
Table 1. List of response file options.
| Feature
| Response file entry
|
| Product installation directory
| installLocation
|
| WebSphere Application Server Version 6.0
| feature_was6_win32.active
|
| Language Pack
| feature_lang_pack_rwd_win32.active
|
| Enterprise Generation Language (EGL)
| feature_egl_win32.active
|
| Examples for Eclipse Plug-in Development
| feature_examples_win32.active
|
To silently install any of the optional features:
- Copy responsefile.txt to a new file, for example
myresponsefile.txt.
- Edit your copy of the response file.
- Locate the line containing the installation feature name shown in the
above table. For example, if you want to install the examples for
Eclipse plug-in development, you would locate the following line in the
response
file:# -P feature_examples_win32.active=<value>
line in the response file.
- Make the following changes to this line:
- Remove the # in the first column.
- Change <value> to true.
In this example, this line would be changed to:
-P feature_examples_win32.active=true
- Save your changes.
- Copy your images as described in "Setting up your local images", if you have not done so already.
- From the command line, change to the \disk1\setup directory in the
temporary directory (for example,
network_drive:\install_image\disk1\setup) that you created in
a previous section.
- When you run the response file, add the -options parameter and
the fully qualified name of your response file as shown below:
setup.exe -silent -options "Your_directory\myresponsefile.txt"
where Your_directory is the fully qualified directory name of
where your response file resides.
- Note:
- To verify that your response file is being used, run this command first (that
is, before you run a silent install) without the -silent option,
and verify that your settings are being registered in the installation
wizard. If they are not, there is a problem with your response file
settings or command syntax.
- Silently installing Rational Web Developer may take a while to
complete. To determine when the installation completes, you can monitor
the \logs subdirectory in your installation directory periodically. If
the license.log file appears, then the silent installation has
completed.
To start Rational Web Developer:
- Select Start > Programs > IBM Rational >IBM Rational Web Developer
6.0 > Rational Web Developer. You can also select
Start > Program > IBM Rational > Rational Software Development
Platform to start the product.
- The first time that you start Rational Web Developer, a dialog box opens
with the default workspace directory already specified. By
default, your work is stored in a directory called workspace, located in
C:\Documents and
Settings\youruserid\IBM\rationalsdp6.0. If you want
to save your work somewhere else, you can change the name and location of the
workspace.
- By default, the Use this as the default and do not ask again
check box is cleared. If you keep the default value, a dialog box opens
every time you start Rational Web Developer, allowing you to switch
workspaces. You may want to keep this default value, if, for example,
you choose to maintain different workspaces for different projects.
Tip: If the Use this as the default and do not ask
again check box is selected, the dialog box will not open again, and
Rational Web Developer will start using the workspace from the previous
session. You can change the default value after you have started the
product in the Window > Preferences > Workbench > Startup and
Shutdown page.
- Click OK. There will be a one-time delay while the
workspace structure is created.
The workbench first opens to a series of welcome pages that provide a
product overview and information about what's new, plus links to
tutorials, samples, and external Web resources. Spend some time
exploring these options. Notice as well the sources of information that
are available from the Help menu.
To uninstall Rational Web Developer:
- Close Rational Web Developer.
- Open the Control Panel, then open the Add/Remove Programs window.
Select IBM Rational Web Developer 6.0 and click
Change/Remove to uninstall.
- All files in any plug-ins or features directories are automatically
deleted, including user data and third-party plug-ins that reside in any of
these directories. Your workspace directory, which contains your work,
is not deleted. Some other directories remain:
- The \eclipse\configuration directory is left in case you uninstalled
Rational Web Developer because of a problem and plan to reinstall to the same
directory.
- The \eclipse\links directory may be left if third-party plug-ins were
linked to your product, in case you uninstalled Rational Web Developer because
of a problem and plan to reinstall to the same directory.
- The \logs directory is left to preserve a history of any install-generated
log files. The directory may contain information that can be used to
troubleshoot install-related issues experienced.
If you try to partially uninstall one or more of the Rational Web Developer
required features, you will receive an error message similar to this:
Invalid selection:
Unable to uninstall ide_required: root is not set for uninstall
To work around this problem, select the Product Uninstallation
check box. The uninstallation panel will be reinitialized so that you
may now uninstall Rational Web Developer entirely, or clear the selection of
features that you do not want to uninstall.
To uninstall Rational Web Developer silently, from a command prompt, go to
your installation directory and type:
rwd_prod\_uninst\uninstall.exe -silent
This section covers known problems and limitations with Windows
installation and uninstallation of Rational Web Developer. Refer to the
readme file or the online help for
information about problems and limitations that affect actual use of the
product.
If your installation fails, you must remove any Rational Web Developer
files that have been installed. If the directory where you intended to
install Rational Web Developer is empty, then the installation process has
already removed any files that were installed and you can delete the empty
directory.
If you selected to install the WebSphere Application Server V6.0
Integrated Test Environment when you install Rational Web Developer and the
installation fails, you will see the following message:
The installation of WebSphere Application Server V6.0 Integrated Test Environment has failed.
IBM Rational Software Development Platform will still run, but WebSphere Application Server V6.0 Integrated Test Environment may not be available.
For information on troubleshooting
installation of WebSphere Application Server V6.0, refer to http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_trouble.html.
Note that, by default, WebSphere Application Server V6.0 Integrated
Test Environment is installed in the \runtimes\base_v6 subdirectory where
Rational Web Developer is installed.
On Windows Server 2003, if Terminal Server is installed and configured,
WebSphere Application Server V6.0 Integrated Test Environment may not
be removed when you uninstall Rational Web Developer. To remove it, run
the following command from the directory where you installed the product (for
example, C:\Program Files\IBM\Rational\SDP\6.0):
\runtimes\base_v6\_uninst\uninstall.exe -silent
This section contains information about installing Rational Web Developer
on Linux. You can install Rational Web Developer either from the CD-ROM
or from electronic images that you download. An installation wizard is
provided, but you can also install Rational Web Developer either from a
command prompt, or perform a silent installation, as outlined later in this
documentation.
Installation Note:
- The installation program can also be run in an interactive console mode,
which may be better suited for persons with accessibility requirements.
The Accessibility Mode command line option:
-accessibility
makes the runtime console mode wizard more friendly for screen reader
programs. To run in console mode, type this command on one line:
CD_device/setup/setup.bin -is:javaconsole -log @NONE -accessibility
where CD_device by default is /media/cdrom on SuSE and /mnt/cdrom
on Red Hat. Follow the prompts to complete the installation.
Note that the -is:javaconsole option is critical when
specifying the -accessibility option. If you do not specify
this option the installation program will hang. The -log
@NONE option turns logging off to eliminate log information being listed
in the console window. If you experience any problem during the
install, you may want to eliminate this option in order to collect log
information.
Important -- before working with this product:
- Rational Web Developer requires a substantial number of files to run,
causing the system to allocate a large number of file handles to it.
More file handles will be required for every Rational Web Developer tool that
is run. It is not uncommon for the default limit of 1024 file handles
per process to be exceeded, resulting in a failure of the tools and possibly
the loss of your workspace. In order to avoid this failure, before you
work with the product we recommend that users have their system administrator
raise the number of file handles available for Rational Web Developer
users. Refer to "Increasing the number of available file handles" for instructions increasing the number of handles.
You can migrate from WebSphere Studio v5.1.x to Rational Web
Developer, or you can choose to coexist with Rational Web Developer.
Refer to the Migration Guide
for Rational Web Developer more migration information.
You cannot migrate from WebSphere Studio Site Developer or WebSphere Studio
Application Developer, v4.x.x. or 5.0.x to
Rational Web Developer. Rational Web Developer can, however, coexist
with any of these products. If desired, you can manually migrate
workspaces, artifacts, and projects from Rational ClearCase, Clear Case LT,
and CVS to Rational Web Developer.
Refer to Chapter 3, "IBM Rational Software Development Platform" for more information about the IBM Rational Software Development
Platform and coexistence between other products based on this development
platform.
If you have a previous version of Agent Controller or any software derived
from the Hyades Data Collection Engine, you should stop it, uninstall it, and
clean up any leftover files before installing this version of Agent
Controller. For more information, refer to Chapter 6, "Installing Agent Controller".
Before you install the product, check that:
- In addition to the space required to install the product, your environment
variable TEMP or TMP points to a valid temporary directory with at least 500
MB free.
- The umask setting for the terminal session used to install the product is
set to 0022. This setting enables the product for use by users other
than root. To set this variable, log in as root user, start a terminal
session, and type umask 0022.
- Note:
- If your system is autorun enabled, ensure that your umask setting is set to
0022 before you attempt to install the product. If your umask setting
is not set to 0022, do not install the product from the launchpad
automatically opened by your system. Instead, close the launchpad and
use the following steps to install the product from the installation
CD.
To install Rational Web Developer from the product installation CD, follow
these steps:
- Read "Migration, upgrade, and coexistence issues" before you begin the installation procedure.
- Log in as root user.
- Start a terminal session.
- Type umask 0022 so the product can be used by users other than
root.
- Insert the CD into your CD drive.
During the installation, you will need to insert the next CD. If you
cannot open the CD-ROM to insert the next CD, check if:
- There is a terminal that has CD_device as the current working
directory where CD_device by default is /media/cdrom on SuSE and
/mnt/cdrom on Red Hat.
- Another application (other than the installation program) is using
CD-ROM. If so, stop the application.
If you are still having problems inserting the next CD, follow these
steps:
- If the installation program is still running, click
Cancel.
- Log in as root user.
- If it is not already installed on your machine, install the psmisc RPM
package that is available on the Linux distribution CD.
- Start the installation program.
- If you still have problems, type
/sbin/fuser CD_device from another terminal to display
the process using the CD-ROM.
- To get the detail of the process, type: ps
<process_id>
- If the CD-ROM is not mounted, then mount it by typing:
mount CD_device
- Type: CD_device/launchpad.bin to display
the Rational Web Developer Installation Launchpad window.
Tips:
- From the Rational Web Developer installation launchpad, select
Install IBM Rational Web Developer v6.0.
- Wait for the installation wizard to open, then click Next to
continue the installation.
- Follow the on-screen instructions for tasks such as reading the license
agreement and specifying the target installation directory.
- The default target installation directory is
/opt/IBM/Rational/SDP/6.0. Important: Do
not install into a directory whose name contains double-byte
characters or special characters such as a dollar sign. Doing so may
cause undesirable results such as class path problems in the WebSphere test
environment.
- The installation program checks to see if any other Rational Software
Development products are installed. See the Chapter 3, "IBM Rational Software Development Platform" section for more details.
- In the Features window, you can select the Rational Web Developer features
that you would like to install.
- By default, the installation program installs the Integrated Development
Environment and the optional WebSphere Application Server, Version 6.0
as the run-time environment for testing.
- If you want to install the user interface and documentation for supported
national languages other than English, select to install the Language
Pack. By default, this feature is not selected if your system
locale is English. It is selected if your system locale is one of the
other supported national languages.
Supported national languages are Brazilian Portuguese, French, German,
Italian, Japanese, Korean, Simplified Chinese, Spanish, and Traditional
Chinese.
Note: If you select to install the optional Language Pack
feature and then cancel the installation shortly afterwards while files are
being copied, subsequent installations will show some anomalies. On a
subsequent installation the Language Pack feature will show an installed
status on the Feature panel even though the files that make up the language
pack are not installed. You can select to reinstall the Language Pack
feature and the proper files will be copied to your disk. In this
situation, you may receive a message at the end of the install stating that
One or more errors occurred during replacement of files. You
can safely ignore this error message.
- By default, the Enterprise Generation Language (EGL) feature is not
installed. EGL is a powerful, high-level language for creating complex
business applications. It handles the complexities of underlying
technologies (such as, database access, message queues, and J2EE) so
application developers can focus on their business logic. To install
the EGL plug-in, select the Enterprise Generation Language (EGL)
check box.
- By default, the examples for Eclipse plug-in development are not
installed. These examples are for developers who want to extend the
workbench by creating their own plug-in tools. To install the examples
for Eclipse plug-in development, select the Examples for Eclipse Plug-In
Development check box.
- Click Next to display summary information of the Rational Web
Developer install.
- Click Next to continue installing Rational Web
Developer.
- When asked for the next CD, follow these steps:
- To open the CD-ROM, type: eject CD_device
- Insert the next CD into the CD-ROM.
- If auto-mount is not enabled, mount the CD-ROM by typing:
mount CD_device
- Click OK to continue with the installation.
- If you receive a warning about a problem with registering the license
towards the end of the install, follow these steps:
- Go to the /logs subdirectory of your installation directory.
- Open the license.log with a text editor.
- If the license.log contains either of the following lines:
486604803 The requested license has expired
486604805 The start dates for all licenses have not yet occurred
ensure that your system clock is set correctly, and start Rational Web
Developer.
- When Rational Web Developer is installed, click Next to
complete the installation.
- The next screen will contain a message advising you to check for updates
to your installed features using Rational Product Updater. (Refer to Chapter 9, "Installing updates" for more information.) Click Finish to close
the installation window.
- If you plan to develop applications that will run on other application
servers, you can optionally select to install additional legacy run-time test
environments with Rational Web Developer. For more information, refer
to Chapter 8, "Installing WebSphere Application Server 5.x as an integrated test environment"
- Before you can use the profiling, runtime analysis and logging features of
Rational Web Developer to collect data remotely, you must install Agent
Controller on both the local and remote host. Refer to Chapter 6, "Installing Agent Controller" for details.
- Note:
-
- At any time after installing Rational Web Developer, you can add optional
features by rerunning setup.bin from the /setup directory on the
installation CD. The Rational Web Developer installation program is
launched so you can then select the optional features that you want to
add. (Previously installed features will have installed
listed next them in parentheses on the feature selection panel.)
-
If you rerun the installation program to add additional features and select
to cancel the modification before it finishes, you may receive the following
error:
Errors occurred during the installation - User cancelled installation
When you attempt to uninstall the product in this state, you may receive
the following error:
A suitable JVM could not be found. Please run the program again using
the option -is:javahome <JAVA HOME DIR>.
To work around this, you must rerun the installation program again to
complete the previously canceled modification, and then proceed to uninstall
the product.
Refer to the product readme file for a description of the electronic images
that you need to download.
Before you install the product, check the following things:
- You need at least 500 MB free space in /tmp.
- You must have approximately 3 GB of disk space to store the full set of
downloadable images plus another 4 GB of disk space to unpack the
images.
To download and create the electronic installation image:
- Download all required parts and desired optional parts to the same
temporary directory. If any optional parts are needed later, download
the additional optional parts and rerun the extraction tool prior to
attempting the install.
- Modify the permissions on the extractor.bin file that is located in
this temporary directory by typing:
chmod +x extractor.bin
- Execute the file by typing ./extractor.bin
- Follow the instructions in the wizard to specify where you want to create
the image and which features you want to include.
- After the image is created, if you want to install the product
immediately, click Finish. Alternatively, you can clear the
Start the installation wizard check box, and run the installation
program later by launching disk1/launchpad.bin from the directory where
you created the installation image.
- Follow the instructions described in the "Installing from the CD-ROM" section.
You can place a copy of the installation image on a network drive so that
users can install across the network.
In order to run the installation program from a network drive, you must
either work with a downloaded electronic image of Rational Web Developer or
copy the contents of the CDs as described below.
You need approximately 4 GB of disk space to store CD content on the
disk. To copy the files from the CDs:
- Log in as root user.
- Create a directory (for example, install_image) on a network drive where
you want to store the image.
- Insert the first Rational Web Developer installation CD into your CD
drive.
- Under the temporary directory, create a subdirectory called
disk1. This subdirectory must be called disk1 and
it must be in lower case.
- Copy all the files and directories on the first installation CD to the
disk1 subdirectory in the temporary directory.
- Repeat steps 3, 4, and 5 to copy the contents of the other two CDs to
subdirectories called disk2 and disk3.
These are all the core installation files. If you want the
installation files for any of the following optional features:
- Agent Controller
- WebSphere legacy test environments
copy the contents of the appropriate CDs into your temporary
directory.
- Note:
- If your machine goes into standby mode during an installation from a network
installation image, the installation may fail.
The Rational Web Developer installation program can be run silently if you
do not want to interact with the installation wizard.
Prior to silently installing Rational Web Developer, you must copy your
local images:
- Read "Migration, upgrade, and coexistence issues" before you begin the installation procedure.
- Create a local or network installation image as described in "Creating a network installation image". If you only want to install Rational Web Developer, you
only need to copy the information from the first three CDs.
The following features are installed by default when silently installing
Rational Web Developer:
- Integrated Development Environment
- WebSphere Application Server, Version 6.0 (run-time environment for
testing)
- Language Pack (if your system locale is non-English)
To install Rational Web Developer silently with only the default selected
features to the default directory /opt/IBM/Rational/SDP/6.0:
- Log in as root user.
- Copy your images as described in "Setting up your local images", if you have not done so already.
- From the command line, change to the /disk1/setup directory in the
temporary directory (for example, /tmp/install_image/disk1/setup) that you
created in a previous section.
- Run the following command:
./setup.bin -silent
- Silently installing Rational Web Developer may take a while to
complete. To determine when the installation completes, you may monitor
the /logs subdirectory in your installation directory periodically. If
the license.log file appears, then the silent installation has
completed.
By changing the installLocation parameter, you can install
Rational Web Developer to a different directory. For example, if you
want "/my_softdev" to be your installation directory, follow the same steps
that were just described, but run the following command:
./setup.bin -silent -P installLocation="/my_softdev"
In this example, only the default features are installed.
Rational Web Developer provides you with a sample response
file. This response file is called responsefile.txt and it
is located in the /disk1/util directory. If you want to change the
response file to install other features, it is recommended that you first make
a backup copy of responsefile.txt.
You can update the response file to install one or more optional Rational
Web Developer features. The following table shows the response file
options and their corresponding entries in the response file.
Table 2. List of response file options.
| Feature
| Response file entry
|
| Product installation directory
| installLocation
|
| WebSphere Application Server Version 6.0
| feature_was6_linux.active
|
| Language Pack
| feature_lang_pack_rad_linux.active
|
| Enterprise Generation Language (EGL)
| feature_egl_linux.active
|
| Examples for Eclipse Plug-in Development
| feature_examples_linux.active
|
To silently install any of the optional features:
- Copy responsefile.txt to a new file, for example
myresponsefile.txt.
- Edit your copy of the response file.
- Locate the line containing the installation feature name shown in the
above table. For example, if you want to install the examples for
Eclipse plug-in development, you would locate the following line in the
response file:
# -P feature_examples_linux.active=<value>
- Make the following changes to this line:
- Remove the # in the first column.
- Change <value> to true.
In this example, this line would be changed to:
-P feature_examples_linux.active=true
- Save your changes.
- Log in as root user.
- Copy your images as described in "Setting up your local images", if you have not done so already.
- From the command line, change to the /disk1/setup directory in the
temporary directory (for example, /tmp/install_image/disk1/setup) that you
created in a previous section.
- When you run the response file, add the -options parameter and
the fully qualified name of your response file as shown in the example
below:
./setup.bin -silent -options "Your_directory/myresponsefile.txt"
where Your_directory is the fully qualified directory name of
where your response file resides.
- Note:
- To verify that your response file is being used, run this command first (that
is, before you run a silent install) without the -silent option,
and verify that your settings are being registered in the installation
wizard. If they are not, there is a problem with your response file
settings or command syntax.
- Silently installing Rational Web Developer may take a while to
complete. To determine when the installation completes, you may monitor
the /logs subdirectory of your installation directory periodically. If
the license.log file appears, then the silent installation has
completed.
Before you work with the product we recommend that users have
their system administrator raise the number of file handles available for
Rational Web Developer users above the default limit of 1024 file handles per
process.
Exercise caution when using the following steps to increase your file
descriptors on Linux. Failure to follow the instructions properly could
result in a machine that won't boot properly. Preferably, have
your system administrator do this for you.
To increase your file descriptors:
- Login as root. If you do not have root access you will need to
obtain it before continuing.
- Change to the etc directory.
- Use the vi editor to edit the initscript file in the etc directory.
If this file does not exist, type vi initscript to create
it.
- Note:
- If you decide to increase the number of file handles, do NOT leave an empty
initscript file on your machine, otherwise your machine will not boot the next
time.
- On the first line, type ulimit -n 4096 (the key here is that
the number is significantly larger than 1024, the default on most Linux
machines). Caution: do not set this too high, as it
can seriously impact performance system-wide.
- On the second line, type eval exec "$4".
- Save and close the file after making sure you have done both steps 4 and
5.
- Note:
- Ensure you have followed the steps correctly, as not doing this correctly
will result in a machine that does not boot.
- (Optional) Restrict your users or groups by modifying the
limits.conf file in the etc/security directory. Both SuSE Linux
Enterprise Server (SLES) Version 9 and Red Hat Enterprise Linux Version
3.0 have this file by default. If for some reason you do not
have this file, you may want to consider a more conservative number in step 4
above (like 2048). You need to do this so that most users have a
reasonably low limit on the number of allowable open files per process.
If you used a relatively low number in step 4, it is less important to do
this. However, if you choose to set a high number in step 4, not doing
this can seriously impact the performance of your machine.
Here's how a sample limits.conf file would look that restricts
all users and then sets different limits for others afterwards. This
sample assumes you used 8192 in step 4 above.
* soft nofile 1024
* hard nofile 2048
root soft nofile 4096
root hard nofile 8192
user1 soft nofile 2048
user1 hard nofile 2048
Note that the * in the example above is used to set the limits
for all users first. These limits are lower than the following
ones. The root user has a higher number of allowable descriptors open,
while user1 is in between the two. Make sure you read and understand
the documentation contained within the limits.conf file before making
your modifications.
For more information on the ulimit command, refer to the man page for
ulimit.
To start Rational Web Developer, follow these steps:
- To start Rational Web Developer from a command line, go to your
installation directory and run the command:
./rationalsdp.bin.
- If you are working in Gnome (which is the Red Hat default), the product
shortcut will be on the main menu under Programming > Rational Software
Development Platform. If you are working in KDE (which is the
SuSE default) the product shortcut will be IBM Rational > Rational
Software Development Platform.
- The first time that you start Rational Web Developer, a dialog box opens
with the default workspace directory already specified. By default,
your work is stored in a directory called workspace, located in the
$HOME/IBM/rationalsdp6.0 directory.
- By default, the Use this as the default and do not ask again
check box is cleared. If you keep the default value, a dialog box opens
every time you start Rational Web Developer, allowing you to switch
workspaces. You may want to keep this default value, if, for example,
you choose to maintain different workspaces for different projects.
Tip: If the Use this as the default and do not ask
again check box is selected, the dialog box will not open again, and
Rational Web Developer will start using the workspace from the previous
session. You can change the default value after you have started the
product in the Window > Preferences > Workbench > Startup and
Shutdown page.
The workbench first opens to a series of welcome pages that provide a
product overview and information about what's new, plus links to
tutorials, samples, and external Web resources. Spend some time
exploring these options. Notice as well the sources of information that
are available from the Help menu.
To uninstall Rational Web Developer on Linux, follow these steps:
- Log in as root.
- Go to the rwd_prod/_uninst/ subdirectory in your installation
directory.
- Uninstall Rational Web Developer by typing this command:
./uninstall.bin. If you are working in a file
manager, you can click on the file to launch the uninstaller.
- All files or features in any plug-ins or features directories are
automatically deleted, including user data and third-party plug-ins that
reside in any of these directories. Your workspace directory, which
contains your work, is not deleted. Some other directories
remain:
- The eclipse/.config directory is left in case you uninstalled
Rational Web Developer because of a problem and plan to reinstall to the same
directory.
- The eclipse/links directory may be left if third-party plug-ins were
linked to your product, in case you uninstalled Rational Web Developer because
of a problem and plan to reinstall to the same directory.
- The /logs directory is left to preserve a history of any install-generated
log files. The directory may contain information that can be used to
troubleshoot install-related issues experienced.
If you try to partially uninstall one or more of the Rational Web Developer
required features, you will receive an error message similar to this:
Invalid selection:
Unable to uninstall ide_required: root is not set for uninstall
To work around this problem, select the Product Uninstallation
check box. The uninstallation panel will be reinitialized so that you
may now uninstall Rational Web Developer entirely, or clear the selection of
features that you do not want to uninstall.
To uninstall Rational Web Developer silently, from a command prompt, go to
your installation directory and type:
rwd_prod\_uninst\uninstall.bin -silent
This section covers known problems and limitations with Linux installation
and uninstallation of Rational Web Developer. Refer to the readme file for information about problems
and limitations that affect actual use of the product.
- Do not install to a Novell NetWare drive. Installation will fail on
a Novell NetWare drive.
If you selected to install the WebSphere Application Server V6.0
Integrated Test Environment when you install Rational Web Developer and the
installation fails, you will see the following message:
The installation of WebSphere Application Server V6.0 Integrated Test Environment has failed.
IBM Rational Software Development Platform will still run, but WebSphere Application Server V6.0 Integrated Test Environment may not be available.
For information on troubleshooting
installation of WebSphere Application Server V6.0, refer to http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_trouble.html.
Note that, by default, WebSphere Application Server V6.0 Integrated
Test Environment is installed in the /runtimes/base_v6 subdirectory where
Rational Web Developer is installed.
Agent Controller is a daemon that allows client applications to launch and
manage local or remote applications and provides information about running
applications to other applications. You must install Agent Controller
separately before you can use the following tools:
- Profiling tools to profile your applications. Agent Controller must
be installed on the same system as the application that you are
profiling.
- Logging tools to import remote log files. Agent Controller must be
installed and running on the remote system from which the log files are
imported.
- Component testing tool to run test cases. Agent Controller must be
installed on the systems on which you run the test cases.
- Run-time analysis tool for probe insertion, code coverage and leak
analysis.
- Note:
- This tool is not supported in Rational Web Developer.
- Tools for remote application testing on WebSphere Application Server
version 5.0 or 5.1. (Agent Controller does not have to be
installed for remote publishing of applications; or for local
application publishing or testing.) Note that WebSphere Application
Server version 6.0 has this functionality built in, so Agent Controller
is not required on version 6.0 target servers.
Notes:
- It is highly recommended that you install Agent Controller behind a
firewall.
- Agent Controller has no network security function on z/OS(R) or
OS/400(R).
- For more information on the security implications of using Agent
Controller, refer to the Agent Controller documentation that comes with
Rational Web Developer.
- The online documentation for Agent Controller is not installed until the
software is installed. At that time, the documentation is added to the
Rational Web Developer online help.
- Windows, Linux/IA32: Intel(R) Pentium(R) II processor
minimum. Pentium III 500 MHz or higher is recommended.
- AIX(R): PowerPC(R) 604e 233MHz (IBM RS/6000(R) 7043 43P
Series) minimum
- HP-UX: PA8500 300MHz (HP Workstation C3000) minimum
- Solaris: UltraSPARC-IIi 300MHz (Sun Ultra 10 Workstation) minimum
- OS/400: iSeries(TM) (as required by the operating system)
- z/OS, LINUX/S39: zSeries(R) (as required by the operating
system)
- 512 MB RAM minimum (768 MB RAM is recommended)
- Disk space:
- You will require 100 MB minimum disk space for installing
- Display resolution:
- 800 x 600 display minimum (1024 x 768 recommended)
Note for Linux: The Hyades Data Collection Engine feature
of Agent Controller is compiled using
libstdc++-libc6.2-2.so.3 shared library. Ensure
that this shared library exists under the /usr/lib directory. If it
does not exist, you have to install the RPM package compat-libstdc++ that
comes with the operating system installation media.
Agent Controller has been tested on the following platforms:
- AIX v4.3.3, v5.1, v5.2 on RS/6000
- HP-UX v11.0, v11i on PA-RISC
- z/OS v1R4, v1R5 on zSeries
- OS/400 V5R1, V5R2 on iSeries
- Red Hat Linux v7.1, v7.2, v7.3, v8.0 on Intel
IA32
- Red Hat Linux Advanced Server v2.1 on Intel IA32
- Sun Solaris v8, v9 on SPARC
- SuSE Linux v7.2, v7.3 on Intel IA32
- SuSE Linux Enterprise Server (SLES) v7, v8 on Intel IA32
- SuSE Linux Enterprise Server (SLES) v7 on zSeries
- Windows 2000 Advanced Server (service pack 2) on Intel IA32
- Windows 2000 Professional (service pack 2) on Intel IA32
- Windows 2000 Server (service pack 2) on Intel IA32
- Windows NT(R) 4.0 (service pack 6a) on Intel IA32
- Windows Server 2003 on Intel IA32
- Windows XP Professional on Intel IA32
Agent Controller has not been tested on the following platforms, but it is
expected to run on these platforms:
- AIX v4.33, v5.1.0, v5.2.0, v5.3
on pSeries(R)
- Connectiva Linux Enterprise Edition 1.0 on zSeries
- Connectiva Linux Enterprise Edition 1.0 on Intel IA32
- HP-UX 11iv1 on PA-RISC
- Red Flag Advance Server v4.0, v4.1 on Intel IA32
- Red Hat Linux v7.2 on zSeries
- RedHat Enterprise Linux 3.0 Update 1 on zSeries
- RedHat Enterprise Linux 3.0 Update 3 on zSeries
- SuSE v7.2 on zSeries
- SuSE Linux v7.1 on Intel IA32
- SuSE Linux Desktop 9.0 on Intel IA32
- SuSE Linux Standard Edition 9.0 on Intel IA32
- SuSE Linux Enterprise Server (SLES) 9 on Intel IA32
- SuSE Linux Enterprise Server 8.0, 9.0 on zSeries
- TurboLinux Enterprise Server v8 on Intel IA32
- TurboLinux Enterprise Server v8 on zSeries
- United Linux v1.0 on Intel IA32
- United Linux v1.0 on zSeries
- Windows Server 2003, Standard Edition on Intel IA32
- Windows Server 2003, Enterprise Edition on Intel IA32
- Windows Server 2003, Datacenter Edition on Intel IA32
- zOS 2.10 on zSeries
- z/OS v1R1 to v1R3, v1R6 on zSeries
- z/OS.e v1R3 to v1R6 on zSeries
Agent Controller is not available for the following platforms:
- Linux on iSeries
- Linux on pSeries
In general, Agent Controller works with JVM version 1.4 and
above. Here are the JVM versions (java -fullversion) that Agent
Controller has been tested on:
- AIX: J2RE 1.4.1 IBM AIX build ca1411-20040301
- HP-UX: J2RE
1.4.2.03-040401-18:59-PA_RISC2.0
- Linux IA32: J2RE 1.4.1 IBM build
cxia321411-20040301; J2RE 1.4.2 IBM.
- Linux for OS/390(R): J2RE 1.4.1 IBM build
cx3901411-20040301
- z/OS: J2RE 1.4.1 IBM z/OS Persistent Reusable VM build
cm1411-20030930
- OS/400: J2RE 1.4 IBM
- Solaris SPARC: Sun Java(TM) 2 Standard Edition (build
1.4.2_04-b05)
- Windows: IA32 J2RE 1.4.1 IBM Windows 32 build
cn1411-20040301a; J2RE 1.4.2 IBM Windows 32; Sun
Java(TM) 2 Standard Edition (build 1.4.2_04-b05)
The Agent Controller installation files are located on the optional
software disk in the directories listed below:
- For AIX: /IBM_Agent_Controller/aix
- For HP-UX: /IBM_Agent_Controller/hpux
- For OS/400: /IBM_Agent_Controller/os400
- For Linux/S390: /IBM_Agent_Controller/linux_s390
- For Linux/IA32: /IBM_Agent_Controller/linux_ia32
- For Solaris: /IBM_Agent_Controller/solaris_sparc
- For Windows: \IBM_Agent_Controller\win_ia32
- For z/OS: /IBM_Agent_Controller/os390
If you have a previous version of Agent Controller or any software derived
from the Hyades Data Collection Engine, stop it, uninstall it, and clean up
any left-over files before installing this version of Agent Controller.
The following files may be left behind after uninstalling:
Windows:
%RASERVER_HOME%\*.* (directory where Agent Controller is installed)
%SystemRoot%\system32\piAgent.dll (Windows' system32 directory)
%SystemRoot%\system32\LogAgent.dll
%SystemRoot%\system32\hcbnd.dll
%SystemRoot%\system32\hcclco.dll
%SystemRoot%\system32\hccldt.dll
%SystemRoot%\system32\hccls.dll
%SystemRoot%\system32\hcclserc.dll
%SystemRoot%\system32\hcclsert.dll
%SystemRoot%\system32\hcclsm.dll
%SystemRoot%\system32\hcjbnd.dll
%SystemRoot%\system32\hclaunch.dll
%SystemRoot%\system32\hcthread.dll
%SystemRoot%\system32\piAgent.dll
%SystemRoot%\system32\rac.dll
%SystemRoot%\system32\sysperf.dll
Linux, AIX, HP-UX, Solaris:
$RASERVER_HOME/* (directory where Agent Controller is installed
/usr/lib/libpiAgent.so (or .sl on HP-UX)
/usr/lib/libLogAgent.so
/usr/lib/libhcbnd.so
/usr/lib/libhcclco.so
/usr/lib/libhccldt.so
/usr/lib/libhccls.so
/usr/lib/libhcclserc.so
/usr/lib/libhcclsert.so
/usr/lib/libhcclsm.so
/usr/lib/libhcjbnd.so
/usr/lib/libhclaunch.so
/usr/lib/libhcthread.so
- Log in as Administrator (or root).
- For Windows: if you are installing Agent Controller from the
Rational Web Developer installation CD, select Install Agent
Controller from the Launchpad window (if autorun is disabled, run
lauchpad.exe from the root of the installation CD). Continue to
Step 5.
- Change directory to the installation media for the appropriate
platform.
- Run the program setup.exe. For non-Windows
platforms, run setup.bin.
- Click Next on the welcome screen to proceed.
- Close all Eclipse platforms before continuing with the
installation. Click Next to continue.
- Read the license agreement.
- Select Approve and click Next to proceed.
- You are informed that any existing Agent Controller will be
removed. Click Next to proceed.
- Specify the path where Agent Controller should be installed and click
Next to proceed.
- Select the Agent Controller features you would like to install:
- Hyades Data Collection Engine - framework provided by the
Eclipse open source project for launching and profiling local or remote Java
applications.
- IBM Rational Plugins - must be selected in order to select the
remaining features in this list.
- Logging - an event-based logging framework for profiling and
tracing applications. This is a required selection if either Component
Test or Remote support for WebSphere Application Server is selected.
- Component Test - legacy support for manual test
enablement.
- Runtime Analysis - functionality for probe insertion, code
coverage and leak analysis.
- Note:
- This feature is not supported in Rational Web Developer and will not be
installed.
- Security - provides for creating a secure data communication
channel between the Eclipse workbench and Agent Controller.
- Remote support for WebSphere Application Server - functionality
for connecting to a remote WebSphere Application Server, version 5.0 or
5.1, for activities such as deployment, administration, and performance
analysis. Note that WebSphere Application Server version 6.0 has
these capabilities built in.
Click Next to proceed.
- Specify the path of the Java run-time environment (JRE) executable program
java.exe or java which Agent Controller should be using. The JRE
entered here will be used by Agent Controller for launching Java
applications. Therefore, you may want to change the JRE path pre-filled
by the installer program.
- Note:
- The JRE you provide at this time will be used both to run Agent Controller
and for Agent Controller to launch Java applications. You may, however,
later configure Agent Controller to a use separate JRE for each of these
functions. For details, refer to Agent Controller help topic
Configuring Applications to be launched by the Agent
Controller.
- Optional: Specify the paths of IBM WebSphere Application Server
version 5.0 (Windows only) and 5.1 if "Remote Support for
WebSphere Application Server" was selected.
- Specify which hosts can access Agent Controller. The choices
are:
- Any computer allows any client to access Agent
Controller. (Default selection.)
- This computer only allows only the local host to access Agent
Controller.
- Specific computers allows a specified list of clients to access
Agent Controller. Use commas to separate a host names in a list.
Click Next to proceed.
- If Security was selected in step 9 above: Choose the security
setting.
Click Next to proceed.
- Click Next on the summary screen to proceed.
- Click Finish after file transfer has completed.
You can run the installation process silently using the following
parameters with the setup command:
| Parameter
| Description
|
| Required Parameters
|
|
-silent
| tells the installer to run silently
|
-P installLocation
| specify the installation path
|
-W javaHome_win.path
| (Windows) specify the fully-qualified path of the java.exe
executable
|
-W javaHome_unix.path
| (non-Windows)specify the fully-qualified path of the java executable
|
-W hostList.type
| specify how clients can connect to Agent Controller (ALL, LOCAL, CUSTOM)
- ALL: allow any client
- LOCAL: allow only localhost
- CUSTOM: allow a list of clients (also requires the -W
hostList.hosts parameter)
|
-W security.type
| specify whether security should be turned on (true, false)
- true: enable security (also requires the "-W security.users"
optional parameter)
- false: disable security
|
|
|
|
| Optional Parameters
|
|
-W wasHome_win.was510path
| (Windows) specify the installed location of IBM WebSphere Application
Server 5.1
|
-W wasHome_unix.was510path
| (non-Windows) specify the installed location of IBM WebSphere Application
Server 5.1
|
-W wasHome_win.was500path
| (Windows) specify the installed location of IBM WebSphere Application
Server 5.0
|
-W wasHome_unix.was500path
| (non-Windows) specify the installed location of IBM WebSphere Application
Server 5.0
|
-W hostList.hosts
| specify the client hostnames, separated by commas (if
hostList.type="CUSTOM")
|
-W security.users
| specify which users can connect to Agent Controller (if
security.type = "true")
|
-P hyadesdc_ibm_runtimeAnalysis_feature.active=false
| specify to not install the Runtime Analysis feature (by
default it is installed during silent install)
|
- Note:
- If you are installing Agent Controller silently over an unsecured connection,
use parameter security.type.="false".
Windows example:
setup.exe
-silent
-P installLocation="D:\IBM\AgentController"
-W javaHome_win.path="d:\jdk1.4.1\jre\bin\java.exe"
-W wasHome_win.was510path="d:\WebSphere5.1\AppServer"
-W wasHome_win.was500path="d:\WebSphere5.0\AppServer"
-W hostList.type="CUSTOM"
-W hostList.hosts="host1,host2"
-W security.type="true"
-W security.users="user1,user2"
Non-Windows example:
setup.bin
-silent
-P installLocation="/opt/IBM/AgentController"
-W javaHome_unix.path="/opt/java1.4.1/jre/bin/java"
-W wasHome_unix.was510path="/opt/WebSphere5.1/AppServer"
-W wasHome_unix.was500path="/opt/WebSphere5.1/AppServer"
-W hostList.type="CUSTOM"
-W hostList.hosts="host1,host2"
-W security.type="true"
-W security.users="user1,user2"
Using a response file
You can create a response file (for example, setup.rsp) to store all
the above parameters, instead of specifying them on the command line:
# Start of response file
-P installLocation="D:\IBM\AgentController"
-W javaHome_win.path="d:\jdk1.4.1\jre\bin\java.exe"
-W wasHome_win.was510path="d:\WebSphere5.1\AppServer"
-W wasHome_win.was500path="d:\WebSphere5.0\AppServer"
-W hostList.type="CUSTOM"
-W hostList.hosts="host1,host2"
-W security.type="true"
-W security.users="user1,user2"
# End of response file
To install using the response file:
Windows: setup.exe -silent -options
d:\temp\setup.rsp
Non-Windows: setup.bin -silent -options
/tmp/setup.rsp
- On Windows, the Agent Controller system service (RAService.exe)
will be started automatically.
- Use the Windows Services dialog under Control Panel to start or stop the
Agent Controller service (Start > Settings > Control Panel >
Administrative Tools > Services>IBM Rational Agent Controller).
- On non-Windows platforms, the Agent Controller process (RAServer) does not
start automatically. You must start it yourself.
- Important: The following environment settings for
non-Windows platforms must be set before starting Agent Controller.
- To start the Agent Controller process, change to the installation
location's bin directory (for example,
/opt/IBM/AgentController/bin) and run
./RAStart.sh
- To stop the Agent Controller process, change to the installation
location's bin directory (for example,
/opt/IBM/AgentController/bin) and run
./RAStop.sh
- Agent Controller can be removed from the Add/Remove Programs
dialog under Control Panel.
- To perform a silent uninstallation, run the command
uninstall.exe -silent from the installation
location's _uninst directory (for example, C:\Program
Files\IBM\AgentController\_uninst).
- Run the program uninstall.bin from the installation
location's _uninst directory (for example,
/opt/IBM/AgentController/_uninst).
- Follow the on-screen instruction to complete the uninstallation.
- To perform a silent uninstallation, use the command
uninstall.bin -silent.
If you have a previous version of Agent Controller or any software derived
from the Hyades Data Collection Engine, stop it and uninstall it before
installing this version.
- On the iSeries host, create a library called HYADESDC and another library
called IBMRAC:
CRTLIB HYADESDC
CRTLIB IBMRAC
- On the iSeries host, in the HYADESDC library, create an empty save file
called HYADESDC.SAVF:
CRTSAVF HYADESDC/HYADESDC
- On the iSeries host, in the IBMRAC library, create an empty save file
called IBMRAC.SAVF:
CRTSAVF IBMRAC/IBMRAC
- Use FTP to add the file IBMRAC.SAVF from the installation CD to the
library IBMRAC located on the iSeries host using BINARY mode transfer.
- Use FTP to add the file HYADESDC.SAVF from the installation CD to
the library HYADESDC located on the iSeries host using BINARY mode
transfer.
- Restore the save file HYADESDC.SAVF located on the iSeries host to
the library HYADESDC, by typing:
RSTOBJ OBJ(*ALL) SAVLIB(HYADESDC) DEV(*SAVF) SAVF(HYADESDC/HYADESDC)
- Restore the save file IBMRAC.SAVF located on the iSeries host to
the library IBMRAC, by typing:
RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRAC)
- Start QShell and create, on the integrated file system (IFS), the
/opt/hyadesdc directory.
- Restore the save file HYADESIFS.SAVF in HYADESDC to the IFS
directory /opt/hyadesdc. For example:
RST DEV('/QSYS.LIB/HYADESDC.LIB/HYADESIFS.FILE') OBJ('/opt/hyadesdc/*')
- Restore the save file IBMRACIFS.SAVF in IBMRAC to the IFS directory
/opt/hyadesdc. For example, type the following command on one
line:
RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRACIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
- After you have installed Agent Controller, change the directory to the
installed location's bin directory /opt/hyades/bin, and run the setup
script by typing:
./SetConfig.sh
- Follow the on-screen prompt to configure Agent Controller.
- To start Agent Controller, add the HYADESDC and the IBMRAC libraries to
the library list:
ADDLIBLE HYADESDC
ADDLIBLE IBMRAC
- Submit the RAStart job by typing:
SBMJOB CMD(CALL RASERVER) JOBD(RASTART)
- To stop Agent Controller, terminate the RAStart job by typing:
ENDJOB JOB(RASTART)
- Remove the HYADESDC and IBMRAC library.
- Remove the IFS directory /opt/hyadesdc (including all subdirectories and
files).
If you have a previous version of Agent Controller or any software derived
from the Hyades Data Collection Engine, stop it and uninstall it before
installing this version.
- In a UNIX(R) System Services shell, go to the directory where you want to
install Agent Controller. It is recommended that you install it in the
/usr/lpp/ directory.
- Transfer the install image ibmrac.os390.pax to
the installation directory.
- Issue the following command to extract Agent Controller files:
pax -ppx -rf ibmrac.os390.pax
- Change the directory to the installation bin directory
/usr/lpp/IBM/AgentController/bin, and run the makelinks script by
typing:
./createLinks.sh
- Make the Agent Controller shared object files program controlled by
issuing the following command in a UNIX(R) System Services shell:
extattr +p /usr/lpp/IBM/AgentController/lib/*.so
- After you have installed Agent Controller, change the directory to the
installed location's bin directory /usr/lpp/IBM/AgentController/bin, and
run the setup script by typing:
./SetConfig.sh
- Follow the on-screen prompt to configure the Agent Controller.
Data Channel usage on z/OS:
In order to set a large dataChannelSize in the serviceconfig.xml
file you may need to increase the maximum shared memory segment size setting
on your machine. To do this, increase the IPCSHMMPAGES value in the
BPXPRMxx parmlib member. This value is the maximum number of 4K pages
that your data channel can be. For example, if you want to set
dataChannelSize to 32M, you must set IPCSHMMPAGES to a value greater than
8192.
To allow Agent Controller to communicate with a large number of agents
simultaneously, you must set the IPCSHMNSEGS value in the BPXPRMxx parmlib
member to an appropriate value. This value specifies the maximum number
of attached shared memory segments for each address space. The default
value is 10 so you should increase this to 50.
For more information about the data channels used by Agent Controller,
refer to the online help information for Agent Controller.
For more information about z/OS BPXPRMXX parmlib members and how to update
them, refer to IBM z/OS MVS(TM) Initialization and Tuning
Reference.
Note: RAServer requires the directories of the JRE that
contain executable libraries such as libjvm.so to be added to the
LIBPATH environment variable. For example, if you are using the IBM JRE
1.4.1, the LIBPATH variable would be set as follows:
export LIBPATH=/usr/lpp/java/IBM/J1.4/bin/classic:/usr/lpp/java/IBM/J1.4/bin:$LIBPATH
- Start the server by logging in as root, opening the
/usr/lpp/IBM/AgentController/bin directory and issuing the command:
./RAStart.sh
- To stop the server, log in as root, open the
/usr/lpp/IBM/AgentController/bin directory, and issue the command:
./RAStop.sh
The following list contains hints and tips for using the Agent Controller
security feature on all platforms:
- Authentication is provided by the operating system. Only users
specified at installation time will be allowed to authenticate. If the
user name ANY is provided, any valid user name and password pairs
will be forwarded to the operation system for authentication, otherwise only
listed pairs will be forwarded.
- When security is enabled, the users you specified at installation time are
required to authenticate with the operating system before any information can
be exchanged with Agent Controller. The workbench user must provide a
valid user name and password combination that is an operating system user name
and password.
- (Windows only) Domain name passwords will not be
authenticated. You must provide local user name and password
pairs.
- There are no key management capabilities provided. Agent Controller
uses Java keystores for security.
- A default keystore and exported certificate are in the Agent Controller
directory
\plugins\com.ibm.etools.pd.security\security for
Windows, and
/plugins/com.ibm.etools.pd.security/security for
Linux. These are samples only. You should replace these with a
keystore containing meaningful certificates.
This section covers known problems and limitations related to installing
and uninstalling Agent Controller. Except where otherwise noted, the
following information applies to all operating systems that are supported for
Agent Controller.
Agent Controller may fail to start on non-Windows platforms with the
following message:
RAServer failed to start.
This failure is usually caused when TCP/IP port 10002 is not free.
Agent Controller listens on this port by default. Another process
running on the system may be using this port when Agent Controller is started
or perhaps Agent Controller was just stopped and then restarted before the
port could be released.
If Agent Controller failed to start, you can start it as follows:
- If port 10002 is being used by another process, you can change the port
number by editing the serviceconfig.xml file. This is described
in the documentation.
- Note:
- If the communication port number that is configured in the
serviceconfig.xml file has been changed, then the property
INSTANCE_RAC_PORT_NUM_ID that is defined in the WebSphere Application Server
configuration needs to be changed to the same port number.
- If Agent Controller was just stopped, wait a few minutes and try to start
it again.
If you encounter errors during installation or uninstallation, this may be
due to the fact that the object files of Agent Controller are loaded by
running processes. To ensure the object files can be modified, do the
following:
- Shut down Rational Web Developer.
- Terminate all java.exe processes that contain either the Java
Profiling Agent or the J2EE Request Profiler.
By default, a Rational ClearCase SCM Adapter plug-in is automatically
installed with Rational Web Developer to support using Rational ClearCase as
your software configuration management (SCM) system. For more
information about Rational ClearCase, refer to www.ibm.com/software/awdtools/clearcase/.
Concurrent Versions System (CVS) plug-ins are also automatically installed
with Rational Web Developer to support using CVS as your SCM system.
The most recent version of the CVS server is available from www.cvshome.org. You
do not need to install a CVS client to use CVS, only a CVS server. For
more information about installing and using CVS, refer to the team online
help.
Both the Rational ClearCase SCM adapter and the CVS plug-ins must be
enabled before they can be used. To enable the plug-ins:
- From the Rational Web Developer menu select Window >
Preferences.
- On the Preferences page under Workbench, click
Capabilities.
- In the Capabilities window, scroll to Team and click the
check-box for the adapters you wish to enable.
- Click Apply, then OK.
The plug-ins can also be enabled when sharing a project by selecting the
desired team repository provider.
Neither the Rational ClearCase client or server nor the CVS server is
automatically installed. You must install them separately from Rational
Web Developer.
To work with Rational Web Developer with other available SCM systems, you
will require a specific adaptor for the SCM product. The SCM adaptors
are usually supplied by the SCM product vendor. IBM does not endorse or
warrant the use of other SCM adaptors. For support, or further
information, regarding adapters for other SCM products, please contact the
product vendor directly.
The Rational ClearCase SCM adapter requires ClearCase v2002 or later (full
ClearCase or ClearCase LT) with at least the required minimum patch as listed
in the following tables:
Table 3. Windows
| Required ClearCase version and minimum patch
|
| IBM Rational ClearCase v2002.05.00 and
p2002.05.00.NT-32
|
| IBM Rational ClearCase LT v2002.05.00 and
clearcase_lt_p2002.05.00.NT-11
|
| IBM Rational ClearCase v2003.06.13
|
| IBM Rational ClearCase LT v2003.06.13
|
Table 4. Linux
| Required ClearCase version and minimum patch
|
| IBM Rational ClearCase v2002.05.00 and
clearcase_p2002.05.00-38
|
| IBM Rational ClearCase LTv2002.05.00 and
clearcase_lt_p2002.05.00-17
|
| IBM Rational ClearCase v2003.06.00 and
clearcase_p2003.06.00-11
|
| IBM Rational ClearCase LT v2003.06.00 and
clearcase_lt_p2003.06.00-6
|
Attention: After installing Rational ClearCase (or ClearCase
LT) and Rational Web Developer, you must ensure that your ClearCase client and
server environments are updated with the latest appropriate patch.
Patches are mandatory to provide proper support for comparing and merging
Unified Modeling Language (UML) diagrams. When working with Rational
Web Developer, if you do not update Rational ClearCase (or ClearCase LT) with
the latest appropriate patch, model corruption can occur when comparing and
merging UML diagram files.
To obtain Rational ClearCase releases and patches, go to www.ibm.com/software/awdtools/clearcase/support/index.html
or call IBM Rational Support at 1-800-IBM-SERV (1-800-426-7378).
Rational Web Developer supports the following version of Rational
ClearQuest(R):
- Rational ClearQuest v2003.06.13 (SR3)
Rational ClearQuest is a highly flexible defect and change tracking system
that organizes and automates the processes involved in submitting, assigning,
tracking, testing and releasing change requests. For more information
on Rational ClearQuest, go to www.ibm.com/software/awdtools/clearquest/.
The Rational ClearQuest Client for Eclipse provides seamless integration
between ClearQuest and the Eclipse platform, including the Rational Software
Development Platform.
In order to use the Rational ClearQuest Client for Eclipse, you must
first:
- install Rational Web Developer.
- install and configure the basic Rational ClearQuest application (version
2003.06.13). Contact your local Rational ClearQuest
administrator to find out how to install and configure your Rational
ClearQuest client application and establish a connection to a database.
Information on downloading the Rational ClearQuest Client for Eclipse can
be found at www.ibm.com/support/docview.wss?uid=swg24007802
. Refer to the Readme file, which is available at this URL,
for complete installation instructions.
By default, WebSphere Application Server 6.0 is automatically
installed with Rational Web Developer. If you plan to develop
applications that will run on 5.x application servers, you can
optionally install additional run-time test environments.
You must have Rational Web Developer installed before you can install the
additional run-time test environments.
You have the option of installing the following integrated test
environments:
- WebSphere Application Server 5.1
- WebSphere Application Server Express 5.1
-
WebSphere Application Server 5.0.2
-
WebSphere Application Server Express 5.0.2
To install one or more back-level integrated test environments, follow
these steps:
- From the Rational Web Developer launchpad, click Install WebSphere
test environment V5.x. The IBM Rational Legacy Integrated
Test Environments installer opens.
- Click Next.
- Accept the license agreement and click Next.
- Select the integrated test environments that you want to install.
Click Next.
- Review the summary information and click Next to start the
installation. This summary installation will include the location the
test environments are being installed.
- Click Finish to exit the installer when the installation is
done.
- Note:
- If you install the embedded messaging and queuing support feature, the
WebSphere version 5.x legacy test environments must be not be
uninstalled before uninstalling the embedded messaging and queuing
feature.
To uninstall legacy test environments on Windows, follow these steps:
- Open the control panel.
- Click Add/Remove Programs.
- Click IBM Rational 5.x Legacy Integrated Test
Environments and click Change/Remove.
- The IBM Rational Legacy Test Environments uninstaller open. Click
Next.
- Select the test environments you want to uninstall and click
Next.
- Review the summary information and click Next.
- Click Finish to exit the uninstaller when the test environments
have been uninstalled.
To uninstall legacy test environments on Linux, follow these steps:
- Log in as root.
- Go to the lte_prod/_uninst subdirectory in your installation
directory.
- Uninstall the legacy test environments by typing this command:
./uninstall.bin. If you are working in a file
manager, you can click on the file to launch the uninstaller.
- The IBM Rational Legacy Test Environments uninstaller opens. Click
Next.
- Select the test environments you want to uninstall and click
Next.
- Review the summary information and click Next.
- Click Finish to exit the uninstaller when the test environments
have been uninstalled.
The Rational Product Updater is a tool that keeps track of all Rational
software development products installed on your system and searches for and
installs product updates and optional new features.
The Product Updater is installed automatically along with the first
Rational software development product that you install. All subsequent
Rational software development products that you install are automatically
registered with this tool. For these products, you can search for and
automatically install the following kinds of updates:
- Product updates, such as fix packs, refresh packs and interim
fixes.
- Optional features that provide new functionality.
Any dependencies between updates are automatically enforced. The
Product Updater allows you to manage updates to all of your Rational software
development products from a single location. It will even update
itself.
The Product Updater also enables you to perform these tasks:
- Produce a detailed listing of your installed Rational software development
products, including information on what fixes and optional features are
installed.
- Create one or more local (proxy) product update sites, so users in your
organization do not all need to install updates from the Internet.
Refer to the Product Updater's help system for information on using
the tool, which can be accessed as follows:
- To launch the Product Updater, in Rational Web Developer select
Help > Software Updates > IBM Rational Product
Updater.
- In the Product Updater, select Help > Help
Contents.
See Copyright and notices