IBM Rational Service Tester for SOA Quality, Version 8.2.1
Installation Guide
Note
Before using this information and the product it supports, read
the information in Notices.
First edition, November 2011
This edition applies to IBM Rational Service Tester for SOA Quality Version 8.2.1, and to
all subsequent releases and modifications until otherwise indicated
in new editions.
Copyright International Business Machines Corporation 2000, 2011.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Installing Rational Service Tester for
SOA Quality
This installation guide provides instructions for installing,
updating, and uninstalling IBM® Rational® Service Tester for SOA Quality.
Note:
Before installing, you should consult the IBM Rational Service Tester for SOA Quality
Release Notes for late-breaking installation issues.
Product Overview
One product is covered by this installation guide, the IBM Rational Service Tester for SOA Quality.
- If you are installing Rational Service Tester for
SOA Quality for the first time, you must have two IBM Installation Manager for
the Rational Software Delivery
Platform repositories defined and selected: one for Rational Service Tester for
SOA Quality version 8.2, and another one for Rational Service Tester for
SOA Quality version 8.2.1. You can then perform a full install. This
results in a computer with the latest version of Rational Service Tester for
SOA Quality workbench.
- If you are updating computers that have the Rational Service Tester for
SOA Quality version 8.2 currently installed, use the Update function of IBM Installation Manager (using the Rational Service Tester for
SOA Quality 8.2.1 repository) to upgrade to the Rational Service Tester for
SOA Quality version 8.2.1. This results in a computer with the latest
version of Rational Service Tester for
SOA Quality workbench.
Installation overview
Installation conventions and terminology
Understanding these terms and conventions can help you
take full advantage of the installation information and your product.
The following conventions are used in this
installation information:
- The default installation directory is written as C:\installation_directory\product\inst.file.
- The default log location for installation information is C:\log_file_dir\log.txt.
These
terms are used in the installation topics.
- Installation directory
- The location of product artifacts after the package is installed.
- Package
- An installable unit of a software product. Software product packages
are separately installable units that can operate independently from
other packages of that software product.
- Package group
- A package group is a directory in which different product packages
share resources with other packages in the same group. When you install
a package using Installation Manager, you can create a new package
group or install the packages into an existing package group. Eclipse-based
packages installed in the same package group are able to use the shell-sharing
features of Eclipse. Some packages cannot share a package group, in
which case the option to use an existing package group is unavailable.
- Repository
- A storage area for installable software packages. A repository
can be disc media, a folder on a local hard disk, or a server or web
location.
- Shared directory
- In some instances, product packages can share resources. These
resources are located in a directory that the packages share.
Planning the installation
Read all the topics in this section before you begin to install
or update any of the features of your product. Effective planning and an understanding
of the key aspects of the installation process can help ensure a successful
installation.
Installation Manager overview
IBM Installation Manager is a program for installing,
updating, and modifying packages. It helps you to manage the IBM applications,
or packages, that it installs on your computer. Installation Manager
also helps you to keep track of what you have installed, determine
what is available for you to install, and to organize installation
directories.
Installation Manager provides features that help you keep packages
up to date, modify packages, manage the licenses for your packages,
and uninstall packages.
Installation Manager includes six wizards that make it easy to
maintain packages:
- The Install wizard walks you through the
installation process. You can install a package by simply accepting
the defaults or you can modify the default settings to create a custom
installation. Before you install, you get a complete summary of your
selections throughout the wizard. Using the wizard you can install
one or more packages at one time.
- The Update wizard searches for available
updates to packages that you have installed. An update might be a
released fix, a new feature, or a new version of the product. Details
of the contents of the update are provided in the wizard. You can
choose whether to apply an update. The Update wizard
searches connected repositories for updates. If you are not connected
to the Internet, you may not see newly available updates for your
installed products. To apply an update to a computer that is not connected
to the Internet, you must download the update and extract it to a
local repository.
- The Modify wizard helps you modify certain
elements of a package that you have already installed. During the
first installation of the package, you select the features that you
want to install. Later, if you require other features, you can use
the modify packages wizard to add them to your package. You can also
remove features and add or remove languages.
- The Manage Licenses wizard helps you set
up the licenses for your packages. Use this wizard to change your
trial license to a full license, to set up your servers for floating
licenses, and to select which type of license to use for each package. Rational Performance Tester requires
runtime floating license keys to run tests with multiple virtual users
and to use product extensions such as protocols. Runtime floating
license keys are not managed using IBM Installation Manager.
Use the License Key Administrator program, installed with the Rational
License Server, to manage runtime floating license keys.
- The Roll Back wizard helps you to revert
to a previous version of a package.
- The Uninstall wizard removes a package from
your computer. You can uninstall more than one package at a time.
Installation requirements
Installation requires the correct hardware, software, server
environment, operating systems, and user privileges for installing
and running your software.
For the most up-to-date, detailed system requirements, see http://www.ibm.com/software/awdtools/tester/service/sysreq/index.html for Rational Service Tester for
SOA Quality.
Hardware requirements
Before you can install the product, verify that your system
meets the minimum hardware requirements.
Hardware |
Requirements |
Processor |
Minimum: 1.5 GHz Intel Pentium 4 (or higher for best results). For
best results with large test runs, use a 2 GHz or higher Intel Pentium
dual-core processor. |
Memory |
Minimum: 1 GB of RAM. For best results with large test
runs, use 2 GB of RAM. |
Disk space |
Minimum: 1.5 GB of disk space for product package installation.
Additional disk space for the resources that you develop.
Note:
- Disk space requirements can be reduced or increased depending
on the features that you install.
- Additional disk space is required if you download the product
package to install this product.
-
Additional disk space is required if you use
FAT32 instead of NTFS.
-
An additional 500 MB of disk space is required
in the directory that you specify in the environment variable TEMP.
-
An additional 500 MB of disk space is required
in the /tmp directory.
- Large test runs can store several gigabytes of data. Make sure
that you have adequate disk space before attempting a large test run.
|
Display |
1024 x 768 resolution minimum using 256 Colors or higher
for best results |
Other hardware |
Microsoft mouse or compatible
pointing device |
Software requirements
Before you install the product, verify that your system
meets the software requirements.
Operating system
The following operating
systems are supported for Rational Service Tester version
8.2.
- Red Hat Desktop 4 updates 1 through 8 (on Intel platforms)
- Red Hat Enterprise Linux 4
updates 1 through 8 (on Intel platforms)
- Red Hat Enterprise Linux 5
update 2 (on Intel platforms)
- SuSE Linux Enterprise Server
Version 9.0 SP1 to SP4 (on Intel platforms)
- SuSE Linux Enterprise Desktop
/ Enterprise Server Version 10.0 to SP2 (on Intel platforms)
- Microsoft Windows Server 2003 Enterprise/Standard Edition
with Service Pack 1, 2, or 3
- Microsoft Windows Server 2008
- Microsoft Windows Server 2008 R2 Enterprise Edition
- Microsoft Windows XP with Service Pack 1, 2 or 3, includes
64-bit version running in 32-bit mode
- Microsoft Windows Vista SP1
- Microsoft Windows 7
Note:
- The listed operating systems support all of the languages that
are supported by Rational Service Tester for
SOA Quality.
- The 64-bit versions of Red Hat Desktop, Red Hat Enterprise Linux, Microsoft Windows Server
2003, Microsoft Windows Server 2008, and Microsoft Windows XP are supported, but run only in
32-bit mode.
Software requirements for extending an installed Eclipse
IDE
The products in this version of the IBM Rational Software Delivery Platform were
developed for use with version 3.6, or later, of the Eclipse integrated
development environment (IDE). You can only extend an existing Eclipse IDE of
version 3.6 with latest updates from eclipse.org.
To extend
an installed Eclipse IDE, you also require a Java runtime environment from one of these Java development kits:
-
IBM 32-bit
SDK for Windows, Java 2 Technology Edition, Version 6.0 service
release 2; Sun Java 2 Standard
Edition 6.0 Update 2 for Microsoft Windows
-
IBM 32-bit
SDK for Linux on Intel architecture, Java 2 Technology Edition, Version 6.0 service
release 6; Sun Java 2 Standard
Edition 6.0 Update 6 for Linux x86
(not supported for SUSE Linux Enterprise
Server [SLES] Version 9)
Note:
You might need to update your Eclipse version in order
to install updates to Rational Service Tester for
SOA Quality.
Refer to the release documentation of the update for information on
changes to the prerequisite Eclipse version.
Additional software requirements
-
The GNU Image Manipulation Program Toolkit (GTK+),
Version 2.2.1 or later, and associated libraries (GLib, Pango).
- One of the following web browsers to view the readme files and
the installation guide and to support the Standard Widget Toolkit
(SWT) browser widget:
- The Launchpad does not support Mozilla 1.6; if your browser is
Mozilla, you need version 1.7, or later, to run the launchpad.
- To view multimedia user assistance, such as tours, tutorials,
and demonstration viewlets, you must install Adobe Flash Player.
-
Adobe Flash
Player Version 6.0 release 65 or later
-
Adobe Flash
Player Version 6.0 release 69 or later
User privileges requirements
You must have a user ID that meets the following requirements
to install Rational Service Tester.
- Your user ID must not contain double-byte characters.
-
You must have a user ID that belongs to the
Administrators group.
-
You must be able to log in as root.
Installation considerations
Part of planning entails making decisions about installation locations,
working with other applications, extending Eclipse, upgrading, migrating,
and configuring help content.
Installation locations
IBM Installation
Manager retrieves product packages from specified repositories and installs
the products into selected locations, referred to as package groups.
Package groups
During installation,
you specify a
package group into which to install a product.
- A package group represents a directory in which products share resources.
- When you install a product using the Installation Manager, you either
create a package group or install the product into an existing package group.
A new package group is assigned a name automatically; however, you choose
the installation directory for the package group.
- After you create a package group you cannot change the installation directory.
The installation directory contains files and resources shared by the products
installed into that package group.
- Product resources designed to be shared with other packages are installed
in the shared resources directory. Not all products can share a package group,
in which case the option to use an existing package group will be disabled.
- When you install multiple products at the same time, all products are
installed into the same package group.
Important:
When installing products on the Windows Vista
operating system, do not create package groups in the Program Files directory
(C:\Program Files\). Otherwise, users without Administrator privileges will
be unable to use the product.
Shared resources directory
The
shared resources
directory is where product resources are installed so that they can
be used by multiple product package groups. You define the shared resources
directory the first time that you install the first product package. For best
results, use your largest disk drive for shared resources directories. You
cannot change the directory location unless you uninstall all product packages.
Important:
When installing products on the Windows Vista operating system, do not
create the shared resources directory in the Program Files directory (C:\Program
Files\). Otherwise, users without Administrator privileges will be unable
to use the product.
Coexistence
Some products are designed to coexist and share functions when
they are installed in the same package group. A package group is a location
where you can install one or more software product packages.
Offering coexistence considerations
When you install each product package, you select whether you want to
install the product package into an existing package group or whether you
want to create a new package group. IBM Installation Manager blocks products
that are not designed to share or do not meet version compatibility and other
requirements. If you want to install more than one product at a time, the
products must be able to share a package group.
Any number of eligible products can be installed to a package group. When
a product is installed, the product functions are shared with all of the other
products in the package group. If you install a development product and a
testing product into one package group, when you start either of the products,
you have both the development and testing functions available to you in your
user interface. If you add a product with modeling tools, all of the products
in the package group will have the development, testing, and modeling functionality
available.
Upgrade and coexistence information
You cannot install the latest version of the product into
an existing installation of the same product from the previous major
release. If you have the IBM Rational License Key Administrator installed,
you should save its settings before attempting to install the latest
version of the product.
If you install Rational Performance Tester and Rational Service Tester into the same package group, you must install the same
versions of both products. If you install into an existing instance
of Eclipse, or if you install in the same package group as another
product other than Rational Service Tester, streamlined Eclipse mode is not available. Only Full
Eclipse mode is available.
The current version of the product includes an updated version
of the IBM Rational License Key Administrator (LKAD). The Installation
Manager uninstalls any existing version of LKAD before installing
the new version of LKAD, and LKAD settings are not preserved. Before
you install the product, back up your LKAD settings. Start the LKAD
by clicking Start > Programs > IBM Rational > Rational License Key
Administrator. The LKAD main window and
wizard page open simultaneously. Click Settings to find the product settings. If you are comfortable editing the
Windows Registry, you can back up and then restore the following Registry
branches to back up your LKAD settings: HKEY_LOCAL_MACHINE\SOFTWARE\Rational
Software\Licensing and HKEY_CURRENT_USER\Software\Rational
Software\Licensing. For more information, see the LKAD help.
If you have the Rational License Server or Rational License Client
installed, do not uninstall those packages. Uninstalling Rational
License Server or Rational License Client might disable some of the
Rational products on your computer or on other computers.
Installing with your Eclipse instance
The product package that you install using IBM Installation Manager comes with a version
of Eclipse, which is the base platform of this product package. If you already
have Eclipse installed on your workstation, you can add your product package
directly to that Eclipse installation and extend the functions of the Eclipse
integrated development environment (IDE).
Extending an Eclipse IDE
adds the functions of the newly installed product, but maintains your IDE
preferences and settings. Previously installed plug-ins are also still available.
In most cases, your current Eclipse IDE must be the same version as the
Eclipse that the product you are installing uses. Installation Manager checks
that the Eclipse instance that you specify meets the requirements for the
installation package and helps you install the latest updates from eclipse.org,
if necessary.
Important:
When installing products on the Windows Vista
operating system, do not install Eclipse in the Program Files directory (C:\Program
Files\). Otherwise, users without Administrator privileges will be unable
to use the product.
Extending an existing Eclipse IDE
When you install the product package or packages, you can
choose to extend an Eclipse integrated development environment (IDE)
already installed on your computer by adding to the functions that
your new product or products contain.
Any product package that you install using IBM Installation Manager is
bundled with a version of the Eclipse IDE or workbench; this bundled
workbench is the base platform for providing the functionality in
the Installation
Manager package.
However, if you have an existing Eclipse IDE on your workstation,
then you have the option to extend it, that is, add to the
IDE the additional functionality provided in the product package or
packages.
To extend an existing Eclipse IDE: in the Location page of the
Install Packages wizard, select the Extend an existing
Eclipse IDE option.
You might extend your existing Eclipse IDE, for example, because
you want to gain the functionality provided in a product package,
but you also want to have the preferences and settings in your current
IDE when you work with the functionality from the product package.
You also might want to work with plug-ins that you have installed
that already extend the Eclipse IDE.
Your existing Eclipse IDE must be version 3.6 for the latest updates
from eclipse.org to be extended. Installation Manager checks that
the Eclipse instance you specify meets the requirements for the installation
package.
Note:
You might need to update your Eclipse version in order
to install updates for some products. Refer to the update release
documentation for information on changes to the prerequisite Eclipse
version.
Increasing the number of file handles on Linux workstations
For best product performance, increase the number of file
handles above the default of 1024 handles.
About this task
Important:
Before you work with
your Rational product, increase the number of
file handles. Most Rational products use more
than the default limit of 1024 file handles per process. A system
administrator might need to make this change.
Exercise
caution when using the following steps to increase your file descriptors
on Linux. If the instructions are not followed
correctly, the computer might not start correctly.
Procedure
- Log in as root. If you do not have root access, you will
need to obtain it before continuing.
- Change to the etc directory
Attention: If you decide to increase the number of file handles
in the next step, do not leave an empty initscript file on
your computer. If you do so, your computer will not start up the next
time that you turn it on or restart.
- 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.
- On the first line, type ulimit -n 30000.
The point is that 30000 is significantly larger than 1024, the default
on most Linux computers.
Important:
Do not set the number of handles too high, because
doing so can negatively impact system-wide performance.
- On the second line, type eval exec "$4".
- Save and close the file after making sure you have completed
steps 4 and 5.
Note:
Ensure that you follow the steps
correctly. If this procedure is not completed correctly, your computer
will not start.
- Optional: Restrict the number of handles available
to 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 4.0 have this file
by default. If you do not have this file, consider using a smaller
number in step 4 in the previous procedure (for example, 2048). Do
this so that most users have a reasonably low limit on the number
of open files that are allowed per process. If you use a relatively
low number in step 4, it is less important to do this. However, if
you set a high number in step 4 earlier and you do not establish limits
in the limits.conf file, computer performance can be significantly
reduced.
The following sample limits.conf file restricts
all users, and then sets different limits for others afterwards.
This sample assumes that you set handles to 8192 in step 4 earlier.
* 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 preceding example sets the limits for all users first. These limits
are lower than the limits that follow. The root user has a higher
number of allowable handles open, while number available to user1
is between the two. Make sure that you read and understand the documentation
contained in the limits.conf file before making changes.
What to do next
For more information on the ulimit command, see the man page
for ulimit.
Installing Rational Service Tester
The Setup disk includes the launchpad program, which provides
you with a single location to start the installation process.
About this task
Use the launchpad program to start the installation of software
in these cases:
- Installing from product CDs
- Installing from an electronic image on your local file system
- Installing from an electronic image on a shared drive
For products that are installed by IBM Installation Manager for
the Rational Software Delivery
Platform,
starting the installation process from the launchpad program causes Installation
Manager to
be automatically installed if it is not already on your computer.
Furthermore, the installation process is already configured with the
location of the repository that contains the installation package.
If you install Installation
Manager separately,
you must configure the repository preferences manually. Also, you
can start the installation of a number of supporting software items
from the launchpad.
If you want to install Rational Service Tester as
a non-Admin, you cannot use the launchpad program to start the installation
process. Instead, you must manually run the userinst program from
the Setup disk. Running the userinst program provides you with the
same functionality as starting the installation of Rational Service Tester from
the launchpad.
Starting the launchpad
You can use the launchpad to start the installation.
Procedure
- If you are installing from the CDs, complete these steps:
- Insert the Setup CD into your CD drive.
-
Mount the CD drive.
- If autorun is enabled on your computer, the launchpad
program starts automatically. If the launchpad does not start automatically,
complete one of these steps:
-
Run launchpad.exe, which
is located in the root directory of the CD.
-
Run launchpad.sh, which
is located in the root directory of the CD.
- If you are installing from electronic disks downloaded
from IBM Passport Advantage, open a command line and change to the
directory where you extracted the disk images, and then do one of
the following things:
-
Run RST_SETUP\launchpad.exe.
-
Run RST_SETUP/launchpad.sh.
Results
The launchpad program starts.
Starting installation from the Setup disk
If you want to install Rational Service Tester as
a non-Admin, you must manually run the userinst program from the Setup
disk instead of running the launchpad program. Running the userinst
program provides you with the same functionality as starting the product
installation from the launchpad.
Procedure
- If you are installing from the CDs, do these steps:
- Insert the Setup CD into your CD drive.
-
Mount the CD drive.
- If autorun is enabled on your computer, the launchpad program
starts automatically. Stop the launchpad program.
- In a command line, change to the root of the Setup disk and do
one of the following things:
-
As an Admin, Run InstallerImage_win32\install.exe.
-
As a non-Admin
Run InstallerImage_win32\userinst.exe.
-
As an Admin, Run InstallerImage_linux/install.
-
As a non-Admin, Run InstallerImage_linux/userinst.
- If you are installing from electronic disks downloaded
from IBM Passport Advantage, open a command line and change to the
directory where you extracted the disk images, and then do one of
the following things:
-
As an Admin, Run RST_SETUP\InstallerImage_win32\install.exe.
-
As a non-Admin
Run RST_SETUP\InstallerImage_win32\userinst.exe.
-
As an Admin, Run RST_SETUP/InstallerImage_linux/install.
-
As a non-Admin, Run RST_SETUP/InstallerImage_linux/userinst.
Results
When the userinst or install program starts, Installation
Manager is installed if it is not already on your computer. Furthermore,
Installation Manager is configured with the location of the repository
(installation files) for Rational Service Tester.
Install the product software
Use these instructions 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 Information Center.
Important:
Installation notes for the Windows Vista operating 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.)
- Do not install the products into the Program Files directory (C:\Program Files). If you select
either an Installation Location or a Shared Resources Directory in
the Program Files directory, the packages that
you install must be run as administrator.
Procedure
- Review the Installation considerations, if you have not done so already.
- 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 that are named /disk1,/disk2, and so on. Extract the Setup disk image
to a directory that is named RST_SETUP. The Setup
disk contains the launchpad program.
- 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 automatically. Otherwise, start the
launchpad program manually.
-
Run the launchpad.exe command, which is located in the root directory of the Setup disk
installation image.
-
Run the launchpad.sh command,
which is located in the root directory of the Setup disk installation
image.
- Select a language in which to run the launchpad and Installation
Manager.
- Select the product to install from the launchpad menu. The Install Packages window opens.
- 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.
- To search for updates to the product packages, click Check for Other Versions, Fixes, and Extensions. If updates
for a product package are found, then they are 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 that are 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.
- Select the product package and any updates to the package
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 are installed into the same package group.
- On the Prerequisite page, if a supported
version of IBM Rational License Key Administrator is not installed,
a warning message is displayed. A supported version of Rational License
Key Administrator comes with the product. To administer a license
server, you must install a supported version of Rational License Key
Administrator. If you use the launchpad program to install the product,
Rational License Key Administrator is listed on the Install
Packages page. If you start Installation
Manager, you must add the repository for Rational License Key
Administrator to install it at the same time as the product. Click Next to continue.
- 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.
- If you agree to the terms of all of the license agreements,
click I accept the terms of the license agreements.
- Click Next to continue.
- 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 to use follows:
-
C:\Program Files\IBM\IBMIMShared
-
/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.
- 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:
- Click Create a new package group.
- Type the path for the installation directory for the
package group. The name for the package group is created
automatically.
The default path follows:
-
C:\Program Files\IBM\SDP
-
/opt/IBM/SDP
- Click Next to continue.
- 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.6 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:
- Select Extend an existing Eclipse.
- 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 checks whether the Eclipse IDE version is valid for the
package that you are installing. The Eclipse JVM field displays the Java Virtual Machine (JVM) for the IDE that you specified.
- Click Next to continue.
- On the Features page under Translations, select the languages for the package group.
The corresponding translations for the user interface and documentation
for the product package will be installed.
- On the next Features page, select the package features
to install.
- Optional: To see the dependency relationships
between features, select Show Dependencies.
- Optional: Click a feature to view its brief
description under Details.
- Select or clear features in the packages. Installation
Manager automatically enforces any dependencies with other features
and displays updated download size and disk space requirements for
the installation.
- When you are finished selecting features, click Next to continue.
- On the common licensing configuration page, type the TCP/IP
port number and host name of the license servers to use to configure
licensing on the workbench computer. Separate the port number and
host name with the at sign (@). Separate the port-host pairs with
semicolons (;). To use the default port, omit the port number. If
you do not know the port numbers and names of license servers to use,
you can configure the license servers after installation by using
Rational License Key Administrator. For example, to
configure three license servers that are named license1, license2,
and license3 to use port 27000, the default port, and port 1765 respectively,
enter this text: 27000@license1;@license2;1765@license3
- 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
- On the Summary page, review your choices
before installing the product package. 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
that is completed.
- When the installation process is complete, a message confirms
the completion of the process.
- 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.
- In the Install Package wizard, select whether to start
the product when you exit.
- Click Finish to start the selected
package. The Install Package wizard closes and you are returned to
the Start page of Installation
Manager.
- License the product.
Managing licenses
Licensing for your installed IBM software
and customized packages is administered using the Manage Licenses
wizard in the IBM Installation Manager. The Manage Licenses
wizard displays license information for each of your installed packages.
Using the Manage Licenses wizard, you can apply a license to a
product or upgrade trial versions of an offering to a licensed version
by importing a product activation kit. You can also enable Floating
license enforcement for offerings with trial or permanent licenses
to use floating license keys from a license server.
For more information on managing licenses for your Rational product,
see:
Licenses
As a purchaser of an IBM Rational software product, you can
choose from three types of product licenses: an Authorized User license, an
Authorized User Fixed Term License (FTL), and a Floating license. The best
choice for your organization depends upon how many people use the product,
how often they require access, and how you prefer to purchase your software.
Authorized User license
An IBM Rational Authorized User license authorizes
a single individual to use a Rational software product. Purchasers must obtain
an Authorized User license for each individual user who accesses the product
in any manner. An Authorized User license cannot be reassigned unless the
purchaser replaces the original assignee on a long-term or permanent basis.
For
example, if you purchase one Authorized User license, you can assign that
license to one individual, who can use the Rational software product exclusively.
The Authorized User license does not authorize a second individual to use
that product at any time, even if the licensed individual is not using the
product.
Authorized User Fixed Term License
An IBM Rational Authorized
User Fixed Term License (FTL) authorizes a single individual to use a Rational software
product for a specific length of time (the term). Purchasers must obtain an
Authorized User FTL for each individual user who accesses the product in any
manner. An Authorized User FTL cannot be reassigned unless the purchaser replaces
the original assignee on a long-term or permanent basis.
Note:
When
you purchase an Authorized User FTL under the Passport Advantage® Express® program, IBM will
automatically extend the license term for an additional year at the prevailing
price unless you notify IBM before the license expires that you do not want an
extension. The subsequent FTL term starts when the initial FTL term expires.
The price for this subsequent term is currently 80% of the initial FTL price,
but is subject to change.
If you notify IBM that you do not want to extend the license
term, then you must stop using the product when the license expires.
Floating license
An IBM Rational Floating license is a license
for a single software product that can be shared among multiple team members;
however, the total number of concurrent users cannot exceed the number of
floating licenses you purchase. For example, if you purchase one floating
license for a Rational software
product, then any user in your organization may use the product at any given
time. Another person who wants to access the product must wait until the current
user logs off.
To use floating licenses, you must obtain floating
license keys and install them on a Rational License Server. The server
responds to user requests for access to the license keys; it will grant access
to the number of concurrent users that equals the number of licenses the organization
purchased.
License enablement
If you are installing the software for the first time or want to
extend a license to continue using the product, you have options on how to
enable licensing for your product.
Licenses for this product are enabled in two ways:
- Importing a product activation kit
- Enabling Rational Common
Licensing to obtain access to floating license keys
Activation kits
The Product Activation Kit CD contain
the permanent license key for you product. You use IBM Installation Manager to import the activation
kit to your product.
Floating license enforcement
Optionally, you can
obtain floating license keys, install IBM Rational License Server, and enable
Floating license enforcement for your product. Floating license enforcement
provides the following benefits:
- License compliance enforcement across the organization
- Fewer license purchases
- Serve license keys for IBM Rational Team Unifying and Software Delivery Platform
desktop products from the same license server
Note:
Some 7.0 and later versions of Rational products require an upgraded
version of the Rational License
Server. See support article
http://www.ibm.com/support/docview.wss?uid=swg21250404 for
license upgrade information.
For more information on obtaining activation
kits and Floating licenses, see Purchasing
licenses.
Enabling runtime licenses for testing
To run tests, you must have the correct license keys installed.
Rational Performance Tester requires two types of licensing: product activation and
runtime licensing. Product activation licensing allows you to run
the product. Runtime licensing is unique to Rational Performance Tester. Runtime licensing consists of protocol keys and virtual
tester license key packs. Runtime licensing allows you to run performance
tests on specific protocols with multiple virtual users. You use different
tools to manage and configure product activation licensing and runtime
licensing. You manage product activation using Installation Manager.
You manage runtime licensing using IBM Rational License Key Administrator.
With product activation licenses you can start the product. There
are two forms of product activation licensing: a product activation
kit that is installed on the computer where the product is installed,
or a floating product license that users check out from a Rational
License Server. You can download the product activation kit from Passport
Advantage for authorized user purchases. For floating product licenses,
your license server administrator must log in to the Rational License
Center to download a floating license key and import it to your Rational
License Server. Make sure to use the version of Rational License Server
that is shipped with the product. Earlier versions of Rational License
Server might not support all of the necessary licensing functions.
The Rational License Server supports floating license keys, so
that administrators can manage licensing across the enterprise. Administrators
can install the Rational License Server from Passport Advantage or
from the product media. To learn more about product activation, including
the Rational License Server, see the product installation guide.
In addition to product activation, Rational Performance Tester also checks for runtime licensing when you run a performance
schedule. Runtime licensing consists of the correct protocol keys
and virtual tester license key packs. You need a protocol key to run
performance tests with any protocol other than HTTP. You need a virtual
tester license key pack to run tests with more than five virtual users.
You can check out these keys from the same Rational License Server
that you use for floating license product activation.
To check out protocol and virtual tester license keys in Windows,
you must use the IBM Rational License Key Administrator program to
point to a Rational License Server. Use the version of IBM Rational
License Key Administrator that was installed with Rational Performance Tester. Click Start > Programs > IBM Rational > IBM Rational License Key Administrator.
Type the name or IP address of your Rational License Server. Protocol
and virtual tester license keys are available from the Rational License
Key Center in the form of .upd files. If you double-click a .upd file
in Windows, the License Key Administrator program should start automatically
and import the license keys. To learn more about IBM Rational License
Key Administrator, click Help > Contents and Index.
There is no Linux version of the IBM Rational License Key Administrator.
To check out protocol and virtual tester license keys in Linux, you
must create and edit the .flexlmrc file. Create
the file .flexlmrc in the home directory of every
user who runs more than five virtual testers, uses a protocol other
than HTTP, or uses the floating license product activation. Edit the .flexlmrc file, adding a line with the computer name or
the IP address of the Rational License Server. For example, add the
line RATIONAL_LICENSE_FILE=@license-server-name.com or RATIONAL_LICENSE_FILE=@license-server-ip-address.
Purchasing licenses
You can purchase new licenses if your current product license
is about to expire or if you want to acquire additional product licenses
for team members.
Procedure
- Determine the type of license you want to purchase.
- Go to ibm.com® or contact your IBM sales
representative to purchase the product license. For details, visit
the IBM web page on How
to buy software.
- Depending on the type of license you purchase, use the
Proof of Entitlement that you receive and do one of the following
to enable your product:
- If you purchase Authorized User licenses for your product,
go to Passport Advantage and
follow the instructions there for downloading your product activation
kit. After you have downloaded the activation kit, import the product
activation .jar file using IBM Installation Manager.
Back
up the product activation .jar file. If you uninstall the product
and then install the product again, you might need to use the product
activation .jar file to license the product again.
- If you purchase Floating licenses for your product, click
the link to the IBM Rational Licensing and Download
site, login (IBM registration is required), and
then select the link to connect to the IBM Rational License
Key Center. There you can use your Proof of Entitlement to obtain
floating license keys for your license server.
Optionally, you
can go to Passport Advantage to download
the activation kit for your product. After importing the activation
kit, you can switch from a floating to a permanent license type if
you use your computer offline for long periods.
What to do next
When you want to import the activation kit or enable Floating
License support for your product, use the Manage Licenses wizard in IBM Installation
Manager.
You can review license information for your installed packages,
including license types and expiration dates, from IBM Installation
Manager.
Procedure
- Start IBM Installation Manager.
- On the main page, click Manage Licenses.
Results
The package vendor, current license types, and expiration
dates are displayed for each installed package.
Installing help content from an archive file
This topic explains how to install help content from the
archive file bundled with the product. Most help content is not installed
when you install your product. If you do not have an Internet connection,
to access help content locally you can install it from the bundled
archive file.
Before you begin
During installation, the help access option, Download
help and access the content locally, was selected. If
you the help system window is open, close it before you start the
following procedure.
About this task
You can use this procedure to install help from the bundled
archive file, or from help archive files that you download from http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/documentation/updatesites/.
Procedure
- Extract the help archive file RST8.1_updateSite.zip to
a temporary folder. By default, on Windows, the help archive file
is installed in this directory: C:\Program Files\IBM\SDP\rst\remotehelp\docs\ and
named com.ibm.rst.remote.help.updateSite.zip.
- Start Rational Performance Tester and select a workspace. A warning message is displayed indicating that you need
to install help content.
- Click Launch Local Help Updater.
Alternately, from the main window of the product, click Help > Local Help Updater. The Local Help Updater is a browser application.
You might be prompted to adjust browser security settings to run the
Local Help Updater. The Updater site opens in a
separate browser window.
- On the Public Sites page, click the Internal
Sites tab.
- Click the plus sign icon. A file chooser window opens.
- Type any name in the Name field.
For example, type "Rational System Tester Documentation."
- Click Browse, then navigate to the
directory where you extracted RST8.1_updateSite.zip.
Select the site.xml file, and then click OK. The name and location should now be displayed in the list
of internal sites.
- Click the name of the internal site.
- The Available Features list will
be populated with a list of the help that is available for download.
Depending on your network connection speed, this might take a few
minutes. Select the help content that you need.
- Click Install. The
help content is downloaded and installed. A progress bar opens and
tracks the status of the download. After the help is installed, the
following message is displayed: Platform has been reset.
You must restart your workbench for the changes to take effect.
- Click OK, and then close the browser
window.
- In the product, click File > Restart.
Results
The help that you selected is installed on your system.
Notices
© Copyright IBM Corporation 2000, 2011.
U.S. Government Users Restricted Rights - Use, duplication or disclosure
restricted by GSA ADP Schedule Contract with IBM Corp.
This information was developed for products and services offered
in the U.S.A.
IBM may
not offer the products, services, or features discussed in this document
in other countries. Consult your local IBM representative for information on the products
and services currently available in your area. Any reference to an IBM product, program,
or service is not intended to state or imply that only that IBM product, program,
or service may be used. Any functionally equivalent product, program,
or service that does not infringe any IBM intellectual property right may be used
instead. However, it is the user's responsibility to evaluate and
verify the operation of any non-IBM product, program, or service.
IBM may
have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not
grant you any license to these patents. You can send license inquiries,
in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information,
contact the IBM Intellectual
Property Department in your country or send inquiries, in writing,
to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 Japan
The following paragraph does not apply to the United Kingdom or
any other country where such provisions are inconsistent with local
law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION
"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING,
BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY
OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer
of express or implied warranties in certain transactions, therefore,
this statement may not apply to you.
This information could include technical inaccuracies or typographical
errors. Changes are periodically made to the information herein; these
changes will be incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in
this publication at any time without notice.
Any references in this information to non-IBM websites are provided
for convenience only and do not in any manner serve as an endorsement
of those websites. The materials at those websites are not part of
the materials for this IBM product and use of those websites is at your own risk.
IBM may use or distribute any of the information you supply in
any way it believes appropriate without incurring any obligation to
you.
Licensees of this program who wish to have information about it
for the purpose of enabling: (i) the exchange of information between
independently created programs and other programs (including this
one) and (ii) the mutual use of the information which has been exchanged,
should contact:
Intellectual Property Dept. for Rational Software
IBM Corporation
5 Technology Park Drive
Westford, MA 01886
U.S.A.
Such information may be available, subject to appropriate terms
and conditions, including in some cases, payment of a fee.
The licensed program described in this document and all licensed
material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International
Program License Agreement or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating environments
may vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be
the same on generally available systems. Furthermore, some measurements
may have been estimated through extrapolation. Actual results may
vary. Users of this document should verify the applicable data for
their specific environment.
Information concerning non-IBM products was obtained from the suppliers
of those products, their published announcements or other publicly
available sources. IBM has
not tested those products and cannot confirm the accuracy of performance,
compatibility or any other claims related to non-IBM products. Questions
on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
All statements regarding IBM's future direction or intent are subject
to change or withdrawal without notice, and represent goals and objectives
only.
If you are viewing this information softcopy, the photographs and
color illustrations may not appear.
Trademarks and service marks
See www.ibm.com/legal/copytrade.shtml.