IBM Rational Application Developer for Windows and Linux, Version 6.0 Installation Guide
Chapter 1. Introduction
Chapter 2. Installation requirements for Rational Application Developer
Chapter 3. IBM Rational Software Development Platform
Chapter 4. Installing and uninstalling Rational Application Developer for Windows
Chapter 5. Installing and uninstalling Rational Application Developer for Linux
Chapter 6. Installing Agent Controller
Chapter 7. Setting up Rational Application Developer for working in a team environment
Chapter 8. Installing WebSphere Application Server 5.x as an integrated test environment
Chapter 9. Installing messaging and queuing support for the WebSphere version 5.x legacy test environments
Chapter 10. Installing the WebSphere Portal Test Environment version 5.0
Chapter 11. Installing the WebSphere Portal Test Environment version 5.1
Chapter 12. Installing Crystal Enterprise
Chapter 13. Installing updates
Chapter 14. Copyright and notices
This installation guide provides instructions for installing and
uninstalling Rational(R) Application Developer, optional features, and
additional products provided with Rational Application 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
Application 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 Application Developer, you will require
3.5 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 Application 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
Application 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 Application 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 Application 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 Application
Developer on Windows. You can install Rational Application Developer
either from the CD-ROM or from electronic images that you download. An
installation wizard is provided, but you can also install Rational Application
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 Application 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 Application Developer. Rational Application 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 Application Developer
You can migrate from WebSphere Studio 5.1.x to Rational
Application Developer, or you can choose to coexist. Refer to the Migration Guide for Rational
Application 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 Application 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 Application Developer Installation Launchpad
window.
Tips:
- You can bypass the launchpad and go straight to the Rational Application
Developer installation wizard by running setup.exe from the
\setup directory on the first installation CD.
- If you want to install Rational Application 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 Application Developer through the
console mode is limited. Once the installation of Rational Application
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 Application Developer installation launchpad, select
Install IBM Rational Application 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 Application 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 Portal Tools feature is not installed. To install
the Portal Tools feature, select the Portal Tools 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
Application 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 Application 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
Application 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 give you the option to launch installation of Agent
Controller. Before you can use the profiling, runtime analysis and
logging features of Rational Application Developer, you must install Agent
Controller. Refer to Chapter 6, "Installing Agent Controller" for details. Clear the option if you do not wish to
install Agent Controller at this time.
The screen also contains a message advising you to check for updates to
your installed features using Rational Product Updater. (Refer to Chapter 13, "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 Application 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 Application 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.
- If you want test messaging and Webservices applications against WebSphere
Application Server V6.0, support for the default messaging provider is
automatically available and you should not install the embedded messaging
client and server support . If, however, you want to use the WebSphere
Version 5.x legacy test environment, you must separately install the
embedded messaging client and server feature.. For more
information, refer to Chapter 9, "Installing messaging and queuing support for the WebSphere version 5.x legacy test environments".
Important: If MQSeries(R) is already installed, do
not install the messaging and queuing client and server, as they
are a subset of the functions of MQSeries.
- If you plan to use Rational ClearCase as your software configuration
management (SCM) system, you can install the Rational ClearCase LT feature now
or later. For more Rational ClearCase information, refer to Chapter 7, "Setting up Rational Application Developer for working in a team environment".
- If you plan to install the Portal Test Environment V5.0, you can do
so after you have installed Rational Application Developer. For more
information, refer to Chapter 10, "Installing the WebSphere Portal Test Environment version 5.0".
- Crystal Enterprise is an infrastructure for data access and reporting that
is designed to integrate with existing data, Web, and application
investments. It is based on Crystal Reports. Rational
Application Developer includes both Crystal Enterprise Embedded Edition and
Crystal Enterprise Professional Edition, which is a superset of Embedded
Edition. For more information on installing them, refer to Chapter 12, "Installing Crystal Enterprise".
- Note:
-
- At any time after installing Rational Application Developer, you can add
optional features by rerunning setup.exe from the \setup directory on
the installation CD. The Rational Application 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 5.5 GB of disk space to store the full
set of downloadable images plus another 6 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.
- Note:
- When upgrading from one Rational Software Development Platform product to
another using the electronic images, ensure that you download and extract the
same set of images for the new product that you downloaded and extracted for
the original product. The same components installed in the original
product will be automatically installed in the upgraded product.
For example, if the Language Pack was originally installed, when upgrading
you will need to have the Language Pack downloaded and extracted into the new
product installation image.
- 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 Application
Developer or copy the contents of the CDs as described below.
You need approximately 6 GB of disk space to store CD content on the
disk. To copy the files from the CDs:
- Insert the first Rational Application 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
- Embedded messaging client and server
- Rational ClearCase LT
- WebSphere legacy test environments
- WebSphere Portal test environment V5.0
- Crystal Enterprise V10 Professional Edition
- Crystal Enterprise V10 Embedded Edition
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 Application 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 Application Developer installation program can be run silently
if you do not want to interact with the installation wizard.
Prior to silently installing Rational Application 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 Application
Developer, you only need to copy the information from the first three
CDs.
The following features are installed by default when silently installing
Rational Application 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 Application 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 Application 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 Application 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 Application 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
Application 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_rad_win32.active
|
| Enterprise Generation Language (EGL)
| feature_egl_win32.active
|
| Portal tools
| feature_portal_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 Application 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 Application Developer:
- Select Start > Programs > IBM Rational >IBM Rational Application
Developer 6.0 > Rational Application Developer. You can
also select Start > Program > IBM Rational > Rational Software
Development Platform to start the product.
- The first time that you start Rational Application 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 Application 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 Application 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 Application Developer:
- Close Rational Application Developer.
- Open the Control Panel, then open the Add/Remove Programs window.
Select IBM Rational Application 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 Application 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 Application 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 Application
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 Application Developer entirely, or clear the
selection of features that you do not want to uninstall.
To uninstall Rational Application Developer silently, from a command
prompt, go to your installation directory and type:
rad_prod\_uninst\uninstall.exe -silent
This section covers known problems and limitations with Windows
installation and uninstallation of Rational Application 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 Application
Developer files that have been installed. If the directory where you
intended to install Rational Application 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 Application 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 Application 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 Application 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 Application
Developer on Linux. You can install Rational Application Developer
either from the CD-ROM or from electronic images that you download. An
installation wizard is provided, but you can also install Rational Application
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 Application 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 Application
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
Application 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
Application Developer, or you can choose to coexist with Rational Application
Developer. Refer to the Migration
Guide for Rational Application 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 Application Developer. Rational Application 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 Application 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 Application 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 Application Developer Installation Launchpad window.
Tips:
- From the Rational Application Developer installation launchpad, select
Install IBM Rational Application 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 Application 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 Portal Tools feature is not installed. To install
the Portal Tools feature, select the Portal Tools 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
Application Developer install.
- Click Next to continue installing Rational Application
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
Application Developer.
- When Rational Application Developer is installed, click Next to
complete the installation.
- The next screen will give you the option to launch installation of Agent
Controller. Before you can use the profiling, runtime analysis and
logging features of Rational Application Developer, you must install Agent
Controller. Refer to Chapter 6, "Installing Agent Controller" for details. Clear the option if you do not wish to
install Agent Controller at this time.
The screen also contains a message advising you to check for updates to
your installed features using Rational Product Updater. (Refer to Chapter 13, "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 Application 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 Application 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.
- If you want test messaging and Webservices applications against WebSphere
Application Server V6.0, support for the default messaging provider is
automatically available and you should not install the embedded messaging
client and server support . If, however, you want to use the WebSphere
Version 5.x legacy test environment, you must separately install the
embedded messaging client and server feature. For more information,
refer to Chapter 9, "Installing messaging and queuing support for the WebSphere version 5.x legacy test environments".
Important: If MQSeries is already installed, do
not install the messaging and queuing client and server, as they
are a subset of the functions of MQSeries.
- If you plan to use Rational ClearCase as your software configuration
management (SCM) system, you can install the Rational ClearCase LT feature now
or later. For more Rational ClearCase information, refer to Chapter 7, "Setting up Rational Application Developer for working in a team environment".
- Crystal Enterprise is an infrastructure for data access and reporting that
is designed to integrate with existing data, Web, and application
investments. It is based on Crystal Reports. For more
information on installing it, refer to Chapter 12, "Installing Crystal Enterprise".
- Note:
-
- At any time after installing Rational Application Developer, you can add
optional features by rerunning setup.bin from the /setup directory on
the installation CD. The Rational Application 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 5.5 of disk space to store the full set
of downloadable images plus another 6 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.
- Note:
- When upgrading from one Rational Software Development Platform product to
another using the electronic images, ensure that you download and extract the
same set of images for the new product that you downloaded and extracted for
the original product. The same components installed in the original
product will be automatically installed in the upgraded product.
For example, if the Language Pack was originally installed, when upgrading
you will need to have the Language Pack downloaded and extracted into the new
product installation image.
- 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 Application
Developer or copy the contents of the CDs as described below.
You need approximately 6 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 Application 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
- Embedded messaging client and server
- Rational ClearCase LT
- WebSphere legacy test environments
- WebSphere Portal test environment V5.0
- Crystal Enterprise V10 Professional Edition
- Crystal Enterprise V10 Embedded Edition
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 Application Developer installation program can be run silently
if you do not want to interact with the installation wizard.
Prior to silently installing Rational Application 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 Application
Developer, you only need to copy the information from the first three
CDs.
The following features are installed by default when silently installing
Rational Application 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 Application 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 Application 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 Application 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 Application 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
Application 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
|
| Portal tools
| feature_portal_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 Application 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 Application 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 Application Developer, follow these steps:
- To start Rational Application 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 Application 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 Application 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 Application 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 Application Developer on Linux, follow these
steps:
- Log in as root.
- Go to the rad_prod/_uninst/ subdirectory in your installation
directory.
- Uninstall Rational Application 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 Application 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 Application 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 Application
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 Application Developer entirely, or clear the
selection of features that you do not want to uninstall.
To uninstall Rational Application Developer silently, from a command
prompt, go to your installation directory and type:
rad_prod\_uninst\uninstall.bin -silent
This section covers known problems and limitations with Linux installation
and uninstallation of Rational Application 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 Application 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 Application 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.
- 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 Application 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 Application 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).
- 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.
- 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
- On the iSeries host, in the IBMRAC library, create an empty save file
called IBMRTA.SAVF:
CRTSAVF IBMRAC/IBMRTA
- 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.
- Use FTP to add the file IBMRTA.SAVF from the installation CD to the
library IBMRAC 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)
- Restore the save file IBMRTA.SAVF located on the iSeries host to
the library IBMRAC, by typing:
RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRTA)
- 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)
- Restore the save file IBMRTAIFS.SAVF in IBMRAC to the IFS directory
/opt/hyadesdc. For example, type the following command on one
line:
RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRTAIFS.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 images ibmrac.os390.pax and
ibmrta.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 directory
/usr/lpp/IBM/AgentController and type the following command to extract the
runtime analysis extensions:
pax -ppx -rf ../../ibmrta.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 commands in a UNIX(R) System Services shell:
extattr +p /usr/lpp/IBM/AgentController/lib/*.so
extattr +p /usr/lpp/IBM/AgentController/plugins/com.ibm.rational.pd.probekit/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 Application 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 Application 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 Application 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 Application 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
Application Developer.
For information on installing the ClearCase LT client, refer to "Installing Rational ClearCase LT".
To work with Rational Application 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 Application 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 Application 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 Application 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 Application 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.
Rational ClearCase LT is a configuration management tool for small project
teams. ClearCase LT is part of the IBM Rational ClearCase product
family that can scale from small project workgroups to the distributed, global
enterprise.
The IBM Rational Software Development Platform product you purchased
entitles you to a free license of Rational ClearCase LT.
If you do not have the ClearCase LT product media, you must download and
install the latest supported version of ClearCase LT.
If you already have the ClearCase LT v2002.05 or ClearCase LT
v2003.06 product media, you must download and install the latest
ClearCase LT patches to support the ClearCase LT integration with the IBM
Rational Software Development Platform product.
For instructions about how to obtain the latest supported version of
ClearCase LT, and the latest required patches that are supported with the IBM
Rational Software Development Platform, go to IBM Rational Support Technote
number 1188585: www.ibm.com/support/docview.wss?uid=swg21188585.
Or, go to www.ibm.com and
enter 1188585 in the Search box.
Before installing Rational ClearCase LT, it is recommended that you read
the release notes and installation documentation for the product. This
documentation is available online from the IBM Publications Center at www.ibm.com/shop/publications/order.
You may also refer to www.ibm.com/software/rational/support/documentation/.
To open Acrobat PDF files, you must have installed the Adobe Reader software,
which you can download from www.adobe.com/products/acrobat/readstep2.html.
Download the latest IBM Rational ClearCase LT Release Notes for
Windows and the Rational Software Desktop Products Installation
Guide and Rational Software Server Products Installation
Guide for Windows from the IBM
Publications Center as follows:
- Select your country/region on the Welcome page of the Publications
Center.
- Click on the "Search for Publications" link. The Quick Publications
Center search page opens.
- To download the Rational Software Desktop Products Installation
Guide for Windows, Version 2003.06.13:
- Type S126-5304-01 in the "Publication number" field and press
Enter.
- On the resulting page, choose your preferred method of downloading the
document.
- To download the Rational Software Server Products Installation
Guide for Windows, Version 2003.06.13:
- Type S126-5300-01 in the "Publication number" field and press
Enter.
- On the resulting page, choose your preferred method of downloading the
document.
- To download theRational ClearCase LT Release Notes for
Windows:
- Type GI11-4669-03 in the "Publication number" field and press
Enter.
- On the resulting page, choose your preferred method of downloading the
document.
Download the latest Rational ClearCase LT Release Notes and
Rational ClearCase LT Installation Guide for Linux from the IBM Publications Center as follows:
- Select your country/region on the Welcome page of the Publications
Center.
- Click on the "Search for Publications" link. The Quick Publications
Center search page opens.
- To download the ClearCase LT Installation Guide for Version
2003.06.00 and later, UNIX edition:
- Type S126-5310-00 in the "Publication number" field and press
Enter.
- On the resulting page, choose your preferred method of downloading the
document.
- To download theRational ClearCase LT Release Notes for
UNIX:
- Type GI11-6232-00 in the "Publication number" field and press
Enter.
- On the resulting page, choose your preferred method of downloading the
document.
The installation instructions in this section are to help you install the
client and server code for Rational ClearCase LT. You should refer to
the complete installation instructions found in the Rational ClearCase LT
Installation Guide when installing the product.
To learn about changes in the latest version of Rational ClearCase LT,
refer to the Rational ClearCase LT Release Notes.
Instructions on locating the release notes for both Windows and Linux can be
found above.
If you are installing ClearCase LT on a Japanese system, refer to the
section "Guidelines for Using ClearCase on Japanese Systems" in the
Rational ClearCase LT Release Notes.
- Refer to the ClearCase LT Desktop Products Installation Guide
for details on preparing to install the product.
- From the root directory of the downloaded installation image, run
setup.exe.
- The Rational Setup Wizard will open. Click Next to
continue.
- On the Product Selection screen, select Rational ClearCase
LT.
- Choose a one of the following deployment methods for installation and
configuration:
- Enterprise deployment (create a network release area and customize it
using Siteprep).
- Desktop Installation from CD image.
Refer to the Desktop Products Installation Guide to learn
about selecting a deployment type.
- For enterprise deployment:
- Follow the instructions in the dialog box to complete the configuration
process.
- Select Done when you have completed all the configuration
steps.
- For desktop installation from the CD image:
- Select installation of either both the client and server software or only
the client software. Click Next to continue.
- The Setup wizard opens. Click next to continue.
- On the next screen there will be a message stating "There are some
product-specific warnings for this installation: STOP! Before
proceeding with this install, please close all applications and disable
anti-virus software." As instructed, refer to the URL provided in
the warning message (http://ibm.com/support/docview.wss?rs=203&context=SW000&q1=1135295&uid=swg21135295
) before continuing with the installation process. Read the document
and take any steps required to prevent potential system corruption before
continuing with the installation. Click Next to
continue.
- Follow the on-screen instructions to complete the configuration
process. By default, Rational ClearCase LT is installed in the
system_drive:\Program Files\Rational\ directory.
Select Done when you have completed the configuration steps.
- Select Install to begin the installation.
ClearCase LT does not currently support Unicode locales and you must
explicitly set your locale to a non-Unicode setting for ClearCase LT to
function correctly. Red Hat Enterprise Linux 3.0 and SuSE Linux
Enterprise Server (SLES) Version 9 set the locale to a Unicode locale by
default (en_US.UTF-8 for US installations) and may also do so for
international installations. If you are running ClearCase on either of
these platforms, you can change the locale setting as follows:
- For Red Hat Enterprise Linux 3.0: You must set the value of
LANG in the /etc/sysconfig/i18n file to a non-Unicode locale. Possible
locales to use are the C locale or en_US.iso885915. Once you
have set the LANG environment variable to a value that ClearCase supports,
make sure that the SUPPORTED variable in the i18n file also contains this
value. If it does not, add this value to the SUPPORTED variable.
- For SuSE Linux Enterprise Server (SLES) Version 9, UTF-8 encoding can be
turned off as follows:
- Launch the YaST Control Center. (For example, from the SuSE icon in
the bottom corner of the screen, select SuSE > System >
YaST.)
- In YaST, select System.
- Select Choose Language.
- Click the Details button.
- Clear the option Use UTF-8 encoding and then click
OK.
- Click Accept.
- Log out, then log back in.
To install Rational ClearCase LT Version 2003.06.00 on
Linux:
- Log in as root user by typing: su
- From the directory where you downloaded Rational ClearCase LT, extract the
contents of the ClearCase LT download file to a release area as follows:
- Enter the command mkdir /usr/ccase_lt_rls to create the release
area directory. Note that the instructions that follow assume you used
/usr/ccase_lt_rls as the release directory. If you specified a
different name, you will need to use it in place of /usr/ccase_lt_rls.
- Run the command uncompress <cclt_filename.Z> where
<cclt_filename.Z> is the name of the compressed ClearCase
LT download tar file. The resulting file will have the extension
.tar instead of .tar.Z. For example, if the file
is named C54UANA.tar.Z, the command uncompress
C54UANA.tar.Z produces a file named
C54UANA.tar.
- Expand the tar file into the release area directory by entering the
command tar xvf <cclt_filename> -C /usr/ccase_lt_rls where
<cclt_filename> is the name of the uncompressed ClearCase LT tar
file.
- Note:
- The extracted files include the product documentation. Refer to the
Release Notes and ClearCase LT Installation Guide before
continuing the installation process.
For an explanation of the purpose of a release area, see the
ClearCase LT Installation Guide.
- Prepare your release area by running site_prep and follow the
instructions:
cd /usr/ccase_lt_rls/rational_clearcase_lt/rhat_x86/clearcase/install
./site_prep
- Input the values for the prompts as per your requirements. When
prompted to provide the ClearCase LT license host, specify the hostname of
your machine. Refer to the Rational ClearCase LT Installation
Guide for additional details on running site_prep.
- Install ClearCase by running install_release and follow the
instructions:
./install_release
Input the values for the prompts as per your requirements. The
following is an example for a ClearCase LT Client installation on SuSE Linux
Enterprise Server (SLES) Version 9.
- Choose "Local install."
- Accept the licence agreement.
- Choose "Standard install"
- Choose "3. ClearCase LT Client installation."
- When the install_release program ends it should give a message that it
completed with no errors. The message also gives the location and name
of the Log file.
Refer to the Rational ClearCase LT Installation Guide for
additional details on running install_release.
- Add the ClearCase executable to your search path.
For example, if you are using a Bourne shell, you can run the following
command to modify your path:
PATH=${PATH}:/opt/rational/clearcase/bin
export PATH
Refer to the Installation Guide for detailed instructions, and
for additional information on customizing the client host's environment
for ClearCase LT.
- If you have not already installed Rational Application Developer, do so
now.
- To verify that ClearCase has been installed correctly, run the following
command from a non-root user ID. If the command succeeds, the host is
able to acquire a ClearCase LT license. If an error message is
returned, consult the ClearCase LT documentation.
cleartool hostinfo -long
- Start the Rational Development platform and make sure that you can connect
to ClearCase.
- Note:
- By default, the release area is the location for the extracted installation
files, which include the files for the uninstall program. If you delete
this directory, you will not be able to run the uninstall program.
When you have Rational Application Developer installed on the same computer
as Rational ClearCase LT, you do not need to configure Rational ClearCase LT
licensing. However, if you install Rational ClearCase LT without
Rational Application Developer, then you will need to configure ClearCase LT
Licensing. For details on how to configure licensing, see the ClearCase
LT installation guide.
The Rational ClearCase LT license that is included with Rational
Application Developer does not include a license for the Rational
ClearCase Web interface. If you want to use the Rational ClearCase Web
interface you will need to purchase additional Rational ClearCase or ClearCase
LT licenses from IBM Rational software. For more information on
obtaining licenses, contact IBM Rational Support at 1-800-IBM-SERV
(1-800-426-7378).
For information on using Rational ClearCase, refer to the ClearCase online
help.
If diagram files have been checked into Versioned Object Bases (VOBs) in
your ClearCase environment prior to patching or setting up the environment as
described above, run the following command to change the file type of the
elements in the VOB so that they can be merged properly:
cleartool find . -name *.emx -exec "cleartool chtype -force xtools2 %CLEARCASE_PN%"
To uninstall Rational ClearCase LT on Windows:
- Close Rational Application Developer.
- Open the Control Panel, then open the Add/Remove Programs window.
Select Rational ClearCase LT and click Change/Remove to
uninstall.
- Follow the instructions in the wizard to uninstall the product.
To uninstall Rational ClearCase LT on Linux:
- Log in as root user by typing: su
- Run install_release from the release area directory. For example,
if the release area is located in the /usr/ccase_lt_rls directory, type:
cd /usr/ccase_lt_rls/rhat_x86/clearcase/install
./install_release
- Select Local Deinstall to remove software from the local
computer.
By default, WebSphere Application Server 6.0 is automatically
installed with Rational Application 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 Application 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 Application 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.
Important: You must install both Rational Application
Developer and the WebSphere version 5.x legacy test environments before
installing the messaging and queuing support feature.
You do not need to install this feature if any of the following conditions
is true:
- You will only be testing your applications in WebSphere Application Server
(WAS) version 6.0. The WAS version 6.0 included with
Rational Application Developer has new messaging and queuing support for Java
Message Service (JMS).
- If MQSeries is already installed on the machine, do not install
the messaging and queuing client and server as they are a subset of the
functions of the MQSeries.
- You are not building any applications that use JMS.
- You plan to test your JMS applications on a local or remote version of
WebSphere Application Server that already has the embedded messaging feature
installed.
- You plan to test on WebSphere MQ (formerly known as
MQSeries(R)).
If you want to test your JMS applications in the WebSphere version
5.x legacy test environments (these unit test environments are included
with Rational Application Developer) using embedded messaging, you must
install the additional messaging function that is included with this
product. This is the same embedded messaging feature that is
provided with IBM WebSphere V5.x Application Server. You only
need to install the embedded messaging feature either from Rational
Application Developer or WebSphere Application Server V5.x.
Installing both versions will cause the latter installation to overwrite the
previous installation.
You require 200 MB minimum disk space to successfully install the messaging
and queuing feature.
When you install messaging and queuing support from the Rational
Application Developer installation CD, both WebSphere MQ and WebSphere
Messaging Publish and Subscribe are installed.
Limitations:
- If one (but not both) of these components is detected on your system
during the installation from the Rational Application Developer installation
CD, the installation will fail. To avoid this failure, you must
uninstall the component that is already on your system before installing
messaging and queuing support from the Rational Application Developer
installation CD.
- If current versions of both WebSphere MQ and WebSphere Messaging Publish
and Subscribe already exist on your system, the installation of messaging and
queuing support from the Rational Application Developer installation CD
configures both components correctly, but does not reinstall them.
- If both WebSphere MQ and WebSphere Messaging Publish and Subscribe already
exist on your system, but do not match the versions as provided on the
Rational Application Developer installation CD, you must uninstall both
components before proceeding with the installation of messaging and queuing
support from the Rational Application Developer installation CD.
Uninstalling these components will remove all the MQ user data.
- If WebSphere Application Server 5.0 or WebSphere Application Server
5.1 legacy test run-time environments are not installed, then the
installation of messaging and queuing for these test environments support will
fail.
Even though the messaging and queuing support was not installed, you may
receive the "Embedded Messaging Client only has been installed" message upon
starting the server. This message refers to the build-in client code
for the MQ Simulator for Java Developers and not the messaging and queuing
support code. The message can be safely ignored.
To install the embedded messaging feature for use with WebSphere version
5.x legacy test environments:
- Stop Rational Application Developer, if it is started.
- Insert the Rational Application Developer installation CD.
- If autorun is disabled on your system, run launchpad.exe from the
root of the installation CD.
- Select Install embedded messaging client and server from the
Installation Launchpad window and follow the on-screen instructions.
Installation will not proceed if a version 5.x legacy test runtime
environment has not been installed.
The default target installation directory is
system_drive:\Program Files\IBM\WebSphere MQ\ (where
system_drive is the hard drive where Windows is installed).
- When the messaging and queuing support is installed, click
Finish to close the installation window.
- To verify a successful installation:
- Check that a queue manager called WAS_localhost_server1 was created in the
system_drive:\Program Files\IBM\WebSphere MQ\Qmgrs
directory.
- Check that a file called mqEmbeddedInstall.properties is created in
the directory of any run-time environment for testing that was installed on
Rational Application Developer. That is, if base_v5 is the run-time
environment installed, the mqEmbeddedInstall.properties file will be
placed in the RA_installdir\runtimes\base_v5\properties
directory. If base_v5 and base_v51 are the run-time environments
installed, the properties file will be placed in both those properties
directories. The file will not be placed in any other
run-time environments, only in the base_v5 and the base_v51
run-time environments.
To silently install the embedded messaging feature:
- Stop Rational Application Developer, if it is started.
- Insert the embedded messaging client installation CD.
- From the IBM_Embedded_MQ directory on the installation CD for messaging
and queuing support, type the following command on one line:
java -cp setup.jar -Dis.media.home="<cd_rom>\IBM_Embedded_MQ\setup"
-Dis.external.home="<cd_rom>\IBM_Embedded_MQ" run -silent
where cd_rom is the drive letter of your CD-ROM. And press
Enter.
- Note:
- When running a silent install of the messaging and queuing support for
Windows, the install program does not tell you when the installation
finishes. To correct this problem, type on the command line
either:
RA_installdir\runtimes\base_v5\java\bin\java -cp setup.jar
or
RA_installdir\runtimes\base_v51\java\bin\java -cp setup.jar
where RA_installdir is the installation directory of Rational
Application Developer
- To verify a successful installation:
- Check that a queue manager called WAS_localhost_server1 was created in the
system_drive:\Program Files\IBM\WebSphere MQ\Qmgrs
directory.
- Check that a file called mqEmbeddedInstall.properties is created in
the directory of any run-time environment for testing that was installed on
Rational Application Developer. That is, if base_v5 is the run-time
environment installed, the mqEmbeddedInstall.properties file will be
placed in the RA_installdir\runtimes\base_v5\properties
directory. If base_v5 and base_v51 are the run-time environments
installed, the properties file will be placed in both those properties
directories. The file will not be placed in any other
run-time environments, only in the base_v5 and the base_v51
run-time environments.
Restriction: The WebSphere version 5.x legacy test
environments must be present and not uninstalled before uninstalling the
embedded messaging and queuing feature. Uninstalling the embedded
messaging and queuing feature will remove all the MQ user data.
To uninstall the embedded messaging feature:
- Stop Rational Application Developer, if it is started.
- From the Add/Remove Programs window, select embedded messaging client
and server, and then click Remove.
- Follow the on-screen instructions to remove the embedded messaging
feature.
When you install messaging and queuing support from the Rational
Application Developer installation CD, both WebSphere MQ and WebSphere
Messaging Publish and Subscribe are installed.
Limitations:
- If one (but not both) of these components is detected on your system
during the installation from the Rational Application Developer installation
CD, the installation will fail. To avoid this failure, you must
uninstall the component that is already on your system before installing
messaging and queuing support from the Rational Application Developer
installation CD.
- If current versions of both WebSphere MQ and WebSphere Messaging Publish
and Subscribe already exist on your system, the install of messaging and
queuing support from the Rational Application Developer installation CD only
configures both components correctly but does not reinstall them.
- If both WebSphere MQ and WebSphere Messaging Publish and Subscribe already
exist on your system, but do not match the versions as provided on the
Rational Application Developer installation CD, you must uninstall both
components before proceeding with the installation of messaging and queuing
support from the Rational Application Developer installation CD.
Uninstalling these components will remove all the MQ user data.
- If WebSphere Application Server 5.0 or WebSphere Application Server
5.1 legacy test run-time environments are not installed, then the
installation of messaging and queuing support will fail.
Even though the messaging and queuing support was not installed, you may
receive the "Embedded Messaging Client only has been installed" message upon
starting the server. This message refers to the build-in client code
for the MQ Simulator for Java Developers and not the messaging and queuing
support code. The message can be safely ignored.
If you are installing the messaging and queuing support on your machine for
the first time, you set up the user groups as described in the next
section.
Prior to installing the messaging and queuing support for the first time,
you need to create two user groups (mqm and mqbrkrs), add the default user to
each group, and then add the root to each group:
- Log in as the root user.
- In a terminal window, type the following command to create the mqm user
group:
groupadd mqm
- Create the mqbrkrs user group:
groupadd mqbrkrs
- Create a user ID mqm with default group mqm:
useradd mqm -g mqm
- Create a user ID mqbrkrs with default group mqbrkrs:
useradd mqbrkrs -g mqbrkrs
- Add the user root and the non-root users that are going to run JMS
applications to the mqm and mqbrkrs user groups:
- Edit the /etc/group file.
- Locate the mqm group line. (For example,
mqm:x:101:mqm. This line may differ
slightly in your etc/group file). Edit this line by adding a
'root' extension. In this example, it would be
mqm:x:101:mqm,root.
- Locate the mqbrkrs group line. For example,
mqbrkrs:x:102:mqm. This line may differ
slightly in your etc/group file. Edit this line by adding a
'root' extension. In this example, it would be
mqbrkrs:x:102:mqm,root.
- Close the file and save the changes
- Log off.
To install the embedded messaging feature:
- Log in as root user.
- Stop Rational Application Developer, if it is started.
- Insert the Rational Application Developer installation CD in the
CD-ROM.
- If the CD-ROM is not mounted, then mount it by typing:
mount CD_device
where CD_device by default is /cdrom on SuSE and /mnt/cdrom on
Red Hat.
- To display the Installation Launchpad window, type:
CD_device/launchpad.bin
- Select Install embedded messaging client and server.
- You will be asked to insert the Rational Application Developer
installation CD for the embedded messaging client and server.
- Follow the on-screen instructions. The default target installation
directory is /opt/IBM/WebSphereMQ.
- When the messaging and queuing support is installed, click
Finish to close the installation window.
- To verify a successful installation:
- Check that a queue manager called WAS_localhost_server1 was created in the
/var/mqm/qmgrs directory.
- Check that a file called mqEmbeddedInstall.properties is created in
the directory of any run-time environment for testing that was installed on
Rational Application Developer. That is, if base_v5 is the run-time
environment installed, the mqEmbeddedInstall.properties file will be
placed in the RA_installdir/runtimes/base_v5/properties
directory. If base_v5 and base_v51 are the run-time environments
installed, the properties file will be placed in both those properties
directories. The file will not be placed in any other
run-time environments, only in the base_v5 and the base_v51
run-time environments.
To silently install the embedded messaging feature:
- Stop Rational Application Developer, if it is started.
- If you are installing the messaging and queuing support for the legacy
test environments for the first time, complete the steps described in "Setting up the user groups".
- Insert the Rational Application Developer installation CD.
- From the IBM_Embedded_MQ directory on the embedded messaging client
installation CD, type the following command on one line:
./setup.bin -silent
- To verify a successful installation:
- Check that a queue manager called WAS_localhost_server1 was created in the
/var/mqm/qmgrs directory.
- Check that a file called mqEmbeddedInstall.properties is created in
the directory of any run-time environment for testing that was installed on
Rational Application Developer. That is, if base_v5 is the run-time
environment installed, the mqEmbeddedInstall.properties file will be
placed in the RA_installdir/runtimes/base_v5/properties
directory. If base_v5 and base_v51 are the run-time environments
installed, the properties file will be placed in both those properties
directories. The file will not be placed in any other
run-time environments, only in the base_v5 and the base_v51
run-time environments.
Restriction: The WebSphere version 5.x legacy test
environments must be present and not uninstalled before uninstalling the
embedded messaging and queuing feature. Uninstalling the embedded
messaging and queuing feature will remove all the MQ user data.
To uninstall the messaging and queuing feature:
- Log in as the root user.
- Go to the installation directory (for example,
/opt/IBM/WebSphereMQ).
- Type:
./_uninst/uninstaller.bin
If uninstalling messaging and queuing support fails, check the log file
(/tmp/EmbeddedMQ.log).
The WebSphere Portal Test Environment allows you to test portal
applications from the workbench. It is available on Windows
only.
You must have Rational Application Developer installed before you can
install the portal test environment. We recommend that you stop
Rational Application Developer before you start the portal test environment
installation. Otherwise, the installation may fail.
To install the portal test environment, follow these steps:
- If you have installed any of WebSphere Application Server, WebSphere
Portal, WebSphere Application Server Integrated Test Environment, or WebSphere
Portal integrated test environment, ensure all of them are stopped and ensure
you stop any HTTP servers. Otherwise, the installation may fail.
- From the Rational Application Developer installation launchpad, click
Install WebSphere Portal V5.0 test environment. The
WebSphere Portal Test Environment installer opens.
- Click Next.
- Accept the license agreement and click Next.
- The portal test environment is automatically installed in your Rational
Application Developer installation directory. Click
Next.
- Click Finish to exit the wizard when the portal test
environment installation has finished.
Using DB2(R) or Oracle database as the WebSphere Portal configuration
repository
By default, WebSphere Portal V5.0 Test Environment installs and uses
the Cloudscape(TM) database to store information about user identities,
credentials, and permission for accessing portal resources. Cloudscape
is a WebSphere Portal built-in Java database that is well suited to basic
portal environments.
To install and configure a DB2 or Oracle database, refer to the WebSphere Portal Version 5.0.2
InfoCenter at www.ibm.com/websphere/portal/library.
You can find the instructions in the WebSphere Portal version
5.0.2 InfoCenter under Installing > Database. Before
starting steps to configure WebSphere Portal with DB2 or Oracle, note that you
will need to change the directory to the \runtimes\portal_base_v5\config
subdirectory of the directory where Rational Application Developer is
installed and execute the following command:
WPSconfig.bat wpcpconfigure
Note that when referring to the configuration instructions in the
InfoCenter, <wp_root> in the InfoCenter is corresponds to the
\runtimes\portal_v50 subdirectory of the directory where Rational Application
Developer is installed, and <was_root> corresponds to the
\runtimes\portal_base_v5 subdirectory of the directory where Rational
Application Developer is installed. To verify the database connection,
you will create the WebSphere Portal 5.0 Test Environment and start the
server, instead of following steps described in the InfoCenter.
Uninstalling WebSphere Portal Test Environment 5.0
To uninstall, follow these steps:
- Open the Control Panel.
- Click Add/Remove Programs.
- Select WebSphere Portal V5.0 test environment and click
the Change/Remove button.
- Follow the on-screen instructions to uninstall the portal test
environment.
In some cases, such as an aborted installation, the uninstaller might not
be completed and functional. In these cases, use the following
procedure to complete the uninstallation manually:
- Invoke regedit.exe from a command prompt, to edit the Windows
system registry.
Handle the Registry with care: You can easily make a
mistake while using the regedit.exe editor to view and edit registry
contents. The editor does not warn you of editing errors, which can be
extremely dangerous. A corrupt registry can disrupt your system to the
point where your only option is to reinstall the Windows operating
system.
- Expand and select the key HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere
Portal Server\5.0.0.0.
- Click Edit > Delete from the menu bar to delete the
key.
- Click Yes when asked to confirm deletion of the key.
- Click Registry > Exit from the menu bar when you are
finished.
- Delete the following directories, including any subdirectories, from the
<rational_installdir>\runtimes directory:
- portal_base_v5
- portal_v50
where <rational_installdir> is the directory where you have
installed Rational Application Developer.
The portal test environment allows you to test portal applications from the
workbench. Version 5.1 provides new functionality over version
5.0, and is supported on all the Windows environments supported for
Rational Application Developer. It is also supported on Red Hat
Enterprise Linux Workstation, Version 3.0.
- Note:
- WebSphere Application Sever 5.1 is automatically installed with the
WebSphere Portal Test Environment version 5.1.
Installing from the CD-ROM
You must have Rational Application Developer installed before you can
install the portal test environment. We recommend that you stop
Rational Application Developer before you start the portal test environment
installation.
To install the WebSphere Portal Test Environment 5.1, follow these
steps:
- If you have installed any of WebSphere Application Server, WebSphere
Portal, WebSphere Application Server Integrated Test Environment, or WebSphere
Portal integrated test environment, ensure all of them are stopped and ensure
you stop any HTTP servers. Otherwise, the installation may fail.
- Insert the setup CD of WebSphere Portal 5.1. (The portal
test environment cannot be installed from the main Rational Application
Developer installation launchpad.)
- On Windows systems, the installation program should automatically
launch. If it does not, run the install.bat file from the root
of the installation CD. On Linux systems, run install.sh from
the root of the installation CD.
- Select the language you want the installation program run in and click
OK to continue
- Read the information in the Welcome page of the installation program and
click Next.
- Accept the license agreement and click Next
- Select the Test Environment radio button and click
Next.
- Note:
- Depending on your platform, you may receive an error message indicating the
operating system prerequisite check failed. This happens because some
operating systems (for example, Red Hat Enterprise Linux Workstation Version
3.0) are only supported in the portal test environment. You can
safely ignore this message -- click OK to continue with the
installation.
- Accept the default installation directory for WebSphere Application Server
V5.1, or browse to select a new one, and click Next.
The default installation directory is C:\Program
Files\Portal51UTE\AppServer for Windows and opt/Portal51UTE/AppServer for
Linux. Unless you do not have enough space, the default installation
directory is recommended.
- Accept the default installation directory for the Portal Test Environment,
or browse to select a new one, and click Next. The default
installation directory is C:\Program Files\Portal51UTE\PortalServer for
Windows and opt/Portal51UTE/PortalServer for Linux. Unless you do not
have enough space, the default installation directory is recommended.
- Specify the user ID and password that you want to use with the Portal Test
Environment. Click Next.
- Review the information in the summary screen and click Next
- When you are prompted to, insert the appropriate WebSphere Portal
5.1 CD and specify its drive location.
- When the installation is finished, click Finish to close the
installation program.
Notes:
Refer to the online help file "Configuring the WebSphere Portal Test
Environment V5.1" for information about configuring Portal Test
Environment 5.1 to work with Rational Application Developer.
Installing from electronic images
To facilitate the installation of software, create the appropriate
directory, and then download and extract the contents of each file into that
directory.
- Note:
- You must download, extract, and run the images on the same platform that the
image supports. For example, if the title of an image lists only
Windows, you can download, extract, and run that image on a Windows system
only.
The following CD images are required for WebSphere Portal Test Environment
version 5.1:
-
cdSetup, cd1-1, cd1-2, cd1-15, cd2, cd3.
-
cdSetup, cd1-3, cd1-4, cd1-16, cd2, cd3.
Perform the following steps to create the appropriate directories and
download the files:
- Create a directory for each image that you will download
.
Create new directories within a common directory on the same machine, and
name the new directories according to the corresponding disc identifier that
is provided in the title, preceded by the characters cd. For example,
cdSetup, cd1-1, cd1-2, and so on.
- Windows example: Create a common directory (for example,
Portal_images) and create the following directories within the common
directory: cdSetup, cd1-1, cd1-2, cd1-15, cd2, cd3.
- Linux example: Create a common directory (for example,
Portal_images) and create the following directories within the common
directory: cdSetup, cd1-3, cd1-4, cd1-16, cd2, cd3.
- Download each image and extract the contents.
Download each image into its own directory. The steps shown below
provide instructions on how to download and extract a specific image.
These steps use the following image as an example:
WebSphere Portal V5.1 - Setup Manager for Windows and Linux (Setup) for Brazilian Portuguese, French, German, International English, Italian, Japanese, Korean, Simplified Chinese, Spanish, Traditional Chinese
File Name C7003ML.zip
To download and extract the contents of this image, perform the following
steps:
- Create a directory named cdSetup.
- Download C7003ML.zip into the cdSetup directory.
- Extract the files from C50JMML.zip into the cdSetup
directory.
- When you are ready to install the extracted images, refer to the
"Installing from the CD-ROM" section above.
Using DB2 or Oracle database as the WebSphere Portal configuration
repository
By default, WebSphere Portal V5.1 Test Environment installs and uses
the Cloudscape database to store information about user identities,
credentials, and permissions for accessing portal resources. Cloudscape
is a WebSphere Portal built-in Java database that is well suited to basic
portal environments.
To install and configure a DB2 or Oracle database, please refer to the WebSphere Portal V5.1 InfoCenter at
www.ibm.com/websphere/portal/library.
You can find the instructions in the WebSphere Portal version 5.1
InfoCenter under Configuring > Database. Note that when referring to
the configuration instructions in the InfoCenter, <wp_root> in
the InfoCenter corresponds to the installation directory of the WebSphere
Portal 5.1 Test Environment, and <was_root> in the
InfoCenter corresponds to the installation directory of WebSphere Application
Server V5.1 (see above for the default locations). Also, to
verify the database connection, you will create the WebSphere Portal
5.1 Test Environment and start the server, instead of following the
steps in the InfoCenter.
Configuring the WebSphere Portal Test Environment
version 5.1
You need to configure Portal Test Environment 5.1 to work with
Rational Application Developer as follows:
- Start Rational Application Developer.
- From the menu bar, select Window > Preferences > Server > Installed
Runtimes. The Installed Server Runtime Environments page
appears.
- Select WebSphere Portal v5.1 stub and select
Edit. The Edit Server Runtime page appears.
- Change the name to WebSphere Portal v5.1 and specify the WebSphere
Portal Location and WebSphere Application Server Location. (For
example, C:\Program Files\Portal51UTE\PortalServer and C:\Program
Files\Portal51UTE\AppServer respectively).
- Click Finish and click OK.
Uninstalling the V5.1 portal test environment
To uninstall the portal test environment, follow these steps:
- Go to the directory where you have installed the portal test
environment.
- Go to the PortalServer\uninstall subdirectory and run the
uninstall application.
- Follow the on-screen instructions.
In some cases, such as an aborted installation, the uninstaller might not
be completed and functional. In these cases, you will need to complete
the uninstallation manually. Refer to the WebSphere Portal V5.1 InfoCenter for
details on manually uninstalling WebSphere Portal Test Environment version
5.1.
Crystal Enterprise is a common architecture for data access, reporting, and
information delivery. It is designed to integrate seamlessly with
existing data, Web, and application investments. Based on Crystal
Reports, Crystal Enterprise is an effective solution for scaling information
to thousands of users.
Crystal Enterprise Embedded Edition includes an on-demand
reporting server for Web applications and is ideal for embedding reports into
a single, departmental application. It is available only for
Windows.
Crystal Enterprise Professional Edition is a centralized
platform for managing and securely distributing complex and interactive
reports via the Web or integrated into intranet, extranet, Internet, and
corporate portal applications. The Professional Edition includes all of
the function of the Embedded Edition and is available for both Windows and
Linux.
For a more detailed comparison of Crystal Enterprise Embedded and
Professional Editions, see www.businessobjects.com/global/pdf/products/reporting/crystalenterprise/ce10_editions.pdf.
(To open Acrobat PDF files, you must have installed the Adobe Reader software,
which you can download from www.adobe.com/products/acrobat/readstep2.html.)
For more information about Crystal Enterprise in general, see www.businessobjects.com/products/reporting/crystalenterprise/default.asp.
As an integrated suite for reporting, analysis, and information delivery,
Crystal Enterprise provides a solution for increasing end-user productivity
and reducing administrative efforts.
Installing Crystal Enterprise V10 Embedded Edition
To install the Crystal Enterprise V10 Embedded Edition, follow these
steps:
- Insert the Crystal Enterprise V10 Embedded Edition disk.
- From the Rational Application Developer installation launchpad, click
Install Crystal Enterprise V10 Embedded Edition. The Crystal
Enterprise installer opens.
- Click Next. Accept the license agreement and click
Next again.
- You can select either a Full installation or a
Custom installation.
- The default installation is a Full installation. This is
the recommended option and installs all the default components into the
following location: C:\Program Files\Crystal Decisions.
- If you want to customize anything about the installation such as its
location, select the Custom radio button and click
Next. Customize your options as desired. For more
information about custom installation options, refer to the install.pdf
file in the en/docs subfolder on the Crystal Enterprise V10 Embedded Edition
CD.
- Click Next to proceed, then click Next again to
start the installation.
- When the installation is finished, either click Next to
register Crystal Enterprise or Register Later to register the
product later.
- Click Finish to exit the installation wizard.
You can also install Crystal Enterprise V10 Embedded Edition in
Japanese. Run setup.exe from the jp
subdirectory to launch the installation wizard and follow the same
instructions as listed above.
Uninstalling Crystal Enterprise V10 Embedded Edition
To uninstall Crystal Enterprise (English or Japanese edition), follow these
steps:
- Open the Control Panel.
- Click Add/Remove Programs.
- Select Crystal Enterprise 10 Embedded and click the
Remove button.
Crystal Enterprise will be removed from your system.
Installing Crystal Enterprise V10 Professional Edition
To install the Crystal Enterprise V10 Professional Edition on Windows, follow
these steps:
- Insert the Crystal Enterprise V10 Professional Edition disk for
Windows.
- From the Rational Application Developer installation launchpad, click
Install Crystal Enterprise V10 Professional Edition. The
Crystal Enterprise installer opens.
- Click Next. Accept the license agreement and click
Next.
- Enter your Full Name, and Organization. The
Product Keycode field is automatically populated. Click
Next.
- You can either accept the default installation directory or
Browse for a new one. Click Next.
- There are three different types of installations available:
New, Expand, and Custom.
- The default option is a New installation. This will
install a new Crystal Enterprise System.
- If you want to expand an existing Crystal Enterprise system, select the
Expand radio button and click Next. You can enter
the Existing CMS Name (where CMS is your Crystal Management
Server), and select the servers you want to add to your Crystal
Enterprise System. For more information about expanding an
existing Crystal Enterprise system, refer to the docs\install.pdf file
on the Crystal Enterprise V10 Professional Edition CD.
If you want to customize which application features are installed, select
the Custom radio button and click Next. Select
the features you want to install. For more information about custom
installations, refer to the docs\install.pdf file on the Crystal
Enterprise V10 Professional Edition CD.
- Click Next to proceed.
- If you do not have a compatible Web server installed, you will receive a
warning message. Click Next to proceed.
- If you selected a New installation, and the setup program
detects a Microsoft(R) Data Engine (MSDE) or SQL Server, a Microsoft SQL
Server Authentication dialog box opens. You must provide the ID and
password that correspond to the database account you set up for the Crystal
Management Server (CMS). Otherwise, if the setup program does not
detect an existing MSDE or SQL Server database, the MSDE Security
Configuration dialog box opens. You must provide an ID and password for
the default SQL administrator account that will be installed along with the
MSDE. For more information about Crystal Management Server (CMS) or
Microsoft Data Engine (MSDE), refer to the docs\install.pdf file on the
Crystal Enterprise V10 Professional Edition CD. Click Next
to proceed, then click Next again to start the installation.
- If you selected to expand an existing Crystal Enterprise system, and you
chose to add an additional CMS, the CMS Database Information dialog
opens. Specify the database connection type that the CMS must use to
connect to the existing CMS database. Click Next to proceed,
then click Next again to start the installation.
- If you selected a Custom installation, the CMS Clustering
dialog opens. Unless you want to cluster this new system with an
existing system, select No and click Next to
proceed. If the setup program detects a Microsoft Data Engine (MSDE) or
SQL Server, a Microsoft SQL Server Authentication dialog box opens. You
must provide the ID and password that correspond to the database account you
set up for the Crystal Management Server (CMS). Otherwise, if the setup
program does not detect an existing MSDE or SQL Server database, the MSDE
Security Configuration dialog box opens. You must provide an ID and
password for the default SQL administrator account that will be installed
along with the MSDE. For more information about Crystal Management
Server (CMS) or Microsoft Data Engine (MSDE), refer to the
docs\install.pdf file on the Crystal Enterprise V10 Professional
Edition CD. Click Next to proceed, then click
Next again to start the installation.
- You may be prompted to reboot your machine during the installation.
- When the installation has finished, either click Next to
register Crystal Enterprise or Register Later to register the
product later.
- Click Finish to exit the installation wizard.
You can also install Crystal Enterprise V10 Professional Edition in
Japanese. Go to the root directory on the Crystal Enterprise V10
Professional Edition Japanese on Windows CD and run
setup.exe to launch the installation wizard. Follow
the same instructions as listed above, however, you must launch the Japanese
installation wizard directly from the Crystal Enterprise V10 Professional
Edition Japanese on Windows CD.
To install the Crystal Enterprise V10 Professional Edition on Linux, follow
these steps:
- Insert the Crystal Enterprise V10 Professional Edition disk for Linux and
mount the cdrom.
- Open the install.html file located in the root directory of the
installation disk. This file contains complete instructions for
installing Crystal Enterprise V10 Professional Edition on Linux. You
will need to refer to the instructions in this file to prepare your system and
complete the installation process. You should also review the
"Installation" section of the release.htm file, which is located in the
root directory of the installation disk, prior to installing the
product.
- Review the "Setting up your Linux system" section of the
install.html file and perform all necessary actions before proceeding
with running the installation script.
- Disable any antivirus software before installing the product.
- Follow the "Running the installation script" instructions in the
install.html file to complete the installation process. It
describes the procedure for a user installation.
Notes:
- In the "Running the installation script" instructions you are told to copy
the licensetext file (included with your product distribution), and the files
containing the Crystal Enterprise binaries (with the extension .gz) to
your HOME directory. These files are located in the linux_x86 directory
of the installation disk.
- In "Running the installation script" there is a step that indicates you
should enter a product activation keycode. You can ignore this
step.
- When the installation script completes, you must deploy the Crystal
Enterprise Web desktop and the Crystal Enterprise Launchpads. Refer to
the "Deploying the Crystal Enterprise web desktop" section in the
install.html file.
- For information on deploying the Web Component Adapter (WCA), including
information on deploying multiple WCAs, refer to the "Deploying the Web
Component Adapter" section of the install.html file.
- Enable your antivirus software, if you disabled it prior to beginning the
installation.
You can also install Crystal Enterprise V10 Professional Edition in
Japanese. Follow the same instructions as listed above using the
Japanese version of the Crystal Enterprise V10 Professional Edition Japanese
on Linux CD.
Uninstalling Crystal Enterprise V10 Professional Edition
To uninstall Crystal Enterprise on Windows (English or Japanese Edition),
follow these steps:
- Open the Control Panel.
- Click Add/Remove Programs.
- Select Crystal Enterprise 10 and click the Remove
button.
Crystal Enterprise will be removed from your computer.
To uninstall Crystal Enterprise on Linux (English or Japanese Edition),
follow these steps:
- Run the uninstallCE.sh script that is in the
crystal directory of your installation. This script deletes
all of the files installed during your original installation of Crystal
Enterprise
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 Application Developer select
Help > Software Updates > IBM Rational Product
Updater.
- In the Product Updater, select Help > Help
Contents.
See Copyright and notices