IBM Rational Robot, Version 7.0.2

Installation Guide

Overview

About IBM Rational Robot

Rational Robot is an automated testing tool for functional and regression testing of .NET, Java , Web, PowerBuilder, Delphi, and other GUI-based applications. It includes a powerful test editor, easy-to-learn test script language and an extensive function library.

Rational Robot supports the following applications for testing:

• Microsoft^(R) .Net Framework version 1.1 or 1.2 for testing .Net applications
• Oracle Forms 6i for testing Oracle applications
• Delphi Framework version 4, 5, 6, and 7 for testing Delphi applications
• Power Builder version 5, 6, 7, 8, 9, 10 and 10.5
• Java 1.1, 1.2, 1.3, 1.4
• Visual Basic version 6 and VC++
• HTML IE6 and IE7 and Netscape 4.7x extension

IBM Installation Manager

IBM Installation Manager offers several time-saving features, which you can use to complete the following tasks:

• Install product packages
• Search for and install updates to installed product packages
• Modify installed product packages
• Revert installed product packages to earlier versions
• Uninstall product packages

For more information about IBM Installation Manager, visit the Installation Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1m0r0/index.jsp.

Installation requirements

For the most up-to-date, detailed system requirements, refer to http://www.ibm.com/software/awdtools/tester/robot/sysreq/index.html.

Hardware requirements

Software requirements

Operating system

The following operating systems are supported for this product in 32-bit mode:

• Microsoft Windows^(R) XP Professional with Service Pack 1 or 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 with Service Pack 1

Supported virtualization software

The following virtualization software is supported:

• Citrix Metaframe version 8 running on Windows Server 2003 Standard Edition or Windows Server 2003 Professional Edition
• Microsoft Terminal Server (WIN2K)/ MTS Server client

Additional software requirements

• Microsoft .Net Framework version 1.1 or 1.2 for testing .Net applications

User privileges requirements

• 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 (the application that installs and updates Rational Robot)
    • Install or update a product offering
    Note:
    To enable users who are not the Administrator to work with Rational Robot on a Windows Vista system:

    • Do not install Rational Robot 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.
  • For other supported Windows versions, you must have a user ID that belongs to the Administrators group.

Planning to install

Preinstallation tasks

1. Confirm that your system meets the requirements described in the section Installation requirements.
2. Confirm that your user ID meets the required access privileges for installing the product. See User privileges requirements.
3. Read the section Planning to installand give particular attention to the topic Upgrade from previous versions.
   CAUTION:
   Create a backup copy of all the Robot project assets before you attempt to uninstall Rational products

Uninstall Rational products

The following products, which were installed with MSI based install technology, must be uninstalled:

• Rational ClearQuest
• Rational ClearCase
• Rational RequisitePro
• Rational Project Console
• Rational Robot
• Rational Test Manager
• Rational SoDA

If the rationaluninstalltool.exe tool is not run prior to installing Robot 7.0.2, the Installation Manager will warn that you have a previous version of a Rational product installed, which must be removed before Installation Manager can continue. The rationaluninstalltool.exe tool offers two uninstall scenarios; a clean uninstall and a user data preserved uninstall. The clean uninstall completely removes the Rational install directory as well the Rational Software registry keys under both HKEY_LOCAL_MACHINE and HKEY_CURRENT_USER. The user data preserved uninstall does not remove files that are used to customize the environment. Use this method if you want to save customizations from your current deployment for your Installation Manager deployment.

To remove Rational products with the rationaluninstalltool.exe tool:

1. Copy the rationauninstalltool.exe to the computer on which you must remove the Rational products
2. From a Windows Command Prompt, run rationaluninstalltool.exe.
3. Consult the command reference below.

rationaluninstalltool.exe <log file name> [-c]

Description

Use the rationaluninstalltool.exe command with the following subcommands:

• <log file name>Specify the name and location of the log file you want the logging information stored.
• [ -c ]Requests that everything is removed. The clean uninstall completely removes the Rational install directory as well the Rational Software registry keys under both HKEY_LOCAL_MACHINE and HKEY_CURRENT_USER.

Installation scenarios

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

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.

Installing from CDs

In this installation scenario, you have the CDs that contain the product package files, and typically you are installing Rational Robot on your own workstation. See Installing Rational Robot 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 Robot on your own workstation. See Installing Rational Robot 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 Robot from a single location. See Installing Rational Robot 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 Robot 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 Robot directly from an HTTP or HTTPS Web server. This utility is provided with Rational Robot. 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 Robot installation CDs are not placed in the package; only the Rational Robot installation files are placed in the package. See Installing Rational Robot from a repository on an HTTP or HTTPS Web server: task overview and Placing Rational Robot on an HTTP Web server: task overview for an overview of the steps.

Deciding which features to install

When you install the Rational Robot 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.

Features

Upgrade from previous versions

Upgrading from previous versions of Rational Robot

Rational Robot version 7.0.2 cannot be installed on a computer on which previous versions of Rational Robot is installed. All previous versions of Rational Robot must be uninstalled before attempting to install Rational Robot version 7.0.2. During the installation of Rational Robot version 7.0.2, if an installation of the previous version is detected, the installation routine will stop. See Uninstall Rational products topic for instructions on uninstalling the software.

Migrating test assets from earlier versions of Rational Robot

All test assets from earlier versions of Rational Robot, 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.

Installation repositories

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, updates and new features.

Setting repository preferences in Installation Manager

To add, edit, or remove a repository location in Installation Manager:

1. Start Installation Manager.
2. 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.
3. On the Repositories page, click Add Repository.
4. In the Add repository window, type the URL of the repository location or browse to it and set a file path.
5. 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.
6. Click OK to exit.

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 Robot from CDs: task overview

The following are the general steps for installing from CDs:

1. Complete the preinstallation steps listed in Preinstallation tasks.
2. Insert the first installation CD into your CD drive.
3. If autorun is enabled on your system, the Rational Robot launchpad program automatically opens. If autorun is not enabled, start the launchpad program. Refer to Starting the launchpad program for details.
4. Start the installation of Rational Robot from the launchpad. For details, see Starting an installation from the launchpad program.

   If IBM Installation Manager is not detected on your workstation, then you must install it to continue. 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 automatically.

5. Click Install and follow the instructions in the Install Packages wizard to complete the installation. For details, see Installing Rational Robot by using the Installation Manager GUI.
6. Configure your license using the Rational License Key Administrator. Refer to Managing licenses for details.
7. Install optional software that is included with Rational Robot. For more information, see Installing optional software.

Installing Rational Robot from an electronic image on your workstation: task overview

The following are the general steps for installing Rational Robot from an electronic installation image:

1. Ensure that your workstation has sufficient space to store the file that you download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements.
2. Download all required parts for the product image from IBM Passport Advantage to a temporary directory.
3. Extract the installation image from the downloaded file and verify that the installation image is complete. See Verifying and extracting electronic images for details.
4. Continue with the steps in Installing from an electronic image below.

Installing from an electronic image

1. Complete the preinstallation steps listed in Preinstallation tasks.
2. Start the launchpad program. Refer to Starting the launchpad program for details.
3. Start the installation of Rational Robot from the Launchpad. For details, see Starting an installation from the launchpad program.
   • 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, Installation Manager starts and automatically begins the Install Packages wizard.

     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.
   • If IBM Installation Manager is detected on your workstation and 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.
     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.
4. Follow the instructions in the Install Packages wizard to complete the installation. For complete details, see Installing Rational Robot by using the Installation Manager GUI.
5. Configure your license using the Rational License Key Administrator. Refer to Managing licenses for details.
6. Install optional software that is included with Rational Robot. For more information, see Installing optional software.

Installing Rational Robot from an electronic image on a shared drive: task overview

The following steps are performed by the person who places the installation image on a shared drive.

1. Ensure that your shared drive has sufficient disk space to store the file that you download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements for details.
2. Download all required parts for the product image from IBM Passport Advantage to a temporary directory on the shared drive.
3. 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 Robot from the installation files on the shared drive:

1. Change to the disk1 directory on the shared drive containing the installation image.
2. Follow the steps in Installing from an electronic image.

Installing Rational Robot from a repository on an HTTP or HTTPS Web server: task overview

These steps assume the repository containing the package for Rational Robot has been created on the HTTP or HTTPS Web server.

To install the Rational Robot package from a repository on an HTTP or HTTPS server:

1. Complete the preinstallation steps listed in Preinstallation tasks.
2. 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.
3. Start Installation Manager. Refer to Starting Installation Manager on Windows for details.
4. Set the URL of the repository containing the package of Rational Robot as a repository preference in Installation Manager. See Setting repository preferences in Installation Manager.
5. 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 Robot by using the Installation Manager GUI.
6. Configure your license using the Rational License Key Administrator. Refer to Managing licenses for details.
7. Install optional software included with Rational Robot. For more information, see Installing optional software.

Placing Rational Robot on an HTTP Web server: task overview

To prepare Rational Robot for installation from a repository located on an HTTP Web server:

1. Ensure that your HTTP or HTTPS Web server has sufficient disk space to store the product package. Refer to Hardware requirements.
2. Ensure that your workstation has sufficient disk space to store the file that you download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements
3. Download all required parts for the product image from IBM Passport Advantage to a temporary directory on your workstation.
4. 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.
5. Install on your workstation the IBM Packaging Utility from the Enterprise Deployment CD (or electronic disk) appropriate for your platform.
6. Using the Packaging Utility, copy the Rational Robot product package.
7. Copy the output of the Packaging Utility to an HTTP or HTTPS Web Server.
8. Copy the installation files for IBM Installation Manager from the Enterprise Deployment CD to a shared drive.
9. Instruct users in your organization to install Installation Manager.
10. Provide users the URL for the repository that contains the Rational Robot product package you created earlier.

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 Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1m0r0/index.jsp.

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:

1. Run install.exe from the InstallerImage_win32 folder on the first installation disk.
2. Click Next on the Install Packages page.
3. Review the license agreement on the License Agreement page and select I accept the terms in the license agreement to accept. Click Next.
4. Click the Browse button on the Destination Folder page to change the installation location if required. Click Next.
5. Click Install on the Summary page. When the installation process is complete, a message confirms the success of the process.
6. Click Finish. 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 Robot 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:

1. Open the Start menu from the Taskbar.
2. Select All Programs -> IBM Installation Manager -> IBM Installation Manager.

Uninstalling Installation Manager

1. Click Start -> Settings -> Control Panel, and then double-click Add or Remove Programs.
2. Select the entry for IBM Installation Manager and click Remove.

Silently installing and uninstalling Installation Manager

Silently installing Installation Manager

To install Installation Manager silently, unzip the installer and switch to the InstallerImage_platform subdirectory, then use the following commands:

• installc --launcher.ini silent-install.ini -log <log file path and name> . For example: installc --launcher.ini silent-install.ini -log c:\mylogfile.xml
• For other platforms: install --launcher.ini silent-install.ini -log <log file path and name>. For example, install --launcher.ini silent-install.ini -log /root/mylogs/mylogfile.xml

After installation, you can use Installation Manager or the Installation Manager installer to silently install packages.

Silently uninstalling Installation Manager

To silently uninstall Installation Manager on Windows:

1. From a command line, go to the uninstall directory for the Installation Manager. By default, this is C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\uninstall.
2. Enter the following command: uninstallc.exe --launcher.ini silent-uninstall.ini

Verifying and extracting electronic images

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.

Extracting the downloaded files

Extract each compressed file to the same directory.

Installing from the launchpad program

Use the launchpad program to start the installation of Rational Robot 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 Robot package. If you install and start Installation Manager directly, then you must set repository preferences manually.

To install from the launchpad:

1. Complete the preinstallation tasks described in Preinstallation tasks, if you have not done so already.
2. Start the launchpad program. See Starting the launchpad program.
3. Start the installation of Rational Robot. 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 Robot by using the Installation Manager GUI.

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 Robot launchpad starts automatically when you insert the 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:

1. Insert the IBM Rational Robot CD into your CD drive.
2. If autorun is enabled on your system, the IBM Rational Robot launchpad program automatically opens. If autorun is not enabled on your system, run launchpad.exe located in the root directory of the CD.

Starting an installation from the launchpad program

1. Start the launchpad program.
2. Select a language and click OK.
3. If you have not done so already, read the release information by clicking Readme.
4. When you are ready to begin the installation, click Install IBM Rational Robot.
5. 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.
6. Follow the instructions in the wizard to complete the installation of IBM Installation Manager. Refer to Installing Installation Manager on Windows for more information.
7. When the installation of IBM Installation Manager completes successfully, click Finish to close the wizard. After the installation is complete, IBM Installation Manager opens automatically.
8. If this is a new installation, click Install and follow the instructions in the wizard to complete the installation process. For complete details, see Installing Rational Robot by using the Installation Manager GUI
9. 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 Robot.

Installing Rational Robot by using the Installation Manager GUI

1. 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.
2. 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 product found by Installation Manager, click Show all versions.
   • To return to the display of only the recommended product, click Show only recommended.
   1. Optional: To read the description of the IBM Rational Robot version, select the version check box. The description is displayed under Details .
   2. Optional: To search for updates to the IBM Rational Robot product, click Check for Other Versions and Extensions.
      Note:
      For Installation Manager to search the predefined IBM update repository locations for the installed products, the preference Search service repositories during installation and updates on the Repositories preference page (File -> Preferences) 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.
3. If updates for the IBM Rational Robot product 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.
4. Select the IBM Rational Robot 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.
5. On the Licenses page, read the license agreement for the selected package.
   1. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreement.
   2. Click Next to continue.
6. On the Locations page, accept the default path for the shared resource directory or type the path. You can also browse to select the path. Click Next to continue.
7. On the Locations page, type a path for the installation directory or accept the default path.
8. On the Features page, select the package features that you want to install. For installing the Net Support feature to test Net applications, you must have the .Net framework installed in your computer.
   1. Optional: To see the dependency relationships between features, select Show Dependencies.
   2. Optional: Click a feature to view its brief description under Details.
   3. Select or clear features in the packages. Installation Manager will automatically enforce any dependencies with other features and display updated download size and disk space requirements for the installation.
   4. When you are finished selecting features, click Next to continue.
9. On the License page, type the TCP/IP port and the host name of the Rational common licensing server if the license server is set up. You can configure the license after you install the product using the Rational License Key Administrator.
10. On the Summary page, review your choices before installing the IBM Rational Robot package. If you want to change the choices that you made on previous pages, click Back and make your changes. To see the repository, click Repository Information. When you are satisfied with your installation choices, click Install to install the package. A progress indicator shows the percentage of the installation completed.
11. When the installation process is complete, a message confirms the success of the process.
    1. Optional: 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. To display the details of an event in the log file, select the entry and read the details in the Details section. You can import or export the log file as an xml file, filter the log file on the basis of logged events, and open the log file as a web page.
    2. Optional: To delete any files specified for rollback, click Files for rollback and in the Preferences Window, select the files to be deleted.
    3. Click Finish. The Install Package wizard closes and you are returned to the Start page of Installation Manager.

Installing silently

Running Installation Manager in silent mode is helpful because it enables you to use a batch process to install, update, modify and uninstall product packages through scripts.

Note that you must install Installation Manager before you can silently install a package.

There are two main tasks required for silent installation:

1. Create the response file.
2. Run Installation Manager in silent installation mode.

Creating a response file with Installation Manager

To record a response file for installation (or uninstallation):

1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager. For example:
   • cd C:\Program Files\IBM\Installation Manager\eclipse
2. On a command line, type the following command to start the Installation Manager, substituting your own file name and location for the response file and (optionally) the log file:
   • IBMIM -record <response file path and name> -log <log file path and name>. For example, IBMIM.exe -record c:\mylog\responsefile.xml -log c:\mylog\record_log.xml
   • You can record a response file without installing or uninstalling a product by adding the optional -skipInstall <agentDataLocation> argument. Note that <agentDataLocation> must be a writable directory. The argument causes the Installation Manager to save the installation data without installing the product. You can use the same <agentDataLocation> in the next recording session to record updates or modifications to the product, or to record license management. Note that the products installed or preferences, including repository settings, that you may have set on install when not using the -skipInstall argument are not be stored. Using -skipInstall will make installation faster because the IM is not installing the product, it is just recording the installation data.

     The syntax for using the skipInstall argument is: IBMIM -record <response file path and name> -skipInstall <a writable directory for agent data location>. For example IBMIM -record c:\mylog\responsefile.xml -skipInstall c:\temp\recordData

   Note:
   Ensure the file paths you enter exist; Installation Manager will not create directories for the response file and the log file.
3. Follow the instructions in the Install Packages wizard to make your installation choices. For details, see Installing Rational Robot by using the Installation Manager GUI.
4. Click Finish, then close Installation Manager.

An XML response file is created and resides in the location specified in the command.

Recording a response file with the Installation Manager installer

To record the installation of Installation Manager, follow these steps:

1. Unzip the Installation Manager, then go to the InstallerImage_platform directory.
2. To start recording, enter install -record <response file path and name> -skipInstall <agentDataLocation> -vmargs -Dcom.ibm.cic.agent.hidden=false

Recording a product install with the installer

To start recording a product install with the Installation Manager installer, follow these steps:

1. Go to the InstallerImage_platform directory in location where you unzipped the Installation Manager.
2. Open the install.ini file by removing the following lines: -input and @osgi.install.area/install.xml
3. Enter the following command: install -record <response file path and name> -skipInstall <agentDataLocation>, for example: install -record
4. Start the Installation Manager and complete the Install Packages wizard.

Installing and running Installation Manager in silent mode

Refer to the Installation Manager Web site for additional documentation on how to run it in silent mode. For example, silently installing from a repository that requires authentication (user ID and password).

The following table describes the arguments used with the silent installation command:

-nosplash

--launcher.suppressErrors

-input

-log

Both the Installation Manager installer and the Installation Manager have an initialization or .ini file silent-install.ini that includes default values for the arguments in the table.

The Installation Manager installer is used to install the Installation Manager. Follow these steps to install the Installation Manager silently.

To install Installation Manager silently, unzip the installer and switch to the eclipse subdirectory, then use the following commands:

• installc --launcher.ini silent-install.ini -log <log file path and name> . For example: installc --launcher.ini silent-install.ini -log c:\mylogfile.xml

After Installation Manager is installed, you can use it to install other products. You can also use the Installation Manager installer to install the products.

To run Installation Manager in silent mode run the following command from the eclipse subdirectory:

• IBMIMc.exe --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>. For example: IBMIMc.exe --launcher.ini silent-install.ini -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml

If you want to silently install products using the Installation Manager installer, from the eclipse directory, enter the following command:

• installc.exe --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>. For example: installc --launcher.ini silent-install.ini -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml

When the Installation Manager installer, or Installation Manager runs in silent installation mode; it reads the response file and writes a log file to the directory you specified. While you must have a response file when running in silent installation mode, log files are optional. The result of this execution should be a status of 0 on success and non-zero number on failure.

Searching for and silently installing all available products

To search for and silently install all available products:

1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file:
   • IBMIMc.exe --launcher.ini silent-install.ini -installAll -log <log file path and name>

All available products known to Installation Manager are installed.

Silently installing updates to all currently installed products

To search for and silently install updates for all available products:

1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file:
   • IBMIMc.exe --launcher.ini silent-install.ini -updateAll -log <log file path and name>

All available product updates known to Installation Manager are installed.

Response file commands

There are two categories of commands for the response file:

• Preference commands are used to set preferences that are found in Installation Manager under File -> Preferences, such as repository location information.
• Silent installation commands are used to emulate the Install Packages wizard in Installation Manager.

Silent installation preference commands

When you define preferences in a response file, your XML code will look similar to the following example:

<preference
	name = "the key of the preference"
	value = "the value of the preference to be set">
</preference>

Use the following table to identify keys and their associated values for silent installation preferences:

Silent installation commands

<profile
id="the profile (package group) id"
installLocation="the install location of
 the profile">
<data key="key1" value="value1"/>
<data key="key2" value="value2"/>

</profile>

<server>
<repository location="http://example/
repository/">
<repository location="file:/C:/
repository/">
<!--add more repositories below-->
<...>
      </server>

<install>
<offering profile= "profile id"
features= "feature ids"
id= "offering id" version= "offering
version"></offering>

<!--add more offerings below>
<...>

</install>

<uninstall modify="true">
<offering profile="profileID"
 id="Id" version="Version"
features="-"/>
</uninstall>

<uninstall>
<offering profile= "profile id"
features= "feature ids"
id= "offering id" version= "offering
version"></offering>

<!--add more offerings below>
<...>

</uninstall>

<rollback>
<offering profile= "profile id"
 id= "offering id"
version= "offering version">
</offering>

<!--add more offerings below
<...>

</rollback>

<installALL/>

-silent -installAll 

<updateALL/>

-silent -updateAll 

<launcher -mode wizard -input
< response file >

Additional response file attributes

<agent-input clean="true">
</agent-input>

<agent-input clean="true" temporary="false">
</agent-input>

<agent-input acceptLicense="false">
</agent-input>

Reference: Sample response file

<agent-input >

<!-- add preferences -->
<preference name="com.ibm.cic.common.core.preferences. http.proxyEnabled"
value="c:/temp"/>

<!-- create the profile if it doesn't exist yet -->
<profile id="my_profile" installLocation="c:/temp/my_profile"></profile>

<server>
<repository location=
"http://a.site.com/local/products/sample/20060615_1542/repository/"></repository>
</server>

<install>
	<offering profile= "my_profile" features= "core" id= "ies"
version= "3.2.0.20060615">
	</offering>
</install>

</agent-input>

Silent install log files

The silent installation functionality creates an XML-based log file that records the result of the silent install execution (as long as a log file path is specified using -log <your log file path>.xml). If your silent installation session is successful, the log file will contain just the root element of <result> </result>. However, if errors occur during the installation, the silent install log file will contain error elements with messages such as:

<result>
	<error> Cannot find profile: profile id</error>
	<error> some other errors</error>
</result>

For detailed analysis, you can look at the logs generated in the Installation Manager data area. By using a preference command, you can optionally set the data area to your preferred location, as shown in the response file topic.

Managing licenses

IBM Rational License Key Administrator (LKAD) is installed with IBM Rational Robot and with your IBM Rational License Server software.

The IBM Rational License Key Administrator (LKAD) is a tool that you can use to import license keys to your desktop computers. You can also set up your client to use floating and named-user licenses, and change your license configuration. The LKAD wizard starts after the product installation is complete. You can also start the LKAD wizard on a client by clicking Start -> Programs -> IBM Rational -> Rational License Key Administrator.

For more information about managing licenses with Rational Common Licensing, see the Rational ClearQuest Information Center at http://publib.boulder.ibm.com/infocenter/cqhelp/v7r1m0/topic/com.ibm.rational.licensing.doc/topics/c_managing_lic.htm

For more information on managing licenses for your Rational product, see the Rational licensing support page at http://www.ibm.com/software/rational/support/licensing/.:

Starting Rational Robot

To start the product from the desktop, click Start -> Programs -> IBM Rational -> IBM Rational Robot.

To start Rational Robot from a command-line:

• <product installation directory>\Rational Test\rtrobo.exe

Updating Rational Robot

By default, Internet access is required unless your repository preferences points to your local update site.

Each installed product has the location embedded for its default IBM update repository. For Installation Manager to search the IBM update repository locations for the installed product, 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.

To find and install product updates:

1. From the Start page of the Installation Manager, click Update.
2. 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
3. In the Update wizard, select the location where the Rational Robot product 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 Robot. A progress indicator shows the search is taking place.
4. If updates for a product are found, then they are displayed in the Updates list on the Update Packages page below their corresponding product. Only recommended updates are displayed by default. Click Show all to display all updates found for the available product.
   1. To learn more about an update, click the update and review its description under Details.
   2. 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.
5. 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.
6. Click Next to continue.
7. 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.
   1. If you agree to the terms of all the license agreements, click I accept the terms of the license agreements.
   2. Click Next to continue.
8. On the Summary page, review your choices before installing the updates.
   1. If you want to change the choices you made on previous pages, click Back, and make your changes.
   2. 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.
9. 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.
10. Click Finish to close the wizard.
11. 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 Packages wizard and select the new features to install from the feature selection panel.

Modifying installations

By default, Internet access is required unless the repository preferences points to a local update site. See the Installation Manager help for more information.

To modify an installed product package:

1. From the Start page of the Installation Manager, click the Modify icon.
2. In the Modify wizard, select the installation location for the Rational Robot product and click Next.
3. On the Features page, select the features that you want to install or remove.
   1. To learn more about a feature, click the feature and review the brief description under Details.
   2. 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.
4. When you are finished selecting features, click Next.
5. On the Summary page, review your choices before modifying the installation package, and then click Modify.
6. Optional: When the modification process completes, click View Log File to see the complete log.

Reverting updates to previous versions

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:

1. On the Start page, click Roll back Packages.
2. In the Rollback wizard, from the Installation Packages list, select the package that you want to revert to the previous version.
3. Follow the instructions in the wizard.

Uninstalling Rational Robot

• To uninstall the product you must log in to the system using the same user account that you used to install the product.
• Before removing the IBM Rational products (including the IBM Rational license server) from clients, record the specified license server host names in the IBM Rational License Key Administrator (LKAD)
  1. Start the LKAD by clicking Start -> Programs -> IBM Rational -> IBM Rational License Key Administrator.
  2. Find the host names by clicking Settings -> Client/Server Configuration.
  3. After you install the new IBM Rational products, reset the license server name in the LKAD. The LKAD wizard starts after the installation. If the wizard does not start, click Start > Programs > IBM Rational > IBM Rational License Key Administrator.

To uninstall the product:

1. Close the programs that you installed using Installation Manager.
2. On the Start page of the Installation Manager click Uninstall.
3. In the Uninstall Packages page, select the Rational Robot product. Click Next.
4. 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.
5. Click Finish to exit the wizard.

Installing optional software

To install Test Enablers, you must install the development environment on the user machine. For example, to install Oracle Test Enabler, Oracle Forms must be installed on the same computer. To install Delphi Test Enabler, Delphi Frameworks must be installed. The installer will not list the required enabler if the development environment is not installed in the machine.

IBM Rational Test Enablers is a self-contained application that runs on Windows operating systems only. By default, it uses the same shared resources directory as Rational Robot. For more information, see the Installation Guide for Rational Robot, which is available in the documents directory on the CD.

To install Rational Test Enablers, perform the following steps:

1. Insert the CD into the CD-ROM drive.
2. From the IBM Rational Test Enablers launchpad, click Install Rational Test Enablers. The IBM Rational Test Enablers - Setup Wizard is displayed.
3. The wizard displays a list of available test enablers. Select the IBM Rational Test Enablers and click Next.
4. Click Finish.

IBM Packaging Utility

Packaging Utility software is located on the Enterprise Deployment CD that is included with Rational Robot. If you want to place a repository that contains a Rational Robot 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 Robot 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

Use the following steps to install IBM Packaging Utility software from the Enterprise Deployment CD:

1. Navigate to the Enterprise Deployment CD for the appropriate platform and extract the zip file from the CD.
2. 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).
3. Locate the Packaging Utility installer executable.
   • Change to the InstallerImage_win32 directory in the area where the pu.disk_win32.zip file was unpacked. Locate the installer executable "install.exe".
4. Start the installer executable and follow the instructions in the wizard to install the Packaging Utility.
5. 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.
6. 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.
7. Follow the instructions in the Install Packages wizard to complete the installation.

Copying product packages to an HTTP server using Packaging Utility

1. If you are copying from a CD image, perform these tasks:
   1. Insert the first installation CD into your CD drive.
   2. If autorun is enabled on your system, the Rational Robot launchpad program automatically opens. Close the launchpad program.
2. Start Packaging Utility.
3. 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
4. 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.
5. 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.
6. 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.
7. 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.
8. Click OK to define the repository location and to close the Browse to a repository directory window.
9. On the Destination page, click the Browse button and select an existing repository directory, or create a new folder to store the products.
10. 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.
11. 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.
12. 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.
13. Click Done to return to the Packaging Utility main page.

Now that you have used Packaging Utility to copy the Rational Robot 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/v1m0r0/index.jsp.

Notices

(C) Copyright IBM Corporation 1992, 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:

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM 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:

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^(R)
• zSeries^(R)

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.