Installing IBM Rational Performance Tester

 

Contents

About IBM Rational Performance Tester

After you install Rational Performance Tester

About IBM Rational Performance Tester

IBM Rational Performance Tester is a product that tests system performance. Rational Performance Tester supports testing of Web applications and provides major improvements in ease-of-use and scalability. It is hosted in the Eclipse Integrated Development Environment, using a Java-based execution engine.

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.

About IBM Rational Software Development Platform

The IBM Rational Software Development Platform is a common platform that contains the development workbench and other software components that are shared by multiple products.
  • Rational Software Modeler
  • Rational Web Developer
  • Rational Application Developer
  • Rational Software Architect
  • Rational Functional Tester
  • Rational Performance Tester

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.

Migration and coexistence

The following chart summarizes how each product interacts when you attempt to install another product that contains 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
  • Block: If you are prevented from installing a product , you must uninstall the previous version first. This blocking occurs when you try to install a product that offers less functionality than the currently installed product. For example, if Software Architect is installed, and you try to install Application Developer, you will be blocked from doing so.
  • Upgrade: If you install a product that adds functionality to the current product, you are upgraded to the product with more functionality. The first product is uninstalled, but both the Rational Software Development Platform and the workspace containing your work for the first product remain in the same location.
  • Shell Share: Other products share the installation of the Rational Software Development Platform. The second product extends the capabilities of an existing product without installing another copy of the Rational Software Development Platform. So, for example, if you install Performance Tester, and then you install Application Developer, they will both use the same copy of the Rational Software Development Platform, and the platform will contain all the functionality that both Performance Tester and Application Developer offer.

About uninstalling products

  • Upgraded products. When a product is upgraded, the existing product is removed and replaced. If a newly upgraded product is uninstalled, the entire product is removed from the system. For example, if you install Application Developer, upgrade to Software Architect, and then uninstall Software Architect, all plug-ins, including the development platform, are uninstalled. To replace Application Developer, you must reinstall Application Developer.
  • Shell Share products. If two or more products are installed in a shell sharing scenario, the development platform is left in place until the last product is uninstalled. For example, if Application Developer and Performance Tester are installed, and you uninstall Application Developer, Performance Tester (and the development platform) remain on the system.

Starting products that share the Rational Software Development Platform

When you go to the Start menu (or the equivalent menu for Linux), the top-level menu is always IBM Rational, regardless of which product you have installed.

One subfolder for each product is available from the top-level menu. These subfolders contain links to product-specific information (such as readme files), and a launchpoint for the Rational Software Development Platform. The launchpoint has the name of the product.

You can also start the common development platform directly from the IBM Rational menu using a launchpoint labeled Rational Software Development Platform.

Before you install Rational Performance Tester

Before you install Rational Performance Tester, use the information in this section to perform preliminary tasks.

System requirements

The following tables list supported platform and system requirements for CPU, RAM, disk space, network interface, and display. System requirements are the same for Performance Tester and Agent Controller. See the Release Notes for the latest updates.
Table 1. Supported platforms for Rational Performance Tester
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
Table 2. System requirements for Rational Performance Tester
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
Note: Installing Performance Tester on a system with less than 768 MB of RAM can result in poor performance and application crashes.

Obtaining license keys

You do not need a license key to install Rational Performance Tester. However, you do need license keys if you plan to emulate a load of more than five concurrent virtual users. For example, you can run Performance Tester with four virtual users and no license key (on a trial basis, for example), but if you choose to run ten virtual users, you must purchase a virtual tester license key pack supporting 5 or more additional virtual users. License keys are sold in groups called virtual tester license key packs. These packs come in groups of 5, 50, 100, 250, 500, 1000, 2500, 5000, 10,000, 20,000, 50,000, and 100,000 virtual testers.

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:

  • List of product components
  • License key type required for each component (for example, the driver components require floating licenses.)
  • The product account number
  • Instructions for obtaining the license key for each component

You can use either that document or the Proof of Entitlement certificate to obtain license keys from IBM.

To obtain license keys:

  1. Go to http://www.ibm.com/rational/support/licensing..
  2. Click Rational Licensing and Download Center.
  3. Register with IBM Web Management (IWM) and click Request and Manage License Keys.
  4. Follow the instructions, using the information in the Important Licensing and Installation Information document or the Proof of Entitlement certificate to obtain license keys. License keys will be sent to you in a file with a .upd file extension.

Licensing requirements

You use license keys to authenticate with a Rational License Server. If you use other Rational products, you probably have access to a license server. If you do not, follow the procedures in the IBM Rational Software License Management Guide to set up a license server. You can download this publication at no charge from http://www.ibm.com/shop/publications/order.

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.

Other preinstallation considerations

This section describes additional steps you may need to perform before installing the product.

Upgrading from a beta version

If a beta copy of Rational Performance Tester is installed on the system, you must completely uninstall the beta version before installing this version. You cannot install the new version of the product over the beta version. Data created in the workspace with a beta version might not be usable in a full-release version of the product.

For information on uninstalling the product, see the appropriate uninstallation procedures in this document.

Upgrading from a trial version

You can install a current version of Rational Performance Tester directly over a trial version of the product. All data in the workspace is preserved.

Uninstalling previous versions of Agent Controller

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 Rational Performance Tester. See Uninstalling Agent Controller on Windows and Uninstalling Agent Controller on Linux for details.

Installing from an undisclosed network location

You cannot install Rational Performance Tester from an undisclosed network location using UNC path names. If you plan to install Performance Tester from a location on the network, you must map the network location to a drive on the local system.

Installing and uninstalling Rational Performance Tester

This section contains information about installing Rational Performance Tester. You can install Performance Tester either from CD-ROM or from electronic images that you download. An installation wizard is provided, but you can also install Performance Tester 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 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

Installing Rational Performance Tester from the CD-ROM

To install Rational Performance Tester on a Windows or Linux system:
  1. On Windows, log in as Administrator. On Linux, log in as root.
  2. Insert the Performance Tester CD in the CD-ROM drive. On Windows, the launchpad application starts if Autorun is enabled. On Linux, you must start the launchpad.bin file from the root directory of the CD-ROM.
  3. On the launchpad, click Install IBM Rational Performance Tester. The installation wizard opens the Welcome page. Click Next when you are ready to proceed.
  4. Review the license agreement. If you agree to the terms, click I accept the terms of the agreement and click Next.
  5. Specify the directory where you want to install the local components. It is recommended that you accept the default directory location. Click Next.
  6. On the Features page, select the features you want to install.
    • Language Pack: Installs support for languages other than English.
    • Examples for Eclipse Plug-In Development: Installs samples of Eclipse Plug-In implementations.

    Click Next when you are ready to proceed.

  7. Specify either the typical (default) or custom installation of Agent Controller. Click Next.
  8. On Windows, indicate whether you want the License Key Administrator to start automatically at the end of the installation process. Click Next.
    Note: To start the License Key Administrator manually, click Start > All Programs > Rational Software > Rational License Key Administrator
  9. On the Summary page, review the options you have selected. When you are ready to begin the installation, click Next.
  10. When the installation is complete, click Finish to exit the wizard. Unless you selected the custom installation of Agent Controller, you return to the launchpad. To exit the launchpad, click Exit.
  11. After exiting from the launchpad, start Rational Performance Tester and adjust the Java Virtual Machine heap size.
    1. Click Window > Preferences.
    2. Expand Test.
    3. Click Performance Test Workbench.
    4. In Java Virtual Machine heap size, type the memory size recommended on the screen.
    5. Click OK.

Installing from electronic images

Before you install the product, verify that you have sufficient space.
  • You must have approximately 1.5 GB of disk space to store the full set of downloadable images.
  • On Windows, your environment variable TEMP or TMP must point to a valid temporary directory with at least 500 MB free.
  • On Linux, you need at least 500 MB free space in /tmp.

To download and create the electronic installation image:

  1. 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 before attempting the installation.
    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 download and extract the Language Pack into the new product installation image.
  2. Start the extractor wizard.
    • On Windows, launch the extractor.exe file located in your temporary directory. This starts the wizard that creates the installation image.
    • On Linux, modify the permissions on the extractor.bin file that is located in this temporary directory by typing chmod +x extractor.bin. Then, execute the file by typing ./extractor.bin.
  3. Follow the instructions in the wizard to specify where you want to create the image and which features you want to include.
  4. After the image is created, decide when to install the product.
    • To install the product immediately, click Finish.
    • To install the product later, clear the Start the installation wizard check box. When you are ready to run the installation program, launch disk1\launchpad.exe from the directory where you created the installation image.
  5. Follow the instructions described in Installing Rational Performance Tester from the CD-ROM.

Creating a network installation image

You can place a copy of the installation image on a network drive so that users can install across a network.

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:

  1. For a Windows installation, create a temporary directory on a network drive where you want to store the image (for example, network_drive:\install_image).
  2. Insert the Rational Performance Tester installation CD for Windows into your CD drive.
  3. Under the temporary directory, create a subdirectory called disk1. This subdirectory must be called disk1 and it must be lowercase.
  4. Copy all the files and directories on the installation CD to the disk1 subdirectory in the temporary directory.
  5. Repeat steps 3 and 4 to copy the contents of the Linux and Agent CDs to their own subdirectories. (On Linux, be sure to log in as root.)
Note:
  • If you map to a network drive without specifying a device name (for example, \\computername\sharename), you might get the following message when you try to install Performance Tester:
    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).

  • If your machine goes into standby mode during an installation from a network installation image, the installation might fail.

Invoking a silent installation

If you do not want to interact with the installation wizard, you can run the Rational Performance Tester installation program silently.

Setting up your local images

Before silently installing Rational Performance Tester, you must set up your local images:
  1. Ensure that the user ID that you are using does not contain double-byte characters.
  2. Create a local or network installation image as described in Creating a network installation image.

Silently installing the default features to the default directory

The following features are installed by default when silently installing Rational Performance Tester:
  • Integrated Development Environment
  • Agent Controller
  • Common Licensing (if it is not already installed)

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:

  1. Copy your images as described in Creating a network installation image, if you have not done so already.
  2. From the command line, change to the \disk1\setup directory in the temporary directory that you created in a previous section (for example, network_drive:\install_image\disk1\setup on Windows or /tmp/install_image/disk1/setup on Linux) .
  3. Run the appropriate command:
    • On Windows: setup.exe -silent
    • On Linux: ./setup.bin -silent
  4. Silently installing Performance Tester can take a while to complete. To determine when the installation is complete, check the \logs directory in the default installation directory. When you see the license.log file, the silent installation is complete.

Silently installing to a different directory

By changing the installLocation parameter, you can install Rational Performance Tester to a different directory.

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.)

Silently installing additional features

Rational Performance Tester 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 (/disk/util on Linux). To change the response file to install other features, first make a backup copy of responsefile.txt.

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.

Table 3. List of response file options
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:

  1. Copy responsefile.txt to a new file, such as myresponsefile.txt.
  2. Edit your copy of the response file.
  3. Locate the line containing the feature name shown in the preceding table. For example, to install the examples for Eclipse plug-in development, locate the appropriate line in the response file:

    On Windows: :# -P feature_examples_win32.active=<value>

    On Linux: :# -P feature_examples_linux.active=<value>

  4. Make the following changes to this line:
    • Remove the # in the first column.
    • Change  <value> to true.

    In the Windows example, change this line to:

    -P feature_examples_win32.active=true
    In the Linux example, change this line to:
    -P feature_examples_linux.active=true
  5. Save your changes.
  6. On Linux, log in as root.
  7. Copy your images as described in Setting up your local images if you have not done so already.
  8. From the Windows 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.

    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.

  9. When you run the response file, add the -options parameter and the fully qualified name of your response file as shown below:

    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.

    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.
  10. Silently installing Rational Performance Tester can take a while to complete. To determine when the installation is complete, check the \logs subdirectory in your installation directory. When you see the license.log file, the silent installation is complete.

The following table provides several sample silent install commands:

Table 4. 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

Uninstalling on Windows

To uninstall Rational Performance Tester on a Windows system:
  1. Click File > Control Panel > Add or Remove Programs.
  2. Select the application you want to uninstall from the list and click Change/Remove.
  3. Follow the instructions in the uninstall wizard.

Uninstalling on Linux

To uninstall Rational Performance Tester on a Linux system:
  1. Log in as root.
  2. Change directory to install_dir/rpt_prod/_unist.
  3. Run uninstall.bin.

Installing Agent Controller

Agent Controller is a daemon that allows client applications to launch and manage local or remote applications. It also provides information about running applications to other applications. Agent Controller is required by Rational Performance Tester and must be running on the local system where Rational Performance Tester is installed.

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:

Note:
  • When Rational Performance Tester is installed, Agent Controller is automatically installed and configured to allow connections only from the local host. Therefore, the two options recommended above for standalone Agent Controller security are not required on machines where the default Rational Performance Tester installation is done.
  • The online documentation for Agent Controller is installed after the software is installed. At that time, the documentation is added to the online help for Rational Performance Tester.
  • For more information on the security implications of using Agent Controller, refer to the Agent Controller documentation that comes with Rational Performance Tester.

Installing Agent Controller on a local Windows system

Agent Controller is installed automatically after Rational Performance Tester is installed.

To perform a custom installation of Agent Controller on a local Windows system where Rational Performance Tester is installed:

  1. Specify the custom Agent Controller installation when installing Rational Performance Tester.
  2. When the Agent Controller Welcome screen opens, click Next.
  3. Ignore any warnings about checking to make sure that the Eclipse platform is not running. Click Next to continue.
  4. Read and accept the license agreement and click Next to proceed.
  5. If you have an existing installation of Agent Controller, you are informed that it will be removed. Click Next to proceed.
  6. Specify the path where Agent Controller should be installed and click Next to proceed.
  7. Select Agent Controller features you would like to install and click Next to proceed. You should accept the default, which selects all features.
    • Hyades Data Collection Engine: Framework provided by the Eclipse open source project for launching and profiling local or remote Java applications. Required.
    • 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. Required.
    • Component Test: Legacy support for manual test enablement. Required.
    • Runtime Analysis: Functionality for probe insertion, code coverage, and leak analysis. Required.
    • Security: Creates a secure data communication channel between the Eclipse workbench and Agent Controller. Recommended.
    • 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. Not used by Rational Performance Tester.
  8. Specify the path of the Java run-time environment (JRE) that Agent Controller should be using and click Next to proceed. Rational Performance Tester requires JRE versions 1.4.2 or later. This requirement is met when installing from the Rational Performance Tester installation media and should not be changed. The JRE entered here will be used by Agent Controller for launching Java applications.
  9. If Remote Support for WebSphere Application Server was selected in step 7, specify the paths of IBM WebSphere Application Server version 5.0 and 5.1 and then click Next . Because Rational Performance Tester does not use these features, you can leave this page blank.
  10. Specify which hosts can access Agent Controller and then click Next . This setting affects system security. The choices are:
    • Any computer: The least secure setting. Any other machine with access to this machine can execute an arbitrary program that runs with administrator/root privilege.
    • This computer only (default) : The most secure setting. This is the recommended setting.
    • Specific computers: Not recommended, but if you use this feature be sure to use commas to separate host names in a list.
  11. If Security was selected in step 7, choose one of the following security settings and then click Next to proceed.
    • Disable: Communication will not be encrypted and access control will be limited to the defined host list. (Default selection.)
    • Enable: Communication will be encrypted and all connections will be forced to authenticate for Secure Sockets Communications. Under Users, list the users that can connect to Agent Controller. (Use commas to separate user names.) These users will be required to authenticate to use the tool.
  12. Click Next on the summary screen to proceed.
  13. Click Finish after file transfer has completed.

Installing Agent Controller on a remote Windows agent

You might want to install Agent Controller on remote computers for any of these reasons:
  • You want to run virtual users on the remote computer.
  • The local computer lacks sufficient resources to host all of the virtual testers that you want to use in a test.
  • The testing you want to perform requires specific software, which is not installed on the local computer.
Note: For security reasons, it is highly recommended that you do not use a system with Rational Performance Tester installed as a remote agent.

Before you install Agent Controller, verify that the Eclipse Platform is not running. If necessary, exit Eclipse.

  1. Insert the installation CD into a CD-ROM drive on a remote Windows system that does not have Rational Performance Tester installed.
    Note: You must install Agent Controller using the installation CD and not from another system where Agent Controller is already installed.
  2. Log in as an Administrator. Because Agent Controller runs as a system service, you should use a user ID with administrator privileges to install Agent Controller. Otherwise, the Agent Controller service might fail to install or start.
  3. If autorun is disabled, run launchpad.exe from the root of the first installation CD.
  4. From the launchpad, select Install Rational Performance Tester Agent Controller. Follow the wizard instructions.
Important: On the Java Runtime Environment page, the location of the Java run-time file (java.exe) is specified. This field contains the default location of the Java run-time file included with Agent Controller. Unless your system administrator instructs you to specify a different location, do not change this field as it might cause Agent Controller to malfunction. Do not change other default values in the wizard unless instructed to by your system administrator.
Note: These are the options on the Host Access Settings page:
  • This computer only: Do not select. This renders the remote agent inaccessible.
  • Any computer (default): Any other machine can use this agent. It may cause a security exposure depending on your environment.
  • Specific computers: Best choice. It can protect the machine from malicious attack, but it increases administrative overhead in a fluid environment. (Use commas to separate host names.)

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.

Installing Agent Controller on Linux

To install or upgrade Agent Controller:
  1. Log in as root.
  2. Navigate to the root directory of the CD-ROM and start launchpad.bin.
Important: The Specify where the Java Runtime file (java.exe) is located field contains the default location of the Java run-time file included with Agent Controller. Unless your system administrator instructs you to specify a different location, do not change this field as it might cause Agent Controller to malfunction. Do not change other default values in the wizard unless instructed to by your system administrator.

See the online help for more information about working with Agent Controller.

Starting Agent Controller on Linux

On Linux platforms, the Agent Controller process (RAServer) does not start automatically. You must start it yourself.

To start Agent Controller:

  1. Change directory to $RASERVER_HOME/bin.

    where by default $RASERVER_HOME is /opt/IBM/Rational/SDP/6.0/IBM_Agent_Controller.

  2. Type ./RAStart.sh.

Uninstalling Agent Controller on Windows

To uninstall Agent Controller, follow these steps:
  1. Close Rational Performance Tester.
  2. Open the Control Panel and choose Add/Remove Programs.
  3. Select Agent Controller and click Change/Remove to uninstall.

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.

Uninstalling Agent Controller on Linux

To uninstall Agent Controller on a Linux system:
  1. Close Rational Performance Tester.
  2. Log in as root.
  3. In the root directory, navigate to the _uninst.bin file.
  4. Run _uninst.bin.

Using the Agent Controller security feature

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 are allowed to authenticate. If the user name ANY is provided, any valid user name and password pairs are forwarded to the operation system for authentication. Otherwise, only listed pairs are forwarded.
  • When security is enabled, the users 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.
  • Domain name passwords are not authenticated. You must provide local user name and password pairs. (Windows only)
  • No key management capabilities are provided. Agent Controller uses Java keystores for security.
  • A sample 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. Replace these with a keystore containing meaningful certificates.

Known problems and limitations

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 might fail to start on non-Windows platforms

Agent Controller might fail to start on non-Windows platforms, as indicated by the following message:
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.

If Agent Controller did not start, you can start it as follows:
  • If port 10002 is being used by another process, 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, 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 recently stopped, wait a few minutes and try to start it again.

Other errors during installation and uninstallation

Some errors occur during installation or uninstallation, because the object files of Agent Controller are loaded by running processes. To ensure that the object files can be modified, do the following:
  1. Shut down Rational Performance Tester.
  2. End all java.exe processes that contain either the Java Profiling Agent or the J2EE Request Profiler.

After you install Rational Performance Tester

After you install the product, use the information in this section to perform optional tasks.

Installing license keys

You must install license keys to run more than five virtual users. This section tells you how to do this.

Installing license keys on Windows

To install license keys on Windows, you must have access to a license server and a license client. If you do not, see Licensing requirements for information about installing a server.

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.

Installing the Rational license client manually
If you are running other products on Windows that use Rational Licensing, it is possible to mistakenly uninstall the Rational License Client. If this occurs, you will be instructed to install the client manually. To do this, click Install Rational License Client from the launchpad. See the IBM Rational Software License Management Guide for more information on installing the Rational License Client.

Installing license keys on Linux

To install license keys on a Linux client, create the file$HOME/.flexlmrc containing a line with the computer name or the IP address of the Rational license server. The .flexlmrc file must be created in the home directory of every user on the target system who is expected to run more than five virtual users. For example, the .flexlmrc file could contain
RATIONAL_LICENSE_FILE=@[SERVER]

Installing Rational ClearCase LT

Rational ClearCase LT is a configuration management tool for small project teams. ClearCase LT is part of the IBM Rational ClearCase product family and can scale from small project workgroups to the distributed, global enterprise.

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.

Downloading Rational ClearCase LT

The 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 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.

Locating the release notes and installation instructions

Before installing Rational ClearCase LT, read the release notes and installation documentation for the product. This documentation is available online from the IBM Publications Center at http://www.ibm.com/shop/publications/order. Also refer to http://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 http://www.adobe.com/products/acrobat/readstep2.html.

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:

  1. Select your country/region on the Welcome page of the Publications Center.
  2. Click on the Search for Publications link. The Quick Publications Center search page opens.
  3. To download the Rational Software Desktop Products Installation Guide for Windows, Version 2003.06.13:
    1. Type S126-5304-01 in the Publication number field and press Enter.
    2. On the resulting page, choose your preferred method of downloading the document.
  4. To download the Rational Software Server Products Installation Guide for Windows, Version 2003.06.13:
    1. Type S126-5300-01 in the Publication number field and press Enter.
    2. On the resulting page, choose your preferred method of downloading the document.
  5. To download the Rational ClearCase LT Release Notes for Windows:
    1. Type GI11-4669-03 in the "Publication number" field and press Enter.
    2. On the resulting page, choose your preferred method of downloading the document.

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.

  1. Select your country/region on the Welcome page of the Publications Center.
  2. Click on the Search for Publications link. The Quick Publications Center search page opens.
  3. To download the ClearCase LT Installation Guide for Version 2003.06.00 and later, UNIX edition:
    1. Type S126-5310-00 in the Publication number field and press Enter.
    2. On the resulting page, choose your preferred method of downloading the document.
  4. To download the Rational ClearCase LT Release Notes for UNIX:
    1. Type GI11-6232-00 in the Publication number field and press Enter.
    2. On the resulting page, choose your preferred method of downloading the document.

Installing Rational ClearCase LT on Windows

Refer to the ClearCase LT Desktop Installation Guide for details on preparing to install the product.
  1. From the root directory of the installation image, run setup.exe. The Rational Setup Wizard will open. Click Next to continue.
  2. On the Product Selection screen, choose Rational ClearCase LT. Click Next to continue.
  3. Choose a deployment method:
    • Enterprise deployment (create a network release area and customize it using Siteprep).
    • Desktop Installation from CD image. (Refer to the Desktop Installation Guide to learn about selecting a deployment type.)
  4. 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.
  5. 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.
    • The next screen displays the message There are some product-specific warnings for this installation: STOP! Before proceeding with this install, please close all applications and disable anti-virus software. Before continuing with the installation, go to the Web address provided in the warning message (http://ibm.com/support/docview.wss?rs=203&context=SW000&q1=1135295&uid=swg21135295 ). Read the document and take any steps required to prevent potential system corruption. Click Next to continue.
  6. 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.
  7. Select Install to begin the installation.

Installing Rational ClearCase LT on Linux

By default, Red Hat Enterprise Linux 3.0 and SuSE Linux Enterprise Server (SLES) Version 9, set the locale for US installations to a Unicode locale (en_US.UTF-8), and might also do so for international installations. ClearCase LT does not support Unicode locales. Therefore, you must explicitly set your locale to a non-Unicode setting. You can change the locale as follows:
  • For Red Hat Enterprise Linux 3.0, 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, turn off UTF-8 encoding as follows:
    1. Launch the YaST Control Center. (For example, from the SuSE icon in the bottom corner of the screen, select SuSE > System > YaST.)
    2. In YaST, select System.
    3. Select Choose Language.
    4. Click the Details button.
    5. Clear the Use UTF-8 encoding field and then click OK.
    6. Click Accept.
    7. Log out, then log back in.

To install Rational ClearCase LT Version 2003.06.00 on Linux:

  1. Log in as root user by typing: su
  2. From the directory where you downloaded Rational ClearCase LT, extract the contents of the ClearCase LT download file to a release area as follows:
    1. Enter mkdir /usr/ccase_lt_rls to create the release area directory. 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.
    2. Enter 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.
    3. 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 Installation Guide before continuing the installation process. For an explanation of the purpose of a release area, see the Installation Guide.
  3. Prepare your release area by running site_prep and follow the instructions:

    cd /usr/ccase_lt_rls/rhat_x86/clearcase/install ./site_prep

  4. Enter the values for the prompts 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.
  5. Install ClearCase by running install_release and follow the instructions:

    ./install_release

    Enter the values for the prompts per your requirements. The following is an example for a ClearCase LT Client installation on SuSE Linux Enterprise Server (SLES) Version 9:
    1. Choose Local Install.
    2. Accept the license agreement.
    3. Choose Standard install.
    4. Choose 3. ClearCase LT Client installation.
    5. When the install_release program ends, it displays a message saying 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.
  6. Add the ClearCase executable file 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.

  7. If you have not already installed Rational Performance Tester, do so now.
  8. 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

  9. 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, including the files for the uninstall program. If you delete this directory, you will not be able to run the uninstall program.

Configuring Rational ClearCase LT licensing

When you have Rational Performance Tester 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 Performance Tester, 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 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).

Using Rational ClearCase with Rational Performance Tester

For information on using Rational ClearCase, refer to the ClearCase online help.

Correcting pre-existing diagram element types

If diagram files have been checked into Versioned Object Bases (VOBs) in your ClearCase environment before 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%"

Uninstalling Rational ClearCase LT

To uninstall Rational ClearCase LT on a Windows system:
  1. Close Rational Performance Tester.
  2. Open the Control Panel, then open the Add/Remove Programs window. Select Rational ClearCase LT and click Change/Remove to uninstall.
  3. Follow the instructions in the wizard to uninstall the product.

To uninstall Rational ClearCase LT on a Linux system:

  1. Log in as root user by typing: su
  2. 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

  3. Select Local Deinstall to remove software from the local computer.

 

Notices
Terms of use | Feedback
(C) Copyright IBM Corporation 2005. All Rights Reserved.