IBM Rational Functional Tester, Version 8.0
Installation Guide
Note
Before using this information and the product it supports, read the information
in Notices.
First Edition (October 2008)
This edition applies to version 8.0 of IBM Rational Functional Tester (part
number 5724-G25) and to all subsequent releases and modifications until otherwise
indicated in new editions.
Copyright International Business Machines Corporation 2000 2008. All rights reserved.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Installing Rational Functional Tester
This section contains instructions for installing, updating, and
uninstalling IBM(R) Rational(R) Functional Tester.
The latest version of the installation information is available online
at: http://publib.boulder.ibm.com/infocenter/rfthelp/v8r0m0/index.jsp
Rational Functional Tester is
part of IBM Rational Software
Delivery Platform. The IBM Rational Software Delivery Platform is a common
development environment that contains the development workbench and other
software components that share multiple products.
About Rational Functional Tester
IBM Rational Functional Tester is
an object-oriented automated testing tool that tests Windows(R),
.Net, Java(TM),
HTML, Siebel, SAP and zSeries(R), iSeries(R), and pSeries(R) applications. Rational Functional Tester enables
you to record reliable, robust scripts that can be played back to validate
new builds of a test application. Functional Tester runs on Windows 2000,
Windows XP, and Linux(R) platforms.
Functional Tester is
available in two integrated development environments and two scripting languages. Functional Tester Java
Scripting uses the Java language and the Functional Tester VB.NET
2003 and VB.Net 2005 Scripting uses the VB.NET language and the Microsoft(R) Visual
Studio .NET development environment.
Rational Functional Tester Extension
for Terminal-based Applications is a tool that helps you create test scripts
to automate your host application test cases. Functional Tester Extension
for Terminal-based Application provides a rich set of capabilities to test
host attributes, host field attributes and screen flow through a host application.
It uses terminal verification points and properties, as well as synchronization
code to identify the readiness of terminal for user input.
Using Functional Tester Extension for Terminal-based Applications, you
can:
- Store, load, and share common host configurations by using a properties
file. The connection configuration can be loaded automatically through scripts,
using these files.
- Record or play back scripts against multiple host terminals.
- Launch the terminal even when you are not recording or playing back your
scripts. With this function, you can interact with the host without leaving
the working Eclipse or the .NET environment.
Installation terminology
Understanding these terms can help you take full advantage of the
installation information and your Rational Functional Tester.
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. (Some packages cannot share a
package group, in which case the option to use an existing package group is
unavailable.)
- Repository
- A storage area where packages are available for download. 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 to install
Read all the topics in this section before you begin to install
or update any of the product features. 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 manage
the IBM applications, or packages, that it installs on your computer. Installation Manager does
more than install packages: It helps you keep track of what you have installed,
determine what is available for you to install, and organize installation
directories.
Installation Manager provides tools 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 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.
- 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.
For more information about IBM Installation Manager, visit the Installation
information center.
Installation requirements
This section details hardware, software, and user privilege requirements
that must be met in order to successfully install and run your software.
For the most up-to-date system requirements, refer to www.ibm.com/software/awdtools/tester/functional/sysreq/index.html.
Hardware requirements
Before you can install IBM Rational Functional Tester,
verify that your system meets the minimum hardware requirements.
Hardware |
Requirements |
Processor |
Minimum: 1.5 GHz Intel(R) Pentium(R) 4 (or higher for best results) |
Memory |
Minimum: 1 GB of RAM |
Disk space |
Minimum: 750 MB of disk space is required for product
package installation. Additional disk space is required 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.
- For Windows: Additional disk space is required if
you use FAT32 instead of NTFS.
- For Windows: An additional 500 MB of disk space is
required in the directory pointed to by your environment variable TEMP.
- For Linux: An
additional 500 MB of disk space is required in the /tmp directory.
|
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 can install the product, verify that your system meets
the software requirements.
Operating system
The following operating systems
are supported for this product in 32-bit mode:
- Microsoft Windows XP
Professional with Service Pack 2 or 3
- Microsoft Windows 2000 Professional with Service Pack 4
- Microsoft Windows 2000 Server with Service Pack 4
- Microsoft Windows 2000 Advanced Server with Service Pack 4
- Microsoft Windows 2003 Server Standard Edition with Service Pack 1 or
2
- Microsoft Windows 2003 Server Enterprise Edition with Service Pack 1 or
2
- Microsoft Windows Vista Business, Windows Vista Enterprise, and Windows
Vista Ultimate
- Microsoft Windows Vista Business, Windows Vista Enterprise, and Windows
Vista Ultimate with Service Pack 1
- Red Hat Enterprise Linux AS 4.0 (All functions except recording)
- Red Hat Enterprise Linux AS 4.0 Update 5 (All functions except recording)
- Red Hat Enterprise Linux ES 4.0 (All functions except recording)
- Red Hat Enterprise Linux ES 4.0 Update 1 (All functions except recording)
- Red Hat Enterprise Linux Desktop 4.0 (All functions except recording)
- Red Hat Enterprise Linux Desktop 4.0 Update 1 (All functions except recording)
- Red Hat Enterprise Linux Desktop 4.0 Update 7 (All functions except recording)
- SUSE Linux Enterprise Server (SLES) 9.0 (All functions except recording)
- SUSE Linux Enterprise Server (SLES) 9.0 SP4 (All functions except recording)
- SUSE Linux Enterprise Server (SLES) 10.0 (All functions except recording)
- SUSE Linux Enterprise Server (SLES) 10.0 SP1 (All functions except recording)
- SUSE Linux Enterprise Server (SLES) 10.0 SP2 (All functions except recording)
- SUSE Linux Enterprise Desktop 10.0 (All functions except recording)
- SUSE Linux Enterprise Desktop 10.0 SP1 (All functions except recording)
The listed operating systems support all of the languages that are supported
by Rational Functional Tester.
Note:
Rational Functional Tester Extension
for Terminal-based Applications runs on Microsoft Windows 2000 , Microsoft
Windows XP, Microsoft Windows Server 2003 and Microsoft Windows Vista systems.
It supports connection to zSeries (TN3270 terminal types for MVS(TM) and VM), iSeries (TN5250
terminal type for OS/400(R)) and pSeries (VT terminal types for Unix)
hosts.
Software requirements for extending an existing Eclipse IDE
To
install Rational Functional Tester into
an existing eclipse, the version of the existing eclipse should be 3.4.1 or
higher.
To extend an existing Eclipse IDE, you also require a JRE from
one of the following Java development kits:
- For Windows: IBM 32-bit SDK for Windows, Java 2 Technology Edition, Version 6 or
Sun Java 2 Standard Edition 6
- For Linux: IBM 32-bit SDK for Linux on Intel architecture, Java 2 Technology
Edition, Version 6 or Sun Java 2 Standard Edition 6
Note:
You might need to update your Eclipse version in order to
install updates to Rational Functional Tester.
Refer to the update's release documentation for information on changes to
the prerequisite Eclipse version.
Important:
To enable users
who do not have Administrator privileges to work with Rational Functional Tester on
a Windows Vista system, do not install Eclipse inside the Program Files directory
(C:\Program Files\).
Supported virtualization software
The following
virtualization software is supported:
- Citrix Presentation Manager Version 4, running on Windows Server 2003
Standard Edition or Windows Server 2003 Professional Edition
Additional software requirements
- Microsoft .NET Framework 1.1 or later for recording functional test scripts
on any Windows applications
- Microsoft Visual Studio.Net 2003, Standard Edition or Professional Edition,
with VB.NET Project support for .Net 2003 scripting.
- Microsoft Visual Studio.Net 2005, Standard Edition or Professional Edition,
with VB.NET Project support for .Net 2005 scripting .
- For Linux: 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:
- For Windows: Microsoft Internet Explorer 6.0 with Service Pack 1, or later
- Mozilla 1.6, or later
- Firefox 1.0.x, 1.5, 2.0, or later
Note:
- On Red Hat Enterprise Linux Workstation Version 4.0, you must set the
environment variable MOZILLA_FIVE_HOME to the folder containing your Firefox
or Mozilla installation. For example, setenv MOZILLA_FIVE_HOME /usr/lib/firefox-1.5.
- To support the SWT browser widget, your Firefox browser must have been
compiled with linkable Gecko libraries. Firefox downloads from mozilla.org
currently do not satisfy this criteria, but Firefox installations that are
included in major Linux distributions often do.
Note:
The Launchpad does not support Mozilla 1.6; if your browser is
Mozilla, you need version 1.7, or later, to run the launchpad.
Note:
Functional Tester Extension
for Terminal-based Application installs the IBM SWT HA Beans feature of IBM
Host On-Demand in the system. If the latest version of IBM Host On-Demand
is available in the system, the Extension for Terminal-based Application uses
the IBM SWT HA Beans feature that is already installed. Do not uninstall the
IBM Host On-Demand because the Extension for Terminal-based Application requires
it.
User privileges requirements
You must have a user ID that meets the following requirements before
you can install Rational Functional Tester.
- Your user ID must not contain double-byte characters.
- For Windows, the user privileges required for installing
depend on the version of Windows on your computer:
- For Windows Vista, you must log in to the Administrator
account (or run as Administrator; right-click the program file or shortcut
and select Run as Administrator) to perform the following
tasks:
- Install or update IBM Installation Manager
- Install or update a product offering
- Install an Authorized-User license key for your product by using IBM Installation
Manager
Note:
To enable users who are not the Administrator to work with Rational Functional Tester on a Windows Vista
system:
- Do not install Rational Functional Tester into
a package group (installation location) in the Program Files directory (C:\Program
Files\) and do not choose a shared resources directory in the Program Files
directory.
- If you are extending an existing Eclipse installation, then do
not install Eclipse in the Program Files directory (C:\Program Files\).
- For other supported Windows versions, you must have
a user ID that belongs to the Administrators group.
- For Linux:
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 scenarios
There are a number of scenarios that you can follow when you install
or update Rational Functional Tester.
The following are some of the factors that might determine your installation
scenario:
- The format and method by which you access your installation files (for
example, from CDs or files downloaded from IBM Passport Advantage(R)).
- The location for your installation (for example, you can install the product
onto your own workstation, or make the installation files available to your
enterprise.).
- The type of installation (for example, you can use the Installation Manager
GUI, or install silently.).
These are the typical installation scenarios you might follow:
- Installing from the CDs.
- Installing from a downloaded electronic image on your workstation.
- Installing from an electronic image on a shared drive.
- Installing from a repository on an HTTP or HTTPS Web server.
Note that in the latter three scenarios you can choose to run the
Installation Manager program in silent mode to install Rational Functional Tester.
For details on running Installation Manager in silent mode, see Installation
information center.
Note also that you can install updates at the same time that you install
the base product package.
Installing from CDs
In this installation scenario,
you have the CDs that contain the product package files, and typically you
are installing Rational Functional Tester on
your own workstation. See Installing Rational Functional Tester from
CDs: task overview for
an overview of the steps.
Installing from a downloaded electronic image on your workstation
In
this scenario, you have downloaded the installation files from IBM Passport
Advantage and you will install Rational Functional Tester on
your own workstation. See Installing Rational Functional Tester from
an electronic image on your workstation: task overview for
an overview of the steps.
Installing from an electronic image on a shared drive
In
this scenario, you will place the electronic image on a shared drive so that
users in your enterprise can access the installation files for Rational Functional Tester from
a single location. See Installing Rational Functional Tester from
an electronic image on a shared drive: task overview for
an overview of the steps.
Installing from a repository on
an HTTP or HTTPS Web server
This scenario is the fastest method
for installing the product on a network and is different from the shared-drive
installation. To place product package files for Rational Functional Tester on
an HTTP or HTTPS Web server, you must use IBM Packaging Utility, a utility
application, to copy the installation files in a package format that you can
use to install Rational Functional Tester directly
from an HTTP or HTTPS Web server. This utility is provided with Rational Functional Tester.
The directory on the HTTP or HTTPS Web server that contains the package is
called a repository. Note that any optional software included with the Rational Functional Tester installation
CDs are not placed in the package; only the Rational Functional Tester installation
files are placed in the package. See Installing Rational Functional Tester from
a repository on an HTTP or HTTPS Web server: task overview and Placing Rational Functional Tester on
an HTTP Web server: task overview for an overview of the steps.
Planning features to install
You can customize your software product by selecting which features
of Rational Functional Tester to
install.
When you install the Rational Functional Tester product
package by using IBM Installation Manager, the installation wizard displays
the features in the available product package. From the features list, you
can select which to install. A default set of features is selected for you
(including any required features). Installation Manager automatically enforces
any dependencies between features and prevents you from clearing any required
features.
Note:
After you finish installing the package, you can still add or remove
features from your software product by running the Modify Packages wizard
in Installation Manager. See
Modifying installations for
more information.
Features
The following table shows the features of Rational Functional Tester that
you can choose to install. Default selections of features to install might
vary. If a feature already exists in your shared resources directory, it will
not be selected by default and will not be installed again.
Feature |
Description |
Selected for installation by default |
Java scripting |
Provides automated functional and regression testing of Java, Web,
Siebel, and SAP applications through the Eclipse IDE. The .Net Framework 1.1
or 2.0 is required for testing Siebel and SAP applications. |
Yes |
.Net 2003 scripting |
Provides automated functional and regression testing of VB.NET, Java,
Web, Siebel, and SAP applications through the .Net 2003 IDE. Requires .Net
Framework 1.1. |
No |
.Net 2005 scripting |
Provides automated functional and regression testing of VB.NET, Java,
Web, Siebel, and SAP applications through the .Net 2005 IDE. Requires .Net
Framework 2.0. |
No |
IBM Rational Agent
Controller |
IBM Rational Agent Controller drives the execution of Rational Functional
Tester scripts on a remote machine when launched from ClearQuest(R) Test Manager. The Rational
Agent Controller should be installed on the remote machine where scripts are
to be run along with the Rational Functional Tester agent. ClearQuest Test
Manager should be installed on the machine from which these scripts are to
be launched. |
No |
Installation location
When you install the Rational Functional Tester package
using IBM Installation Manager, you
must choose a package group and a shared resource directory.
Package groups
During the installation process,
you must specify a package group for the Rational Functional Tester package.
A package group represents a directory in which packages share resources with
other packages in the same group. When you install the Rational Functional Tester package
using Installation Manager,
you can create a new package group or install the packages into an existing
package group. (Some packages might not be able to share a package group,
in which case the option to use an existing package group will be disabled.)
Note
that when you install multiple packages at the same time, all the packages
are installed into the same package group.
A package group is assigned
a name automatically; however, you choose the installation directory for the
package group.
After you create the package group by successfully installing
a product package, you cannot change the installation directory. The installation
directory contains files and resources specific to the Rational Functional Tester product
package installed into that package group. Resources in the product package
that can potentially be used by other package groups are placed in the shared
resources directory.
Important:
To enable users who do not
have Administrator privileges to work with Rational Functional Tester in
the Windows Vista
operating system, do not choose a directory inside the Program Files directory
(C:\Program Files\).
Shared resources directory
The shared resources
directory is the directory where installation artifacts are located so
that they can be used by one or more product package groups.
Important:
- You can specify the shared resources directory once: the first time that
you install a package. For best results, use your largest drive for this.
You cannot change the directory location unless you uninstall all packages.
- To enable users who do not have Administrator privileges to work with Rational Functional Tester on a Windows
Vista system, do not choose a directory inside the Program Files directory
(C:\Program Files\).
Extending an existing Eclipse IDE
When you install the Rational Functional Tester product
package, you can choose to extend an Eclipse integrated development environment
(IDE) already installed on your computer by adding the functions that the Rational Functional Tester package
contains.
The Rational Functional Tester 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 Rational Functional Tester package.
To extend an existing Eclipse IDE: in the Location page of the Install
Packages wizard, select the Extend an existing Eclipse IDE option.
Important:
To enable users who do not have Administrator privileges
to work with Rational Functional Tester in
the Windows Vista
operating system, do not install Eclipse inside the Program Files directory
(C:\Program Files\).
You might extend your existing Eclipse IDE, for example, because you want
to gain the functionality provided in the Rational Functional Tester package,
but you also want to have the preferences and settings in your current IDE
when you work with the functionality from the Rational Functional Tester 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.4.1 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 to Rational Functional Tester. Refer to
the update release documentation for information on changes to the prerequisite
Eclipse version.
Upgrade and coexistence considerations
If you have a previous version of the product, or if you plan
to install multiple Rational Software Delivery Platform products on
the same workstation, review the information in this section.
Upgrading from IBM Rational Functional Tester version
6.1.x or 7.0.x
IBM Rational Functional Tester version
8.x cannot be installed on a computer on which Rational Functional Tester version
6.1.x or 7.0.x is installed. All previous versions of Functional Tester must
be uninstalled before attempting to install IBM Rational Functional Tester version
8.x. During the installation of Rational Functional Tester version
8.x, if an installation of the version 6.1.x or 7.0.x product is detected,
the installation routine will stop. Refer to the previous product's documentation
for instructions on uninstalling the software.
Note:
Uninstalling version 6.1.x or 7.0.x packages will not delete project
assets.
Migrating test assets from earlier versions of IBM Rational Functional Tester
All test assets from earlier versions of Rational Functional Tester, including
projects, scripts, object maps, and verification points, will work with the
current version of the product. However, scripts recorded with the current
version of the product will not play back on earlier versions.
Coexistence within a package group
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 offers only products
that are designed to share a package group and 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 functions
available.
Coexistence between package groups
Multiple instances of a product package can exist on the same computer
and they are automatically installed into separate package groups. The product
packages can be at different versions or fix levels.
If you update a product package, you update only that instance of the product.
Installation repositories
IBM Installation Manager retrieves
product packages from specified repository locations.
If the launchpad is used to start Installation Manager,
the repository information is passed to Installation Manager.
If the Installation Manager is
started directly, you must specify an installation repository that contains
the product packages that you want to install. See Setting repository preferences in Installation Manager.
Some organizations bundle and host their own product packages on their
intranet. For information about this type of installation scenario, see Installing from a repository on
an HTTP or HTTPS Web server.
Your system administrators will need to provide you with the correct URL.
By default, IBM Installation Manager uses
an embedded URL in each Rational software development product to connect
to a repository server over the Internet. Installation Manager then searches
for the product packages as well as new features.
Setting repository preferences in Installation Manager
When you start the installation of Rational Functional Tester from
the launchpad program, the location of the repository that contains the product
package you are installing is automatically defined in IBM Installation Manager when it starts.
However, if you start Installation Manager directly (for example, installing Rational Functional Tester from a repository
located on a Web server) then you must specify the repository preference (the
URL for the directory that contains the product package) in Installation Manager
before you can install the product package. Specify these repository locations
on the Repositories page of the Preferences window. By default, Installation
Manager uses an embedded URL in each Rational software development product
to connect to a repository server through the Internet and search for installable
packages and new features. Your organization may require you to redirect the
repository to use intranet sites.
Note:
Before starting the installation process, be sure to obtain
the installation package repository URL from your administrator.
To add, edit, or remove a repository location in Installation Manager:
- Start Installation Manager.
- On the Start page of Installation Manager, click File -> Preferences,
and then click Repositories. The Repositories
page opens, showing any available repositories, their locations, and whether
they are accessible.
- On the Repositories page, click Add
Repository.
- In the Add repository window, type the URL
of the repository location or browse to it and set a file path.
- Click OK. If you provided an HTTPS or restricted
FTP repository location, then you will be prompted to enter a user ID and
password. The new or changed repository location is listed.
If the repository is not accessible, a red x is displayed in the Accessible column.
- Click OK to exit.
Note:
For Installation Manager to search the default repository
locations for the installed packages, ensure the preference Search
service repositories during installation and updates on the Repositories
preference page is selected. This preference is selected by default.
Web-based help content
Your help system is configured to use remote help so that you can
pull in content from the Web dynamically. With remote help, you always have
the latest content available from within your product. Some help systems are
not configured to access help content on the Web; in such cases, help content
is included with the installation.
If
your product is configured to use remote help, you can obtain help three ways.
One of these options will be best for you, depending on your needs and situation:
- The help content can be accessed on the Web so that you can have the smallest
installation footprint and the most up-to-date information.
- The help content can be downloaded and accessed on your computer so that
you can work disconnected from the Internet with periodic updates. The time
required to download the help content varies depending on your Internet connection
speed.
- The help content can be deployed as a WAR file on an intranet server so
that you can work behind a firewall with administrative updates. An administrator
will provide you information about connecting to the intranet server.
You can change your access decision any time. If an internet connection
is an issue, a one-time download and local access might be preferable. Later
help updates include only differences.
If you are an administrator and you want users to access help content from
an intranet server, see the Installation information center for instructions on
installing a WAR file on your intranet server.
Preinstallation tasks
Before you install the product, complete these steps:
- Confirm that your system meets the requirements described in the
section Installation requirements.
- Confirm that your user ID meets the required access privileges
for installing the product. See User privileges requirements.
- Read the section Planning to install and
give particular attention to the topic Upgrade and coexistence considerations.
- For Linux: If you want to enable the product to be used
by users other than root, then you must set to 0022, the umask variable before
you install the product. To set this variable, log in as root user, start
a terminal session, and type umask 0022.
Increasing the number of file handles on Linux workstations
Important: For best results, before you work with your Rational product,
increase the number of file handles available for Rational Functional Tester,
because it uses more than the default limit of 1024 file handles per process.
(A system administrator might need to make this change.)
Exercise caution
when following these steps to increase your file descriptors on Linux. Failure
to follow the instructions correctly might result in a computer that will
not start correctly. For best results, have your system administrator perform
this procedure.
To increase your file descriptors:
- Log in as root. If you do not have root access you will need to
obtain it before continuing.
- Change to the etc directory
- 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.
Important: If you decide to increase the number
of file handles, do not leave an empty initscript file on your computer.
If you do so, your machine will not start up the next time that you turn it
on or restart.
- On the first line, type ulimit -n 4096 (the key
here is that the number is significantly larger than 1024, the default on
most Linux computers). Caution: do not set this too high, because it
can seriously impact system-wide performance.
- On the second line, type eval exec "$4".
- Save and close the file after making sure you have done steps 4
and 5.
Note:
Ensure you have followed the steps correctly, as
not doing this correctly will result in a machine that does not boot.
- Optional: Restrict your 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, you might consider a smaller
number in step 4 above (for example, 2048). You need to do this so that most
users have a reasonably low limit on the number of allowable open files per
process. If you used a relatively low number in step 4, it is less important
to do this. However, if you choose to set a high number in step 4, refraining
from establishing limits in the limits.conf file can seriously impact computer
performance.
The following is a sample limits.conf file that
restricts all users and then sets different limits for others afterwards.
This sample assumes you set descriptors 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 example
above 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 descriptors
open, while user1 is in between the two. Make sure you read and understand
the documentation contained within the limits.conf file before making your
modifications.
For more information on the ulimit command, refer to the man page
for ulimit.
Verifying and extracting electronic images
After you download the installation files, you must extract
the electronic image from the compressed file before you can install Rational Functional Tester.
You may want to verify the completeness of the downloaded files before extracting
the image.
If you select the Download Director option for downloading the
installation file, the Download Director applet automatically verifies the
completeness of each file that it processes.
Extract each compressed file to the same directory. For Linux:
Do not include spaces in the directory names, or you won't be able to run
the launchpad.sh command to start the launchpad from a command line.
Installation tasks
The following sections provide an overview of the installation scenarios
that are described in the section Installation scenarios.
You can access detailed instructions from links in the main steps.
Installing Rational Functional Tester from
CDs: task overview
In this installation scenario, you have the CDs that contain the
installation files, and typically you are installing Rational Functional Tester on
your own workstation.
The following are the general steps for installing from CDs:
- Complete the preinstallation steps listed in Preinstallation tasks.
- Insert the first installation CD into your CD drive.
- For Linux: Mount the CD drive.
- If autorun is enabled on your system, the Rational Functional Tester launchpad
program automatically opens. If autorun is not enabled, start the launchpad
program. Refer to Starting the launchpad program for
details.
- Start the installation of Rational Functional Tester from
the launchpad. For details, see Starting an installation from the launchpad program.
IBM
Installation Manager is launched with Rational Functional Tester selected.
If
IBM Installation Manager is not installed on your system or if an older version
of IBM Installation Manager is installed, in addition to the selected Rational
Functional Tester, the entry for IBM Installation Manager is also selected.
Follow the on-screen instructions to complete the installation.
- Configure your license. By default, a trial license for Rational Functional Tester is
included. You must configure the license to ensure that you have continued
access to the product. Refer to Managing licenses for
details.
- For Linux: Increase the number of file handles on your
workstation. For details, see Increasing the number of file handles on Linux workstations.
Installing Rational Functional Tester from
an electronic image on your workstation: task overview
The following are the general steps for installing Rational Functional Tester from
an electronic installation image:
- Ensure that your workstation has sufficient space to store both
the files you must download from IBM Passport Advantage and the
extracted installation image. Refer to Hardware requirements.
- Download all required parts for the product image from IBM Passport
Advantage to a temporary directory.
- Extract the installation image from the downloaded file and verify
that the installation image is complete. See Verifying and extracting electronic images for
details.
- Continue with the steps in Installing from an electronic image below.
Installing from an electronic image
- Complete the preinstallation steps listed in Preinstallation tasks.
- Start the launchpad program. Refer to Starting the launchpad program for
details.
- Start the installation of Rational Functional Tester from
the Launchpad. For details, see Starting an installation from the launchpad program.
IBM
Installation Manager is launched with Rational Functional Tester selected.
If
IBM Installation Manager is not installed on your system or if an older version
of IBM Installation Manager is installed, in addition to the selected Rational
Functional Tester, the entry for IBM Installation Manager is also selected.
Follow the on-screen instructions to complete the installation.
Note:
If
you exit Installation Manager before completing the product installation,
you must restart Installation Manager from the launchpad. If you start the
Installation Manager directly, it is not preconfigured with the necessary
installation repositories.
Note:
For Installation Manager to search
the predefined IBM update
repository locations for Installation Manager,
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.
- Configure your license. By default, a trial license for Rational Functional Tester is
included. You must configure the license to ensure you have continued access
to the product. Refer to Managing licenses for details.
- For Linux: Increase the number of file handles on your
workstation. For details, see Increasing the number of file handles on Linux workstations.
Installing Rational Functional Tester from
an electronic image on a shared drive: task overview
In this scenario, you will place the electronic image on a shared
drive so that users in your enterprise can access the installation files for Rational Functional Tester from a single
location.
The following steps are performed by the person who places the installation
image on a shared drive.
- Ensure that your shared drive has sufficient disk space to store
both the files you must download from IBM Passport Advantage and the
extracted installation image. Refer to Hardware requirements for
details.
- Download all required parts for the product image from IBM Passport
Advantage to a temporary directory on the shared drive.
- Extract the installation image from the downloaded files into an
accessible directory on the shared drive and verify the installation image
is complete. See Verifying and extracting electronic images for details.
To install Rational Functional Tester from
the installation files on the shared drive:
- Change to the disk1 directory on the shared drive containing the installation
image.
- Follow the steps in Installing from an electronic image.
Installing Rational Functional Tester from
a repository on an HTTP or HTTPS Web server: task overview
In this scenario, the product packages are retrieved by IBM Installation Manager from
an HTTP or HTTPS Web server.
These steps assume the repository containing the package for Rational Functional Tester has
been created on the HTTP or HTTPS Web server.
To install the Rational Functional Tester package
from a repository on an HTTP or HTTPS server:
- Complete the preinstallation steps listed in Preinstallation tasks.
- Install IBM Installation Manager.
Refer to Working with IBM Installation Manager. In this scenario, for example, the Installation Manager installation
files are available from a shared drive.
- Start Installation Manager.
Refer to Starting Installation Manager on Windows for
details.
- Set the URL of the repository containing the package of Rational Functional Tester as
a repository preference in Installation Manager. See Setting repository preferences in Installation Manager.
- Start the Install Packages wizard in Installation Manager and follow
the on-screen instructions in the Install Packages wizard to complete the
installation. For complete details, see Installing Rational Functional Tester by
using the Installation Manager GUI.
- Configure your license. By default, a trial license for Rational Functional Tester is
included. You must set the license to ensure you have continued access to
work with the product. Refer to Managing licenses for
details.
- For Linux: Increase the number of file handles on your
workstation. For details, see Increasing the number of file handles on Linux workstations.
Placing Rational Functional Tester on
an HTTP Web server: task overview
To prepare Rational Functional Tester for
installation from a repository located on an HTTP Web server:
- Ensure that your HTTP or HTTPS Web server has sufficient disk space
to store the product package. Refer to Hardware requirements.
- Ensure that your workstation has sufficient disk space to store
both the files you must download from IBM Passport Advantage and the
extracted installation image. Refer to Hardware requirements
- Download all required parts for the product image from IBM Passport
Advantage to a temporary directory on your workstation.
- Extract the installation image from the downloaded files into another
temporary directory on your workstation and verify that the installation image
is complete. See Verifying and extracting electronic images for details.
- Install on your workstation the IBM Packaging Utility from the Enterprise
Deployment CD (or electronic disk) appropriate for your platform.
- Using the Packaging Utility, copy the Rational Functional Tester product
package.
- Copy the output of the Packaging Utility to an HTTP or HTTPS Web
Server.
- Copy the installation files for IBM Installation Manager from the Enterprise
Deployment CD to a shared drive.
- Instruct users in your organization to install Installation Manager.
- Provide users the URL for the repository that contains the Rational Functional Tester product
package you created earlier.
Installing from the launchpad program
The launchpad program provides you with a single location to view
release information and start the installation process.
Use the launchpad program to start the installation of Rational Functional Tester in
the following cases:
- Installing from the product CDs
- Installing from an electronic image on your local file system
- Installing from an electronic image on a shared drive
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 Rational Functional Tester package.
If you install and start Installation Manager directly,
then you must set repository preferences manually.
To install from the
launchpad:
- Complete the preinstallation tasks described in Preinstallation tasks,
if you have not done so already.
- Start the launchpad program. See Starting the launchpad program.
- Start the installation of Rational Functional Tester.
See Starting an installation from the launchpad program.
Follow the instructions in the Install Packages wizard to complete
the installation. For complete details, see Installing Rational Functional Tester by
using the Installation Manager GUI.
Important:
Installation notes for the Windows Vista operation system:
- You must run the launchpad program as administrator.
- If you are starting the installation of Rational Functional Tester from
the launchpad program, 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.).
- Selecting installation directories within the Program Files directory
(C:\Program Files) is not recommended. If you select either an Installation
Location or Shared Resources Directory within the Program Files directory,
the packages that you install must be run as administrator.
Starting the launchpad program
Complete the preinstallation tasks described in Preinstallation tasks,
if you have not done so already.
If you are installing from a CD and autorun is enabled on your
workstation, then the Rational Functional Tester launchpad
starts automatically when you insert the first installation disc into your
CD drive. If you are installing from an electronic image, or if autorun is
not configured on your workstation, then you must start the launchpad program
manually.
To start the launchpad program:
- Insert the IBM Rational Functional Tester CD
into your CD drive. For Linux: Ensure that you have mounted the
CD drive.
- If autorun is enabled on your system, the IBM Rational Functional Tester launchpad
program automatically opens. If autorun is not enabled on your system:
- For Windows: Run launchpad.exe located in the root directory
of the CD.
- For Linux:
Run launchpad.sh located in the root directory of the CD.
Starting an installation from the launchpad program
- Start the launchpad program.
- If you have not done so already, read
the release information by clicking Release notes.
- When you are ready to begin the installation, click Install IBM Rational Functional Tester. IBM Installation Manager is launched with Rational Functional
Tester selected.
If IBM Installation Manager is not installed on your system
or if an older version of IBM Installation Manager is installed, in addition
to the selected Rational Functional Tester, the entry for IBM Installation
Manager is also selected. Follow the on-screen instructions to complete the
installation.
- If this is a product update, click Update and
follow the instructions in the wizard to complete the update process. For
complete details, see Updating Rational Functional Tester.
Installing Rational Functional Tester by
using the Installation Manager GUI
The following steps describe installing the IBM Rational Functional Tester package
with the Installation Manager graphical
user interface (GUI).
- From the Installation Manager Start
page, click Install.
Note:
If a new version
of Installation Manager is
found, you are prompted to confirm that you want to install it before you
can continue. Click OK to proceed. Installation Manager
automatically installs the new version, stops, restarts, and resumes.
- The Install page of the Install Packages wizard lists all the packages
found in the repositories that Installation Manager searched.
If two versions of a package are discovered, only the most recent, or recommended,
version of the package is displayed.
- To display all versions of any package found by Installation Manager,
click Show all versions.
- To return to the display of only the recommended packages, click Show
only recommended.
- Click the IBM Rational Functional Tester package
to display its description in the Details pane.
- To search for updates to the IBM Rational Functional Tester package,
or for extension offerings that can be applied on IBM Rational Functional Tester,
click Check for Other Versions and Extensions.
Note:
For 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.
Installation Manager searches
for updates at the predefined IBM update repository for the product package.
It also searches any repository locations that you have set. A progress indicator
shows the search is taking place. You can install updates at the same time
that you install the base product package.
- If updates for the IBM Rational Functional Tester 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.
- Select the IBM Rational Functional Tester 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.
- 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.
Important:
If you are installing on Windows Vista,
then to enable users who do not have Administrator privileges to work with Rational Functional Tester, do not
choose a directory inside the Program Files directory (C:\Program Files\).
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.
Note:
Ensure that your installation path does not contain parenthesis.
- On the Location page, use create a package group to
install the IBM Rational Functional Tester 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 is:
- For Windows:C:\Program Files\IBM\SDP
- For Linux:/opt/IBM/SDP
Note:
If you are installing on Linux, ensure that you do not include
any spaces in the directory path.
Important:
On Windows
Vista, the Program Files directory is usually virtualized in order to
allow users who are not running as the administrator to have write access
to this protected directory. However, the virtualization workaround is not
compatible with Rational Functional Tester.
- 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.4.1
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 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.
- Click Next to continue.
- 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 IBM Rational Functional Tester package
will be installed.
- On the next Features page, select the package features that you
want 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 will
automatically enforce any dependencies with other features and display updated
download size and disk space requirements for the installation.
- When you are finished selecting features, click Next to
continue.
- On the next Help System Features page, select the required option
to access the help contents for the product. For more information
about the help configuration, see Web-based
help content.
- On the Summary page, review your choices before installing the IBM Rational Functional Tester 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.
- When the installation process is complete, a message confirms the
success 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 you want IBM Rational Functional Tester to
start when you exit.
- Click Finish to launch the selected package.
The Install Package wizard closes and you are returned to the Start page of Installation Manager.
Working with IBM Installation Manager
This section deals with some common tasks relating to IBM Installation Manager.
For more information, see the Installation Manager online
help or the Installation information center.
Note:
You can run
Installation Manager in silent mode to install, update, and uninstall packages.
For information on installing silently, see
Installation information center.
Installing Installation Manager on Windows
If you start the installation of your product from the launchpad
program, then the installation of IBM Installation Manager is
started automatically if it is not already installed on your workstation.
(For more information on this process, refer to Installing from the launchpad program.)
In other cases, you must manually start the installation of Installation Manager.
To
start the installation of Installation Manager manually:
- Run install.exe from the InstallerImage_win32
folder on the first installation disk.
- Click Next on the Install Packages page.
- Review the license agreement on the License Agreement page and
select I accept the terms in the license agreement to
accept. Click Next.
- Click the Browse button on the Destination
Folder page to change the installation location if required. Click Next.
- Click Install on the Summary page. When
the installation process is complete, a message confirms the success of the
process.
- Click Restart Installation Manager. IBM Installation Manager opens.
Installing Installation Manager on Linux
IBM Installation Manager is installed
by the launchpad. For more information on this process, refer to Installing from the launchpad program.
To
install Installation Manager manually:
- Open a terminal window with root user privileges.
- Run install from the InstallerImage_linux folder
on the first installation disk.
- Click Next on the Install Packages screen.
- Review the license agreement on the License Agreement page and
select I accept the terms in the license agreement to
accept. Click Next.
- If necessary, edit the installation directory location. Click Next.
- Click Install on the information summary
page. When the installation process is complete, a message
confirms the success of the process.
- Click Restart Installation Manager. IBM Installation Manager opens.
Starting Installation Manager on Windows
IBM Installation Manager should
be started from the launchpad program. Doing so starts Installation Manager with
a configured repository preference and selected Rational Functional Tester packages.
If you start Installation Manager directly,
then you must set a repository preference and choose product packages manually.
For more information, see Planning to install.
To
start Installation Manager manually:
- Open the Start menu from the Taskbar.
- Select All Programs -> IBM
Installation Manager -> IBM Installation Manager.
Note:
On Windows Vista operating system,
you must run Installation Manager as administrator: Right-click the program
shortcut and click Run as administrator.
Starting Installation Manager on Linux
IBM Installation Manager should
be started from the launchpad program. Doing so starts the Installation Manager with
a configured repository preference and selected Rational Functional Tester packages.
If you start Installation Manager directly,
then you must set repository preference and choose product packages manually.
For more information, see Planning to install.
To
start Installation Manager manually:
- Open a terminal window with root user privileges.
- Change directory to the installation directory for Installation Manager (by
default, /opt/IBM/InstallationManager/eclipse) and run IBMIM.
Uninstalling Installation Manager on Windows
To uninstall Installation Manager:
- Go to the Control Panel and double-click Add
or Remove Programs.
- Select IBM Installation Manager.
- Click Remove.
Uninstalling Installation Manager on Linux
IBM Installation Manager must
be uninstalled using the package management tool that is included with your Linux version.
To
uninstall Installation Manager manually on Linux:
- Open a terminal window with root user privileges.
- Change directory to the uninstallation directory of Installation
Manager. By default, this is /var/ibm/InstallationManager/uninstall.
- Run ./uninstall.
Working with test agents
Test agents are remote computers that are capable of running test
scripts.
You can use Rational TestManager or Rational ClearQuest Test Manager to coordinate
remote testing activities from a local computer.
To run test scripts remotely, you must perform the following steps:
- Install Rational Functional Tester on
the local computer.
- Install either IBM Rational TestManager v7.0.1.2 or Rational ClearQuest Test
Manager on the local computer.
- To work with TestManager, install the Rational Test Agent software, located
on the TestManager CD, and the Rational Agent Controller on the remote agent.
- To work with Rational ClearQuest Test Manager, install
the Rational Agent Controller on the remote agent. (You can install just the
Rational Agent Controller or the full Rational Functional Tester.)
- Start the Rational Test Agent software or the IBM Rational Agent
Controller on the remote computer.
- Enable environments on the remote system.
- Configure applications to run on the remote system.
Installing the Rational Test Agent on Windows
This topic describes how to install the Rational Test Agent on a Windows computer.
Here are the steps:
- Log on with administrative privileges.
- Insert the CD containing the Rational Test Agent software into your
CD drive. If the installation does not start automatically, perform
these steps:
- Click Start -> Run
- Type: cd_drive:\SETUP.EXE.
- Click OK.
- In the Software Setup page, click Next.
- In the Product List, select Rational Test Agent.
- Click Next.
- Select all of the defaults provided by the wizard. You
might need to restart the system to complete the installation.
- Click Finish in the last dialog box.
After installing the Rational Test Agent, you must install
the Rational Agent Controller, which you can find on the Rational Functional Tester CD.
Starting the Rational Test Agent on Windows
This topic describes how to start a Test Agent on a Windows computer.
To start the Rational Test Agent on Windows, perform these steps:
- Click Start -> Programs -> Rational Test Agent -> Rational Test -> Rational Test Agent.
- Enable the testing environments you want to use on the test agent.
- Configure the applications you want to test on the test agent.
Installing the Rational Test Agent on Linux
This topic describes how to install the Rational Test Agent on a Linux computer.
Before starting, be sure to uninstall all previous versions of Rational Functional Tester and disable
all of their environment variables.
Here are the steps:
- Log on with administrative privileges.
- Create the installation directory:
% mkdir
-p /usr/rational/test
- Insert the CD-ROM containing the Rational Test Agent software into your
CD drive.
If the CD does not auto-mount, enter the Linux mount command
at the prompt:
% mount /dev/cdrom /mnt/cdrom
- Go to the test directory:
% cd /usr/rational/test
- Enter the tar command to copy the Rational Test
Agent files to your hard drive:
% tar xzpf /mnt/cdrom/linux_agent.tar.gz
Starting the Rational Test Agent and the RAServer on Linux
This topic describes how to start the Rational Test Agent and the RAServer
on Linux.
Before you can run the Rational Test Agent, you must set the RATL_RTHOME environment
variable to /usr/rational/test by entering either of the
following commands:
% export RATL_RTHOME=/usr/rational/test
%
setenv RATL_RTHOME=/usr/rational/test
To start the Rational Test Agent on Linux, do the following:
- Set the environment variable LD_LIBRARY_PATH to libjava.so of
the currently used JRE.
- Set the CLASSPATH to <product installation directory>/bin/rational_ft.jar
- Execute the following command:
source <product
installation directory>/rtsetup.
- From the Test Manager installation directory, run RTsagt.
To start the RAServer for ClearQuest Test Manager remote execution,
enter the following command from the product installation directory:
ft_agent_start
You
can verify that the Test Agent is running by entering this command:
ps
-ef | grep rtprvd
You can verify that the RAServer is running
by entering this command:
ps -ef | grep RAServer
Enabling environments on Test Agents
This topic describes how to enable test environments on test agents.
The first time you start Rational Functional Tester,
it automatically enables your environment for running functional test scripts.
If you add a browser or add a new Java environment, you must enable the new
browser or Java environment.
If you use TestManager or Rational ClearQuest Test
Manager to coordinate your testing activities and run a functional test script
on a test agent computer, you must enable environments on the agent computer
that runs the script.
To enable environments:
- Do one of the following to start the Enabler.
- For Windows: Change to the directory where the rational_ft.jar file
is located (by default, <product installation directory>\FunctionalTester\bin)
and then from the command line, type:
java -jar rational_ft.jar
-enable
Note:
You may also need to type the full path to the IBM JRE,
which can be found, by default, at <product installation directory>\SDP\jdk\jre\bin
.
- For Linux: From the command line, type: /opt/IBM/SDP/ft_cmdline
-enable
- When the Enabler starts, click the Web Browsers tab
to enable browsers.
- Click the Java Environments tab to enable Java environments.
- Click OK.
Configuring applications on Test Agents
This topic describes how to configure applications on test agents.
Before you can test your applications, you must configure them. When
you configure your applications, you provide the name, path, and other information
about the application that you intend to test. This information is used during
record and playback to make the test script more reliable and portable. If
you use TestManager for remote execution on a Test Agent computer, you need
to configure applications on the agent computer that runs the script.
To configure applications, perform these steps:
- To start the Application Configuration Tool:
- For Windows: Change to the directory where the rational_ft.jar file
is located (by default, <product installation directory>\FunctionalTester\bin)
and then from the command line, type:
java -jar rational_ft.jar
-appConfig
Note:
You may also need to type the full path to
the IBM JRE,
which can be found by default at <product installation directory>\SDP\jdk\jre\bin.
- For Linux: From the command line, type: /opt/IBM/SDP/ft_cmdline
-appconfig
- Click Add. The Application Configuration
Tool starts.
- Select the application type and click Next.
- Take one of the following steps to configure the application:
- For a Java application, click Browse and
select the .class or .jar file of the Java application
you want to add.
- For an HTML application:
- Select the type of HTML to be tested (either Local or URL).
- Click Next.
- If you selected URL, enter the URL to use for testing and then proceed
to Step 6 below. If you selected Local, you can either browse to the location
of the .htm or .html file, or you can enter
the full path name of the file. Proceed to the next step.
- For executable files or batch files, click Browse and
make your selection
- Click Open.
The file name
and path appear in the Filename field.
- Click Finish.
The application
appears in the Applications list in the Application Configuration Tool.
- Review the information in the Detailed Information list.
For a Java application, the Name, Kind, Path, .class/.jar
file, and Working Dir fields are automatically filled in. The JRE, Classpath,
and Args fields are optional.
- Make any necessary edits to the information in the fields. For
details, see the product Help.
- Click Run to ensure you have properly configured
your application.
- Click OK or Apply to
save the changes you made.
Note:
After you add an application,
you can edit its information at any time by opening the Application Configuration
Tool and selecting the application in the Applications list. To remove an
application from the Applications list, select the application and click Remove.
Post-installation tasks
After you have installed your product package, complete the post-installation
tasks or configure your product package as required.
Post-installation checklist
After you have installed your product, complete several tasks to
configure and verify the installation.
Review the following information and ensure the post-installation
steps are completed as required.
__ 1.
Verify your installation and ensure that you can start your product.
__ 2.
Configure your license for Rational Functional Tester .
__ 3.
If you chose the option to download the help content for your product
during the installation process, then you must download the help content from
the Local Help System Updater site.
You can start Rational Functional Tester from
the desktop environment or a command-line interface.
- For Windows: To start the product from the desktop, click Start -> Programs -> IBM
Software Delivery Platform -> IBM Rational Functional Tester -> Java Scripting or Start -> Programs -> IBM Software Delivery Platform -> IBM Rational Functional Tester -> Net 2003 Scripting/.Net 2005 Scripting.
- For Windows: To start Rational Functional Tester Java Scripting
from the command line, type:
<product installation
directory>\eclipse.exe -product com.ibm.rational.rft.product.ide
- For Windows: To start Rational Functional Tester .Net
2003 Scripting or .Net 2005 Scripting from the command line, type:
"<product
installation directory>\Common7\IDE\devenv.exe"
- For Linux: To start Rational Functional Tester from
the command line, close the terminal from where you installed Rational Functional Tester,
start a new terminal and type:
<product installation
directory>\ft_starter
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.
Trial licenses that came with the 8.0 and later versions of some Rational products
expire 30 or 60 days after installation. You need to activate your product
in order to use it after the expiration date.
Using the Manage Licenses
wizard, you can 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 IBM Rational software products, 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 permits
a single, specific 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 specific individual, who can then use the Rational software
product. The Authorized User license does not entitle a second person to use
that product at any time, even if the licensed individual is not actively
using it.
Authorized User Fixed Term License
An IBM Rational Authorized
User Fixed Term License (FTL) permits a single, specific 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 end-user requests for access to the license keys; it will grant
access to the number of concurrent users that matches the number of licenses
the organization purchased.
License enablement
If you are installing a Rational software product 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 Rational Software Delivery Platform offerings are enabled
in two ways:
- Importing a product activation kit
- Enabling Rational Common
Licensing to obtain access to floating license keys
Note:
Trial licenses that came with the 8.0 and later versions of some Rational products
expire 30 or 60 days after installation. You need to activate your product
in order to use it after the expiration date. See support article
http://www.ibm.com/support/docview.wss?uid=swg21250404 on product activation for a flow chart of the activation process.
Activation kits
Product activation kits contain
the permanent license key for your trial Rational product. You purchase the
activation kit, download the activation kit .zip file to your local machine,
and then import the activation kit .jar file to enable the license for your
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 Rational desktop products
from the same license server
For more information on obtaining activation kits and Floating licenses,
see Purchasing licenses.
You can review license information for your installed packages,
including license types and expiration dates, from IBM Installation Manager.
To view license information:
- Start IBM Installation Manager.
- On the main page, click Manage Licenses.
The package vendor, current license types, and expiration dates are
displayed for each installed package.
Importing a product activation kit
To install your permanent license key, you must import the activation
kit from the download location or the product media by using IBM Installation
Manager.
If you have not purchased an activation kit, you must do this first.
If you have purchased a product or a product activation kit, insert the appropriate
CD or download the activation kit from IBM Passport Advantage to an
accessible workstation. The activation kit is packaged as a .zip file containing
a Java archive
(.jar) file. The .jar file contains the permanent license key and must be
imported to activate your product.
To import an activation kit .jar file and enable the new license
key:
- Start IBM Installation Manager.
- On the main page, click Manage Licenses.
- Select a package and click the Import Activation Kit button.
- Click Next. Details for
the selected package are shown, including the current license kind and the
product version range of the license.
- Browse to the path on the media CD or download location for the
activation kit; then select the appropriate Java archive (JAR) file and click Open.
- Click Next. The Summary
page displays the target install directory for the activation kit, the product
the new license applies to, and version information.
- Click Finish.
The product activation kit with its permanent license key is imported
to the product. The Manage Licenses wizard indicates whether the import is
successful.
Enabling floating licenses
If your team environment supports Floating license enforcement,
you can enable Floating licenses for your product and configure a connection
to obtain access to floating license keys.
Before enabling Floating license enforcement, you must obtain the
license server connection information from your administrator. For details
on license server, license key, and Rational Common Licensing administration,
see the IBM Rational License
Management Guide.
To enable floating licenses as the license type for specified packages
and configure license server connections:
- In the IBM Installation Manager for the Rational Software Delivery Platform,
click File -> Open -> Manage Licenses.
- Select a version of a package and then select the Configure
Floating license support button.
- Click Next.
- Click the Enable Floating license enforcement button.
- Configure one or more license server connections.
- Click an empty field in the Servers table
or click the Add button.
- If your administrator provided you with information for a redundant
server environment, click the Redundant Server button. Fields for the primary, secondary, and tertiary server names and
ports appear.
- Enter the host name of the license server in the Name field.
- (Optional) Enter a value in the Port field
for environments where a firewall is used. Do not assign a value to this port
unless your administrator instructs you to do so.
- For redundant server environments, enter the names and ports
(if required) for the secondary and tertiary servers.
- (Optional) You can click the Test Connection button
to confirm that the connection information is correct and that the server
is available.
- Click OK.
- Click Next.
- (Optional) Configure the license usage order for your shell shared
or custom packages. The order of licenses in the list determines the order
in which your package attempts to obtain access to license keys for a given
licensed package.
- Click Finish.
The Manage Licenses wizard indicates whether the floating licenses
configuration is successful.
Now, when you next open the enabled product, a connection is created
to the license server to obtain a license key from the pool of available floating
license keys.
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.
To purchase licenses and enable your product, complete the following
steps:
- Determine the type of license you want to purchase.
- Go to ibm.com(R) 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 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 .zip file.
Once you have downloaded the activation kit, you must import the product activation
.jar file using Installation Manager.
- 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 also go to Passport
Advantage to download the activation kit for your product. After importing
the activation kit, you have the option of switching from a floating to a
permanent license type if you use your computer offline for long periods.
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.
Configuring Web-based help
You might need to set up or change how you access help content.
Accessing Web-based help
Help for your product is available on a product information center
on the Internet. You can view this help from within the product.
During installation, the option to access help content from a remote
information center was selected. This is the default selection.
Your product help system can retrieve content installed with the
product and content from a remote server running an information center. The
information center for your product has the most current help content and
when your product is configured to retrieve content from a remote information
center, the contents of the information center can be accessed by selecting Help -> Help Contents to
open your help system.
sThe information center for your product
is available from the following URL: http://publib.boulder.ibm.com/infocenter/rfthelp/v8r0m0/index.jsp.
Follow
these steps to check your connection to the information center:
- Click Windows -> Preferences to open the Preferences window
- Select Help -> Content.
- Ensure that Include help content from a remote infocenter is
selected.
- Ensure that the URL for your product information center is in the
list of available information centers. If your information center is not listed,
complete the following steps:
- Click Add.
- In the Name field, type a name for the
connection.
- In the Host field, type publib.boulder.ibm.com
- In the Path field, type /infocenter/rfthelp/v8r0m0.
- Select Use default port.
- Click OK.
- Select the entry for your product information center.
- Click Test Connection.
Connection Successful is displayed if
the connection is made. If Connection failed is
displayed, verify that you have an active Internet connection and check the
settings.
Downloading help content from the Local Help System Updater site
This file explains how to download help content from the Local
Help System Updater site. Most help content is not installed when you install
your product. To access all help content locally, you need download it from
the IBM Local Help System Updater Web site.
During installation, the help access option, Download help
and access the content locally, was selected. Before using the
help for the product, you have to download the help to your local system.
If you the help system window is open, close it before you start the following
procedure.
To download the help content from the Local Help System Updater
site:
- With your product open, click Help -> Local Help Updater. The
Updater site opens in a separate browser window.
- On the Public Sites page, select the URL of
the help to download.
- 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.
- When the download is completed, open the help in the product by
selecting Help -> Help Contents.
The help that you selected is installed on your system. The files
will be updated automatically each time you start the application and an Internet
connection is available.
Delivering help content from an intranet server
You can set up an intranet server behind a firewall to provide
help content to users. In this way, users do not have to download and save
help content to their computers. Depending on your security requirements and
organizational needs, you can provide help content to users from an intranet
server. This arrangement frees up disk space on users' computers, because
one copy of the help content is stored on a server. You can also make sure
that all users have the latest help content from IBM with a single update to the intranet
server.
Providing help content on an intranet server requires deploying the
enterprise help.WAR application on the server. You must have an application
server for this purpose.
See Installation Manager information center for the updated
instructions on setting up an intranet server for help content.
Because
each enterprise is different, an example shows the procedures of setting up
the application server and deploying the help.WAR application. For this example,
the procedures show how to deliver help content with the open-source Apache
Tomcat Application Server. The basic procedure applies to all servers; the
specifics for your server might vary. Review the deployment instructions for
your application server.
This example uses Apache Tomcat 6.0. You can
download the server application from http://tomcat.apache.org.
Note:
Apache Tomcat 6.0 requires the Java 2
Standard Edition (J2SE) Runtime Environment (JRE), version 5.0 or later.
To
set up the Apache Tomcat Application server for providing help content:
- Download and install according to the included instructions the
J2SE JRE: http://java.sun.com/j2se.
Note:
You can also use the full JDK rather than just the JRE. In this
case set your JAVA_HOME environment variable to the path name of the directory
into which you installed the JDK. For example, use one of these environment
variables: setc:\j2sdk5.0 or /usr/local/java/j2sdk5.0.
- Set an environment variable named JRE_HOME to the pathname of the
directory into which you installed the JRE. For example, set one of these
environment variables: c:\jre5.0 or /usr/local/java/jre5.0.
- Unpack the binary distribution files into a convenient location
so that the distribution is located in its own directory, which is typically
named apache-tomcat-version. For
the purposes of the remainder of this document, the name $CATALINA_HOME is
used to refer to the full path name of the release directory.
- Place the Help.WAR in the webapps folder: $CATALINA_HOME\webapps.
- Start Apache Tomcat by entering this command (Windows): $CATALINA_HOME\bin\startup.bat. After startup, the default Web applications that Apache Tomcat includes
are available at this address: http://localhost:8080/.
- After you open the startup page, you can access the help system
by adding help/index.jsp to the end of your URL: http://localhost:8080/help/index.jsp.
- To enable your users to access the help content from your application
server, provide the users with the server, the port, and the path to the help
system.
- With this information available, users start the workbench, and
then click Window -> Preferences.
- Users select the Help preferences, expand it, and select Include
help content from a remote infocenter, and then click Add.
- Users type the server name, host, path, and port in the appropriate
fields, and then click OK.
- To obtain updated user assistance, navigate to the update window
and follow the installation and update instructions there: http://localhost:8080/help/updater/updatewar.jsp
- To update the help content, you must clear the cache. Otherwise,
updates are not reflected in the browser. Perform these steps to clear the
cache in preparation for an update:
- Shut down the Apache Tomcat application server by entering this
command: $CATALINA_HOME\bin\shutdown.bat.
- Navigate to the $CATALINA_HOME\work\Catalina\localhost directory,
and delete the help folder, which contains your uncompressed Web application.
- Copy your new help.WAR file into the $CATALINA_HOME\webapps
folder, and restart the Apache Tomcat application server.
Changing the way you access help content
You can change the way that you obtain help content.
During
the installation process, a help content access method was selected. Close
the help browser before you change the way you access help content.
To change the way that you access help content:
- Click Windows -> Preferences. The Preferences window
opens.
- Expand the Help entry, and then click Content.
A list of the information center or centers opens. Depending on the access
method that was chosen, complete one of the following procedures.
- To change from accessing help content from an information center on
an IBM Web site to accessing help content on an intranet server, follow these
steps:
- Disable the link to the internet site by selecting the internet
URL in the Contents list, and then clicking Disable.
- Click Add; then name the intranet connection,
specify the intranet URL for the server that contains the help content, and
then click OK.
- Click OK to close Preferences.
- Click Help -> Help
Contents, to open your help.
- To change from accessing help content from an information center on
an IBM Web site to downloading and accessing help content locally, follow
these steps:
- Ensure that Include help content from a remote infocenter is
selected.
- Disable the link to the product Information Center by selecting
that connection in the Contents list, and then clicking Disable.
- Click Add; then enter a name for the
local help connection. Specify the localhost Host IP address 127.0.0.1 and
path /help. Select any unused port number, and then
click OK.
- Save any work and close and restart the product.
- Follow the instructions in Downloading help content from the Local Help System Updater site to
download help content.
- To change from accessing help content locally to accessing help content
from an IBM Web site, follow these steps:
- Ensure that Include help content from a remote infocenter is
selected.
- Disable the link to localhost by selecting that connection in
the Contents list, and then clicking Disable.
- Click Add; then name the connection,
specify the Internet URL for the IBM Web site that contains the help content,
and then click OK. This URL might already be available
in the list of connections. If it is listed, select the connection and click Enable.
- Click OK to close Preferences.
- Click Help -> Help
Contents, to open your help.
- To change from accessing help content locally to accessing help content
from an intranet server, follow these steps:
- Ensure that Include help content from a remote infocenter is
selected.
- Disable the link to localhost by selecting that connection in
the Contents list, and then clicking Disable.
- Click Add; then name the connection,
specify the intranet URL for the server that contains the help content, and
then click OK.
- Click OK to close Preferences.
- Click Help -> Help
Contents, to open your help.
- To change from accessing help content from an intranet server to downloading
and accessing help content locally, follow these steps:
- Ensure that Include help content from a remote infocenter is
selected.
- Disable the link to the intranet server by selecting that connection
in the Contents list, and then clicking Disable.
- Click Add; then enter a name for the
local help connection. Specify the localhost Host address 127.0.0.1 and
path /help. Enter any unused port number, and then
click OK.
- Save any work and close and restart the product.
- Follow the instructions in Downloading help content from the Local Help System Updater site to
download help content.
- To change from accessing help content from an intranet server to accessing
help from an IBM Web site, follow these steps:
- Disable the link to your intranet site by selecting the intranet
URL in the Contents list, and then clicking Disable.
- Click Add; then name the connection,
specify the URL for the IBM Web site that contains the help content, and then
click OK.
- Click OK to close Preferences.
- Click Help -> Help
Contents, to open your help.
Updating help content
You can use the Local Help System updater to update local help
content without restarting your product. If an Internet connection is available,
the local help content is automatically updated each time your start your
product.
Before you can update local help content, you must initially download
the help content for your product from the Local Help System Updater Web site.
See Downloading help content from the Local Help System Updater site for downloading help
content. An Internet connection is required.
Updates are automatically installed each time you start the product,
if you have an Internet connection. If you want to update the help without
restarting the product, follow these steps.
- Close the product help system window.
- Open the Local Help System Updater by selecting Help -> Local Help Updater. The
Updater site opens in a separate browser window.
- Click the Installed Features tab.
- Click Search for Updates If
updates to the content you have installed are available, they are installed
to your help system. A progress bar indicates the status of the request.
- When the update is completed, open the help in the product by selecting Help -> Help Contents.
Removing help content
Use the Local Help System Updater to remove installed help content.
Use this procedure if you have downloaded help features using the
Local Help System Updater and decide to remove help content.
To use the Local Help System Updater to remove installed content:
- Close the product help system window.
- Open the Local Help System Updater by selecting Help -> Local Help Updater. The
Updater site opens in a separate browser window.
- Click the Installed Features tab.
- Select the features to remove, and then click Remove The help features that you selected are removed from your system.
A progress bar indicates the status of the request.
- When the removal is completed, open the help in the product by
selecting Help -> Help Contents.
Updating Rational Functional Tester
You can install updates for packages that were installed with IBM Installation
Manager. Package updates provide fixes and updates to installed features and
might also include new features that you can install using the Modify Packages
wizard.
By default, Internet access is required unless your repository preferences
points to your local update site.
Each installed package has the location
embedded for its default IBM update repository. For Installation Manager to search
the IBM update
repository locations for the installed packages, the preference Search
service repositories during installation and updates on the Repositories
preference page must be selected. This preference is selected by default.
See
the Installation Manager help for more information.
Note:
Close all programs
that were installed using Installation Manager before updating.
To find and install product package updates:
- From the Start page of the Installation Manager, click Update.
- If IBM Installation Manager is not
detected on your system or if an older version is already installed, then
you must continue with the installation of the latest release. Follow the
instructions in the wizard to complete the installation of IBM Installation Manager
- In the Update Packages wizard, select the location of the package
group where the Rational Functional Tester product
package you want to update is installed or select the Update All check
box, and then click Next. Installation
Manager searches for updates in its repositories and the predefined update
sites for Rational Functional Tester.
A progress indicator shows the search is taking place.
- If updates for a package are found, then they are displayed in
the Updates list on the Update Packages page below
their corresponding package. Only recommended updates are displayed by default.
Click Show all to display all updates found for the
available packages.
- To learn more about an update, click the update and review its
description under Details.
- If additional information about the update is available, a More
info link will be included at the end of the description text.
Click the link to display the information in a browser. Review this information
before installing the update.
- Select the updates that you want to install or click Select
Recommended to restore the default selections. Updates that have
a dependency relationship are automatically selected and cleared together.
- Click Next to continue.
- On the Licenses page, read the license agreements for the selected
updates. On the left side of the License page, the
list of licenses for the updates you selected is displayed; click each item
to display the license agreement text.
- If you agree to the terms of all the license agreements, click I
accept the terms of the license agreements.
- Click Next to continue.
- On the Summary page, review your choices before installing the
updates.
- If you want to change the choices you made on previous pages,
click Back, and make your changes.
- When you are satisfied, click Update to
download and install the updates. A progress indicator shows the percentage
of the installation completed.
Note:
During the update process, Installation Manager might prompt
you for the location of the repository for the base version of the package.
If you installed the product from CDs or other media, they must be available
when you use the update feature.
- Optional: When the update process completes, a message
that confirms the success of the process is displayed near the top of the
page. Click View log file to open the log file for
the current session in a new window. You must close the Installation Log window
to continue.
- Click Finish to close the wizard.
- Optional: Only the features that you already have installed
are updated using the Update wizard. If the update
contains new features that you would like to install, run the Modify wizard
and select the new features to install from the feature selection panel.
Modifying installations
The Modify Packages wizard in the IBM Installation Manager enables you to
change the language and feature selections of an installed product package.
You can also use the Modify Packages wizard to install new features that might
be included in a package update, such as a refresh pack.
By default, Internet access is required unless the repository preferences
points to a local update site. See the Installation Manager help for more
information.
Note:
Close all programs that were installed using Installation
Manager before modifying.
To modify an installed product package:
- From the Start page of the Installation Manager, click the Modify icon.
- In the Modify Packages wizard, select the installation location
for the Rational Functional Tester product
package and click Next.
- On the Modify page, under Languages, select the languages for the
package group, then click Next. The corresponding
national language translations for the user interface and documentation for
the packages will be installed. Note that your choices apply to all packages
installed under this package group.
- On the Features page, select the package features that you want
to install or remove.
- To learn more about a feature, click the feature and review
the brief description under Details.
- If you want to see the dependency relationships between features,
select Show Dependencies. When you click a feature,
any features that depend on it and any features that are its dependents are
shown in the Dependencies window. As you select or exclude 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.
- When you are finished selecting features, click Next.
- On the Summary page, review your choices before modifying the installation
package, and then click Modify.
- Optional: When the modification process completes,
click View Log File to see the complete log.
Reverting updates to previous versions
You can remove an update to some packages to revert to a previous
version by using the Roll Back Packages wizard of IBM Installation Manager.
During the rollback process, Installation Manager must access files
from the earlier version of the package. By default, these files are stored
on your computer when you upgrade to a new package. If you have deleted the
files that are saved locally for rollback or cleared the Save files
for rollback check box in the Preferences page (File
> Preferences > Files for Rollback) while upgrading, you will
not be able to roll back to the previous version without the media or repositories
that were used to install that version of the package.
Use the rollback feature if you have applied an update to a product
package and decide later that you want to remove the update and revert to
the earlier version of the product. When you use the rollback feature, Installation
Manager uninstalls the updated resources and reinstalls the resources from
the previous version. You can only roll back one version level at a time.
For
more information, see the Installation Manager online help or Information
Center.
To revert an update to a previous version, complete the following
steps:
- On the Start page, click Roll back Packages.
- In the Rollback wizard, from the Installation Packages list,
select the package that you want to revert to the previous version.
- Follow the instructions in the wizard.
Uninstalling Rational Functional Tester
The Uninstall Packages option in the Installation Manager enables
you to uninstall packages from a single installation location. You can also
uninstall all the installed packages from every installation location.
To uninstall the packages, you must log in to the system using the
same user account that you used to install the product packages.
Note:
Before
you uninstall Rational Functional Tester, close the Eclipse and Visual Studio IDEs, as well
as any open Web browsers, and all other applications that are enabled by Functional Tester.
To uninstall the packages:
- Close the programs that you installed using Installation Manager.
- On the Start page click Uninstall Packages.
- In the Uninstall Packages page, select the Rational Functional Tester product
package that you want to uninstall. Click Next.
- In the Summary page, review the list of packages that will be uninstalled
and then click Uninstall. The Complete
page is displayed after the uninstallation finishes.
- Click Finish to exit the wizard.
IBM Packaging
Utility
Use IBM Packaging
Utility software to copy product packages to a repository that can be placed
on a Web server available over HTTP or HTTPS.
Packaging Utility software is located on the Enterprise Deployment CD for
each platform (Windows and Linux) that is included with Rational Functional Tester. If you
want to place a repository that contains a Rational Functional Tester package
on a Web server that will be available over HTTP or HTTPS, you must use Packaging
Utility to copy the product package of Rational Functional Tester into
the repository.
Use this utility to perform the following tasks:
- Generate a new repository for product packages.
- Copy product packages to a new repository. You can copy multiple product
packages into a single repository, thereby creating a common location for
your organization from which product packages can be installed using IBM Installation
Manager.
- Delete product packages from a repository.
Refer to the online help for Packaging Utility for full instructions using
the tool.
Installing Packaging Utility
IBM Packaging
Utility must be installed from the Enterprise Deployment CD before it can
be used to copy the Rational Functional Tester product
package.
Use the following steps to install IBM Packaging Utility software from the
Enterprise Deployment CD:
- Navigate to the Enterprise Deployment CD for the appropriate platform
and extract the zip file from the CD.
- Navigate to the Packaging Utility directory and extract the Packaging
Utility installation package from the compressed file (pu.disk_win32.zip or
pu.disk_linux.zip).
- Locate the Packaging Utility installer executable.
- For Windows: Change to the InstallerImage_win32 directory
in the area where the pu.disk_win32.zip file was unpacked. Locate the installer
executable "install.exe".
- For Linux:
Change to the InstallerImage_linux directory in the area where the pu.disk_linuz.zip
file was unpacked. Locate the installer executable "install".
- Start the installer executable and follow the instructions in the
wizard to install the Packaging Utility.
- If IBM Installation
Manager is not detected on your workstation, you are prompted to install it
and then the installation wizard starts. Follow the instructions in the wizard
to complete the installation of Installation Manager. See Installing Installation Manager on Windows for
details.
- When the installation of Installation Manager completes, or if
it is already on your computer, Installation Manager starts and automatically
begins the Install Packages wizard.
- Follow the instructions in the Install Packages wizard to complete
the installation.
Copying product packages to an HTTP server using Packaging Utility
To
create a repository on an HTTP or HTTPS server, you must use Packaging Utility
to copy the product package for Rational Functional Tester.
Note that this method does not copy the optional software that
is included with the Rational Functional Tester installation
image. Only the Rational Functional Tester files
that are installed using IBM Installation Manager are copied.
Note also
that Packaging Utility can be used to combine multiple product packages into
a single repository location. See the Packaging Utility online help for more
information.
To copy product packages with Packaging Utility:
- If you are copying from a CD image, perform these tasks:
- Insert the first installation CD into your CD drive.
- For Linux: Mount the CD drive.
- If autorun is enabled on your system, the Rational Functional Tester launchpad
program automatically opens. Close the launchpad program.
- Start Packaging Utility.
- On the main page of the utility, click Copy Packages. The Prerequisite page opens, and presents two options:
- I will be downloading product packages from IBM Web
- I will be obtaining the product packages from other sources
- Click I will be downloading product packages from IBM
Web.
Note:
You can use the I will be obtaining
the product packages from other sources option if you have already
defined an accessible repository.
- Click Next to advance to the Source page.
If there are no product packages to select, you must open a repository that
contains product packages.
- To open a repository, click the Open repository button. The Open Repository window opens.
Note:
A
repository can be a path to a file on the local file system, a disk drive
containing the first CD of the product, or a URL to a file on a server.
- To define a repository location, click the Repository Location Browse button,
and then navigate to the Repository location (the common root directory) that
contains the disk images. For example, if the product files (disk1, disk2,
and so on) reside in C:\productA\unzip, you should navigate there and select
the repository.config file, the diskTag.inf, the jar file, or a zip file.
- Click OK to define the repository location
and to close the Browse to a repository directory window.
- On the Destination page, click the Browse button
and select an existing repository directory, or create a new folder to store
the products.
- After you specify a repository for the selected product packages
and any fixes, click OK to close the Browse
to a directory window. The file path that you
just defined is listed in the Directory field on the Destination page.
- Click Next to advance to the Summary page. The Summary page displays the selected product
packages that will be copied into the destination repository. This page also
lists the amount of storage space that the copy requires, as well as the amount
of available space on the drive.
- Click Copy to copy the selected product
packages to the destination repository. A status bar opens at the
bottom of the wizard indicating how much time is remaining in the copy process. After the copy process is finished, a Complete page
opens and displays all of the product packages that were copied successfully.
- Click Done to return to the Packaging Utility
main page.
Now that you have used Packaging Utility to copy the Rational Functional Tester installation
files into a repository, you can place the repository on a Web server and
make the directories and files available over HTTP. (The repository can also
be placed on a UNC drive.)
For the latest information about working
with IBM Packaging Utility, visit the IBM Packaging Utility Information Center
at http://publib.boulder.ibm.com/infocenter/install/v1r2/index.jsp.
Notices
(C) Copyright IBM Corporation 2000, 2008.
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:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, 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 Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those
Web sites. The materials at those Web sites are not part of the materials
for this IBM product and use of those Web sites 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
20 Maguire Road
Lexington, Massachusetts 02421-3112
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 Documentation 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.
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.
Trademarks and service marks
The following terms are trademarks of International Business Machines Corporation
in the United States, other countries, or both:
- developerWorks(R)
- IBM
- Passport Advantage
- Rational
- WebSphere(R)
- iSeries
- zSeries
Microsoft and Windows are trademarks of Microsoft Corporation
in the United States, other countries, or both.
Linux is a trademark of Linus Torvalds in the United States, other countries,
or both.
Other company, product or service names, may be trademarks or service marks
of others.