After you install Rational Performance Tester
There are two components to the product: Rational Performance Tester, which is installed on the desktop, and Rational Agent Controller, which generates load using additional computers. Agent Controller runs drivers, which emulate virtual users, on the remote computers. Virtual users are instances or iterations of load tests. When you install Performance Tester on a local computer, you also install Agent Controller.
If you install any of these products, the Rational Software Development Platform is installed as part of the product. If more than one of these products is installed, the Rational Software Development Platform is installed only once. All of these products use the same copy of the Rational Software Development Platform.
Already installed | Rational Software Modeler | Rational Web Developer | Rational Application Developer | Rational Software Architect | Rational Functional Tester | Rational Performance Tester | |
Rational Software Modeler | N/A | Shell Share | Shell Share | Upgrade | Shell Share | Shell Share | |
Rational Web Developer | Shell Share | N/A | Upgrade | Upgrade | Shell Share | Shell Share | |
Rational Application Developer | Shell Share | Block | N/A | Upgrade | Shell Share | Shell Share | |
Rational Software Architect | Block | Block | Block | N/A | Shell Share | Shell Share | |
Rational Functional Tester | Shell Share | Shell Share | Shell Share | Shell Share | N/A | Shell Share | |
Rational Performance Tester | Shell Share | Shell Share | Shell Share | Shell Share | Shell Share | N/A |
Platform | Service pack | Components |
---|---|---|
Windows 2000 Professional | SP3, SP4 | Performance Tester and Agent Controller |
Windows XP Professional | SP1, SP2 | Performance Tester and Agent Controller |
Red Hat Enterprise Linux Workstation 3 | None | Performance Tester and Agent Controller |
SUSE Linux Enterprise Server 9 | SP1 | Performance Tester and Agent Controller |
Windows Server 2003 Enterprise Edition, Windows Server 2003 Standard Edition | None | Agent Controller only |
Windows 2000 Server, Windows 2000 Advanced Server | SP3, SP4 | Agent Controller only |
System component | Requirement |
---|---|
CPU | Intel Pentium IV 1.5 GHz or compatible processor |
Memory (RAM) | 768 MB |
Free disk space | 1.5 GB (with at least 500 MB in /tmp for Linux systems) |
Network interface | 100 megabits/second Ethernet |
Display | 1024 x 768; 256 colors |
Virtual tester license key packs are not divisible. Performance Tester checks out a pack when it runs a test with more than five virtual testers. If you have a license pack for 50 virtual testers, and Performance Tester initiates a test with 25 virtual testers on machine A, then machine B is limited to five virtual testers until the test initiated from machine A is completed.
On the other hand, virtual tester license key packs are additive. Performance Tester on a specific machine can check out multiple license keys from a given license server to run a test. For example, machine A can check out two 50 virtual tester license key packs to run a test with 100 virtual users.
When you purchase Performance Tester through Passport Advantage, the Passport Advantage software shipment or download contains a document called Important Licensing and Installation Information. That document contains the following information:
You can use either that document or the Proof of Entitlement certificate to obtain license keys from IBM.
To obtain license keys:
On Linux, you can install a Rational License Server directly from the launchpad. On the Linux launchpad, click Install IBM Rational Common Licensing Server for Linux. This option is currently not available from the Windows launchpad.
License servers and clients can run on different platforms. For example, if a license server is already running on a Linux computer, you do not need to install a license server on Windows to serve Windows clients.
For information on uninstalling the product, see the appropriate uninstallation procedures in this document.
To run in console mode on Windows, run this command from the \setup directory of the Performance Tester installation CD:
setup.exe -is:javaconsole -log @NONE -accessibility
To run in console mode on Linux, type this command on one line:
CD_device/setup/setup.bin -is:javaconsole -log @NONE -accessibility
where
Click Next when you are ready to proceed.
To download and create the electronic installation image:
To run the installation program from a network drive, you must either work with a downloaded electronic image of Rational Performance Tester or copy the contents of the CD as described below.
You need approximately 1.5 GB of disk space to store the contents of the Windows, Linux, and Agent CDs on the disk. To copy the core installation files from the CD:
The wizard cannot continue because of the following error: could not load wizard specified in /wizard.inf(104)
In this case, you must map the drive by specifying a device name (for example, x:\sharename).
On Windows, the default directory is system_drive:\Program Files\IBM\Rational\SDP\6.0.
On Linux, the default directory is /opt/IBM/Rational/SDP/6.0.
To silently install Rational Performance Tester in the default directory with only the default selected features:
On Windows, to specify "d:\my softdev" as your installation directory, run the following command: setup.exe -silent -P installLocation="d:\my softdev"
On Linux, to specify "/my_softdev" as your installation directory, run the following command: ./setup.bin -silent -P installLocation="/my_softdev"
(In these examples, only the default features are installed.)
You can update the response file to install one or more optional Rational Performance Tester features. The following table lists the features and their corresponding entries in the response file.
Feature | Response file entry |
---|---|
Product installation directory | installLocation |
Language Pack | feature_lang_pack_rad_win32.active |
Examples for Eclipse Plug-in Development | feature_examples_win32.active |
To silently install any of the optional features:
On Windows: :# -P feature_examples_win32.active=<value>
On Linux: :# -P feature_examples_linux.active=<value>
In the Windows example, change this line to:
-P feature_examples_win32.active=true
-P feature_examples_linux.active=true
From the Linux 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.
On Windows: setup.exe -silent -options "Your_directory\myresponsefile.txt"
On Linux: ./setup.bin -silent -options "Your_directory/myresponsefile.txt"
Your_directory is the fully qualified name of the directory that contains your response file.
The following table provides several sample silent install commands:
Command | Description |
---|---|
setup.exe -options-template c:\responseFile.txt | Creates a response file template |
setup.exe -options-record c:\responseFile.txt | Creates a response file by recording user choices in an actual installation |
setup.exe -silent -options c:\responseFile.txt | Executes a silent install |
uninstall.exe -silent -options c:\responseFile.txt | Executes a silent uninstall |
Although Agent Controller is installed automatically on the local system when you install Rational Performance Tester, you can choose how to install it. You can perform a default installation or perform a custom installation, in which case you will step through the installation wizard page by page. In addition, you can install Agent Controller on remote Windows, Red Hat Linux, and SuSE Linux systems. Use the instructions in this section to perform a custom installation of Agent Controller during the Rational Performance Tester installation process or to install Agent Controller on remote systems.
When Agent Controller is installed standalone (without Rational Performance Tester), it allows remote users to launch Java programs on the machine where it is installed. Therefore, you should restrict access to Agent Controller using one of the following options:
To perform a custom installation of Agent Controller on a local Windows system where Rational Performance Tester is installed:
Before you install Agent Controller, verify that the Eclipse Platform is not running. If necessary, exit Eclipse.
By default, the Agent Controller service starts when it is installed and then whenever you start the computer. For more information about working with Agent Controller, see the online help.
See the online help for more information about working with Agent Controller.
To start Agent Controller:
where by default $RASERVER_HOME is /opt/IBM/Rational/SDP/6.0/IBM_Agent_Controller.
If Agent Controller fails to uninstall successfully, there might be Java processes that contain either the Java Profiling Agent or the J2EE Request Profiler running. You must end these processes before you can uninstall Agent Controller successfully. For more information about profiling an application, see the online help.
RAServer failed to start.
This failure usually occurs because TCP/IP port 10002 is not free. Agent Controller listens on this port by default. Another process running on the system might be using this port when Agent Controller is started, or Agent Controller might have been recently stopped and then restarted before the port could be released.
After you install the license client, which is installed as part of the Rational Performance Tester installation, the Rational License Key Administrator starts. Follow the procedures in the IBM Rational Software License Management Guide to install license keys. You can download this publication at no charge from http://www.ibm.com/shop/publications/order.
RATIONAL_LICENSE_FILE=@[SERVER]
See Putting Performance Tester assets under source control in the online help for information on the file types that comprise Rational Performance Tester assets. This information can help you use ClearCase LT or any other version control tool to manage Rational Performance Tester assets.
The installation instructions in this section are to help you install the client and server code for Rational ClearCase LT. 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.
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.
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 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 http://www.ibm.com and enter 1188585 in the Search box.
On Windows, download the latest IBM Rational ClearCase LT Release Notes for Windows, the Rational Software Desktop Products Installation Guide, and Rational Software Server Products Installation Guide for Windows from the IBM Publications Center at http://www.ibm.com/shop/publications/order, as follows:
On Linux, download the latest Rational ClearCase LT Release Notes and Rational ClearCase LT Installation Guide for Linux from the IBM Publications Center at http://www.ibm.com/shop/publications/order.
To install Rational ClearCase LT Version 2003.06.00 on Linux:
cd /usr/ccase_lt_rls/rhat_x86/clearcase/install ./site_prep
./install_release
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.
cleartool hostinfo -long
The Rational ClearCase LT license that is included with Rational Performance Tester does not include a license for the Rational ClearCase Web interface. To use the Rational ClearCase Web interface, you must purchase additional Rational ClearCase or ClearCase LT licenses. For more information on obtaining licenses, contact IBM Rational Support at 1-800-IBM-SERV (1-800-426-7378).
cleartool find . -name *.emx -exec "cleartool chtype -force xtools2 %CLEARCASE_PN%"
To uninstall Rational ClearCase LT on a Linux system:
cd /usr/ccase_lt_rls/rhat_x86/clearcase/install ./install_release