Before using this information and the product it supports, read the information in Notices.
This edition applies to IBM Rational Service Tester for SOA Quality Version 8.3, and to all subsequent releases and modifications until otherwise indicated in new editions.
This installation guide provides instructions for installing, updating, and uninstalling IBM® Rational® Service Tester for SOA Quality.
One product is covered by this installation guide, the IBM Rational Service Tester for SOA Quality.
Follow these broad steps to install the product. The linked topics provide procedures and details for each step.
To install the product complete these procedures:
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:
These terms are used in the installation topics.
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.
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:
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.
Before you can install the product, you must verify that your system meets the following 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:
|
Display | Minimum: 1024 x 768 resolution minimum using 256 Colors or higher for best results. |
Other hardware | Microsoft mouse or compatible pointing device |
Before you install the product, verify that your system meets the software requirements.
The following operating systems are supported for this product.
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 extend an existing Eclipse IDE of version 3.6 only with the latest updates from eclipse.org.
To extend an installed Eclipse IDE, you must also have a Java™ runtime environment from one of these Java development kits:
You must have a user ID that meets the following requirements to install Rational Service Tester.
Part of planning entails making decisions about installation locations, working with other applications, extending Eclipse, upgrading, migrating, and configuring help content.
IBM Installation Manager retrieves product packages from specified repositories and installs the products into selected locations, which are referred to as package groups.
During installation, you specify a package group into which to install a product.
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.
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.
When you install each product package, you select whether to install the product package into an existing package group or to create a package group. IBM Installation Manager prevents you from installing products into package groups products that are not designed to share or do not meet version compatibility and other requirements. 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 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 the products in the package group have the development, testing, and modeling functions available.
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 required.
When you install the product package or packages, you can extend an Eclipse integrated development environment (IDE) that is already installed on your computer. By extending Eclipse, you add the functions that your new product or products contain to the IDE.
Any product package that you install using IBM Installation Manager comes with a version of the Eclipse IDE or workbench; this included 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 can extend the IDE by adding the additional functions provided in the product package or packages that you are installing.
To extend an existing Eclipse IDE: On the Location page of the Install Packages wizard, select Extend an existing Eclipse IDE.
You might extend your existing Eclipse IDE, for example, to gain the functions that the product package provides, but you also plan to retain the preferences and settings in your current IDE when you work with the function from the product package. You also might plan 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 verifies that the Eclipse instance that you specify meets the requirements for the installation package.
For best product performance, increase the number of file handles above the default setting of 1024 handles.
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.
To increase your file descriptors:
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.
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 the number that is available to user1 is between the two. Make sure that you read and understand the documentation that the limits.conf file contains before making changes.
For more information on the ulimit command, see the man page for ulimit in the Linux documentation.
The Setup disk includes the launchpad program, which provides you with a single location to start the installation process.
Use the launchpad program to start the installation of software in these cases:
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.
To install Rational Service Tester as a non-administrator, 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 the same functions as starting the installation of Rational Service Tester from the launchpad.
To install the product, start the launchpad program.
Depending on the source of the product installation, follow one of these procedures to start the launchpad program;
The launchpad program starts.
To install Rational Service Tester as a non-administrator, 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 functions as starting the product installation from the launchpad.
Depending on the source of your product installation, complete one of these procedures to install the product:
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.
Use these instructions to install Rational Service Tester.
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 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.
The default path to use follows:
The default path follows:
Licensing for your installed IBM software and customized packages is administered through the Manage Licenses wizard in the IBM Installation Manager. The Manage Licenses wizard displays license information for each installed package.
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 these resources:
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 software.
An IBM Rational Authorized User license authorizes an 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.
An IBM Rational Authorized User Fixed Term License (FTL) authorizes an 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.
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.
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 can 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; the server grants access to the number of concurrent users that equals the number of licenses the organization purchased.
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:
The Product Activation Kit CD contains the permanent license key for you product. You use IBM Installation Manager to import the activation kit to your product.
Optionally, you can obtain floating license keys, install IBM Rational License Server, and enable floating license enforcement for your product. Floating license enforcement provides these benefits:
For more information about obtaining activation kits and floating licenses, see Purchasing licenses.
To run tests, you must have the correct license keys installed.
IBM Rational Service Tester for SOA Quality requires two types of licenses: product activation and runtime licenses. Product activation licenses permit you to run the product. Runtime licenses are unique to Rational Service Tester for SOA Quality. Runtime licenses consists of protocol keys and virtual tester license key packs. Runtime licenses permit you to run performance tests on specific protocols with multiple virtual users. You use different tools to manage and configure product activation licenses and runtime licenses. You manage product activation by using Installation Manager. You manage runtime licenses by using IBM Rational License Key Administrator.
With product activation licenses, you can start the product. There are two forms of product activation licenses: 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 IBM 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 comes with the product. Earlier versions of Rational License Server might not support all the required licensing functions. For more information about the Rational License Server, see Managing licenses with Rational Common Licensing.
The Rational License Server supports floating license keys, so that administrators can manage licensing throughout 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 Service Tester for SOA Quality 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 must have a protocol key to run performance tests with any protocol other than HTTP. You must have 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 Service Tester for SOA Quality. Click Start > Programs > IBM Rational > License Key Administrator 8.2.1. 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 starts automatically and imports 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.
You can purchase new licenses if your current product license is about to expire or to acquire additional product licenses for team members.
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.
Optionally, you can go to IBM 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.
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.
The package vendor, current license types, and expiration dates are displayed for each installed package.
© Copyright IBM Corporation 2000, 2012.
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:
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
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:
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.
See www.ibm.com/legal/copytrade.shtml.