How to install Rational Test Workbench from the command line

You are installing RTW on a server that has no graphical display or you want to automate installation so that it requires no user input.

See the Rational Integration Tester Installation Guide and IBM Installation Manager documentation when you follow these instructions.

You install and update IBM software through the IBM Installation Manager (IM). You need to install the Installation Manager before the RTW components. You can install IM silently from the command line.

To automate the installation process, Installation Manager enables you to create response files that contain the settings and parameters entered during an interactive installation using a graphical display. The response file is later used during automated and "headless" installations.

The procedure comprises of the following stages:

1. Creation of the response file for silent install
2. Product licensing
3. Installation on the target computer

---

A. CREATION THE RESPONSE FILE

1. Consult the Rational Test Workbench Release Notes to verify the required version of Installation Manager.
   
   
2. Obtain the installation image for IM and install it on a test computer.
   See document Installation Manager, Version 1.6 for download locations and installation instructions.
   
   
3. Download the RTW installation image and extract it to a temporary location.
   
   
4. Run IM and configure it to point to the RTW components.
   
   Click File > Preferences > Repositories and click the Add Repository button.
   Browse to the location of the RTW files and select the diskTag.inf or repository.config file.
   
   Add repositories for each component you are installing.
   
   
5. Save your changes and exit IM.
   
   
6. Run IM on the command line and give the filename of the installation responses.
   
   The IBMIM program location is in the eclipse subfolder of IM.
   
   Windows: IBMIM -record <response file path and name> -log <log file path and name>
   
   Other operating systems: ./IBMIM -record <response file path and name> -log <log file path and name>
   
   For example:
   ./IBMIM -record /opt/IBM/RTW_responsefile.xml -log /opt/ibm/RTW_log.xml
   
   
7. Follow the on-screen installation procedure and exit IM when done. Your responses are saved to file.
   
   
8. Run Library Manager for Rational Integration Tester and Rational Integration Tester Agent as required.
   
   Configure any 3rd-party JAR files and save the settings.
   
   
9. Run Library Manager again on the command line to save the settings to a file that may be used on the target system.
   
   Windows: LibConfig -genLibSettings <settings file path and name>
   
   Other systems: ./LibConfig -genLibSettings <settings file path and name>
   
   For example:
   ./LibConfig -genLibSettings /opt/IBM/RIT_libsettings.xml
   
   
10. See the attached sample response file of a RIT installation. You can edit this file to suit your requirements and re-use it with IM.
    

B. PRODUCT LICENSING

To automate licensing configuration you must re-run IM and create a new response file with the licensing settings saved within it. For example, you need to configure the use of a floating licence server.

C. INSTALLATION ON THE TARGET COMPUTER

1. Obtain the installation image for IBM Installation Manager (IM) and extract to a temporary location.
   
   
2. Copy your response file onto the computer.
   
   
3. Open a command prompt in the directory where IM was extracted to.
   
   
4. Install IM on the command line.
   
   
   Windows: installc -acceptLicense
   
   Other systems: ./installc -acceptLicense
   
   
   
5. Obtain the installation images for RTW and extract to a temporary location.
   
   Ensure that this location is the same as that used when creating the response file.
   Edit the response file when using a different temporary location.
   
   
6. Install RTW on the command line.
   
   Change directory to the eclipse/tools sub-folder.
   
   Windows: imcl input <response file path and name> -acceptLicense
   
   Other systems: ./imcl input <response file path and name> -acceptLicense
   
   For example:
   ./imcl input /opt/IBM/RTW_response.xml -acceptLicense
   
   
7. Complete the licensing configuration if required.
   
   Repeat the imcl command, this time using the license response file.
   
   For example:
   ./imcl input /opt/IBM/RTW_license_response.xml -acceptLicense
   
   
8. Run Library Manager on the command line for Rational Integration Tester and Rational Integration Tester Agent as required.
   
   Take the Library Manager settings file saved on the test machine and edit to suit.
   
   Windows: LibConfig -processLibSettings <settings file path and name>
   
   Other systems: ./LibConfig -processLibSettings <settings file path and name>
   
   For example:
   ./LibConfig -processLibSettings /opt/IBM/RIT_libsettings.xml

The RTW components installation starts.

Disclaimer

All source code and/or binaries attached to this document are referred to here as "the Program". IBM is not providing program services of any kind for the Program. IBM is providing the Program on an "AS IS" basis without warranty of any kind. IBM WILL NOT BE LIABLE FOR ANY ACTUAL, DIRECT, SPECIAL, INCIDENTAL, OR INDIRECT DAMAGES OR FOR ANY ECONOMIC CONSEQUENTIAL DAMAGES (INCLUDING LOST PROFITS OR SAVINGS), EVEN IF IBM, OR ITS RESELLER, HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

RIT_responses.xml