Install the product software

These instructions can be used to install Rational® Service Tester.

About this task

By starting the installation process from the launchpad program, IBM® Installation Manager is automatically installed if it is not already on your computer, and it starts preconfigured with the location of the repository that contains the product package. If you install and start IBM Installation Manager directly, then you must set repository preferences manually.

To learn how to install the product from a command prompt in silent mode, see the Installing Silently section of the IBM Installation Manager documentation at http://publib.boulder.ibm.com/infocenter/install/v1r4/index.jsp.

Important: Installation notes for the Windows® Vista operation system:
  • You must run the launchpad programs as administrator. If the launchpad program starts automatically (for example, if you are installing from a CD), stop the launchpad program and restart it by using the Run as administrator command (At the root level of the CD or disk image, right-click launchpad.exe and click Run as Administrator.)
  • Installing the products within the Program Files directory (C:\Program Files) is not recommended. If you select either an Installation Location or a Shared Resources Directory within the Program Files directory, the packages that you install must be run as administrator.

Procedure

To install from the launchpad:

  1. Review the Installation considerations, if you have not done so already.
  2. If you are installing from compressed files, such as ZIP or ISO files, extract the files into a common directory. Extract the disk images to directories named /disk1,/disk2, and so on. Extract the Setup disk image to a directory named RST_SETUP. The Setup disk contains the launchpad.
  3. If you are installing from a CD, insert the first product disc into your CD drive. If autorun is enabled on your workstation, then the launchpad will start autostart. Otherwise, start the launchpad program manually.
    • For Windows. Run launchpad.exe, located in the root directory of the Setup disk installation image.
    • For Linux. Run launchpad.sh, located in the root directory of the Setup disk installation image.
  4. Select a language in which to run the launchpad and Installation Manager. Click OK.
  5. Select the product to install from the launchpad menu. The Install Packages window opens.
  6. Click on a product package to highlight it. The description of the package is displayed in the Details pane at the bottom of the screen.
  7. To search for updates to the product packages, click Check for Other Versions and Extensions. If updates for a product package are found, then they will be displayed in the Installation Packages list on the Install Packages page below their corresponding product. Only recommended updates are displayed by default.
    • To view all updates found for the available packages, click Show all versions.
    • To display a package description under Details, click on the package name. If additional information about the package is available, such as a readme file or release notes, a More info link is included at the end of the description text. Click the link to display the additional information in a browser. To fully understand the package you are installing, review all information beforehand.
      Note: For IBM Installation Manager to search the predefined IBM update repository locations for the installed packages, the preference Search the linked repositories during installation and updates on the Repositories preference page must be selected. This preference is selected by default. Internet access is also required. A progress indicator shows the search is taking place. You can install updates at the same time that you install the base product package.
  8. Select the product package and any updates to the package that you want to install. Updates that have dependencies are automatically selected and cleared together. Click Next to continue.
    Note: If you install multiple packages at the same time, then all the packages will be installed into the same package group.
  9. On the Licenses page, read the license agreement for the selected package. If you selected more than one package to install, there might be a license agreement for each package. On the left side of the License page, click each package version to display its license agreement. The package versions that you selected to install (for example, the base package and an update) are listed under the package name.
    1. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements.
    2. Click Next to continue.
  10. On the Location page, type the path for the shared resources directory in the Shared Resources Directory field, or accept the default path. The shared resources directory contains resources that can be shared by one or more package groups. Click Next to continue.
    The default path is:
    • For Windows. C:\Program Files\IBM\IBMIMShared
    • For Linux. /opt/IBM/IBMIMShared
    Important: You can specify the shared resources directory only the first time that you install a package. Use your largest disk for this to help ensure adequate space for the shared resources of future packages. You cannot change the directory location unless you uninstall all packages.
  11. On the Location page, create a package group to install the product package into or if this is an update, use the existing package group. A package group represents a directory in which packages share resources with other packages in the same group. To create a new package group:
    1. Click Create a new package group.
    2. Type the path for the installation directory for the package group. The name for the package group is created automatically.
      The default path is:
      • For Windows. C:\Program Files\IBM\SDP
      • For Linux. /opt/IBM/SDP
    3. Click Next to continue.
  12. On the next Location page, you can choose to extend an existing Eclipse IDE already installed on your system, adding the functionality in the packages that you are installing. You must have Eclipse Version 3.4 with the latest updates from eclipse.org to select this option.
    • If you do not want to extend an existing Eclipse IDE, click Next to continue.
    • To extend an existing Eclipse IDE:
      1. Select Extend an existing Eclipse.
      2. In the Eclipse IDE field, type or navigate to the location of the folder containing the eclipse executable file (eclipse.exe or eclipse.bin). Installation Manager will check if the Eclipse IDE version is valid for the package that you are installing. The Eclipse IDE JVM field displays the Java™ Virtual Machine (JVM) for the IDE that you specified.
      3. Click Next to continue.
  13. On the Features page under Languages, select the languages for the package group. The corresponding national language translations for the user interface and documentation for the product package will be installed.
  14. On the next Features page, select the package features that you want to install.
    1. Optional: To see the dependency relationships between features, select Show Dependencies.
    2. Optional: Click a feature to view its brief description under Details.
    3. Select or clear features in the packages. Installation Manager will automatically enforce any dependencies with other features and display updated download size and disk space requirements for the installation.
    4. Optional: If you plan to collect response time breakdown data, select the IBM Rational Performance Tester Agent check box.
    5. When you are finished selecting features, click Next to continue.
  15. On the help system configuration page, select one of the following options and then click Next:
    • Access help from the Web
    • Download help and access content locally
    • Access help from a server on your intranet

    To learn more about Web-based help, see Configuring Web-based help.

  16. On the Summary page, review your choices before installing the product package. If you want to change the choices that you made on previous pages, click Back and make your changes. When you are satisfied with your installation choices, click Install to install the package. A progress indicator shows the percentage of the installation completed.
  17. When the installation process is complete, a message confirms the success of the process.
    1. Click View log file to open the installation log file for the current session in a new window. You must close the Installation Log window to continue.
    2. In the Install Package wizard, select whether you want the product to start when you exit.
    3. Click Finish to launch the selected package. The Install Package wizard closes and you are returned to the Start page of Installation Manager.
  18. If the Data Collection Infrastructure software is installed, follow these steps to enable the test server for data collection:
    1. From the Start menu, select IBM Software Delivery Platform > IBM Rational Data Collection Infrastructure > Application Server Instrumenter to open the instrumentation application.
    2. Click the Add Local button and select the type of application server that you have running on the server.
    3. Fill in the server type specific fields including the location of the server if required and click OK.
    4. Stop and start the server for the instrumentation to take effect.
    5. From the Start menu, select IBM Software Delivery Platform > IBM Rational Data Collection Infrastructure > Start Data Collection.
    Note: All Rational Performance Tester systems involved with the Data Collection Infrastructure must have the data collection software running for the transaction breakdown functionality to be available within the results of an Rational Performance Tester test schedule.
    Note: The Application Server Instrumenter or the instrumentServer.bat (or instrumentServer.sh) batch file can fail with a generic error message ("Error during install/uninstall") when instrumenting or uninstrumenting a server. If this occurs, you can find more information to help troubleshoot the error in the log files in the IBM Tivoli® common directory. On Windows, the default location of this directory is C:\Program Files\IBM\tivoli\common. On Linux®, the default location of this directory is /var/ibm/tivoli/common. If the IBM Tivoli common directory is not in the default location, search for a path containing tivoli/common, or for any of these log files: trace-install.log, trace-ma.log, or trace-tapmagent.log.
    Note: For Websphere Application Server 6.x, if you create a new profile and then use the Application Server Instrumenter to instrument this profile without first starting WebSphere® Application Server, the Application Server Instrumenter will report that the server is instrumented and will request that you re-start the server manually. This message is incorrect; the server is not actually instrumented. To work around this problem:
    1. Close and then re-start Application Server Instrumenter.
    2. Select the entry you just added from the list of instrumented servers and click Remove.
    3. Restart WebSphere Application Server.
    4. Restart Application Server Instrumenter and use it to instrument the server.
    To avoid this problem, after creating a new profile, start the WebSphere Application Server profile manually. Then, use the Application Server Instrumenter to instrument the server.
  19. License the product.

Feedback