Installing Rational Integration Tester for non-administrative users

To run Rational® Integration Tester as a non-administrative user, you must install the software as a non-administrative user. On Linux systems, if you already installed Rational Integration Tester as a root user, you can change the ownership of the product installation directories, and then use the software as a non-root user.

You have two options on how to make Rational Integration Tester available to non-administrative user profiles.

Option 1: Install the software as a non-administrative user
  1. Install Installation Manager and Rational Integration Tester for non-administrative users.
  2. If there are multiple users, create a non-administrative user group, and assign read and write permissions to the product and log directories to the user group. For Linux systems, see Modifying the directory ownership for Linux systems
When you install these products as a non-administrative user, the installation directory is the user's home directory: on Linux systems, $HOME for that user, and on Windows systems, %UserProfile% for the user.

Option 2: (applies to Linux installations only) Install the software as a root user, and change the ownership of product directories to a non-root user

  1. Install Installation Manager as an administrative user. See Using the launchpad or Installation manager commands and directories for administrative and non-administrative user instances.
  2. Install Rational Integration Tester as an administrative user. See Installing the product software.
  3. Change the ownership of all product files and directories, including the log directories, to a non-administrative user. If there are multiple users, create a non-administrative user group, and assign read and write permissions to the product and log directories to the user group. For Linux systems, see Modifying the directory ownership for Linux systems.
Remember: If you change file or directory permissions, you must repeat the process after each product upgrade .

Installing Installation Manager and Rational Integration Tester for non-administrative users

  1. Install IBM Installation Manager as a non-administrative user by using the userinst program. In the launchpad package, the userinst program is located in the folder that matches the architecture. For example, for a Linux 64-bit installation, run RTW_SETUP/InstallerImageLinux_gtk_x86_64 ./userinst and for a Windows 64-bit installation, run RTW_SETUP\InstallerImage_win32_win32_x86_64\userinst.exe. In the table below, see the installation command to use and the default installation directories.
    Installation Manager commands and directories for administrative and non-adminstrative user instances
    Installation commands and directories Administrative user installation Non-administrative user installation
    Command to install Installation Manager Windows systems: install.exe Windows systems: userinst.exe

    Linux systems: # ./install

    Linux systems: # ./userinst

    Installation Manager installation directory Windows systems: C:\Program Files\IBM\Installation Manager Windows systems: %UserProfile%\IBM\InstallationManager\eclipse

    Linux systems: /opt/IBM/InstallationManager

    Linux systems: $HOME/IBM/InstallationManager/eclipse

  2. Use Installation Manager to install Rational Integration Tester and the required components by following the instructions in Installing the product software. See the table below for the default installation directory for administrative and non-administrative user installations. During the installation you can modify the default installation directories.
    Tip: For non-administrative user installations on Linux systems, it is a good practice to set the installation directory to a path that is not in the home directory of the installing user. On Windows systems, do not install to the Program Files directories.
    Table 1. . Rational Integration Tester installation directories for administrative and non-adminstrative user instances
    Installation directories Administrative user instance Non-administrative user instance
    Rational Integration Tester installation directory Windows systems: C:\Program Files\IBM\RationalIntegrationTester Windows systems: %UserProfile%\IBM\RationalIntegrationTester
    Linux systems: /opt/IBM/RationalIntegrationTester Linux systems: $HOME/IBM/RationalIntegrationTester
    IBM Rational Integration Tester Agent Windows systems: C:\Program Files\IBM\RIT-Agent Windows systems: %UserProfile%\IBM\RIT-Agent

    Linux: /opt/IBM/RIT-Agent

    Linux systems: $HOME/IBM/RIT-Agent
    Rational Test Control Panel installation directory Windows systems: C:\Program Files\IBM\RationalTestControlPanel Windows systems: %UserProfile%\IBM\RationalTestControlPanel

    Linux systems: /opt/IBM/RationalTestControlPanel

    Linux systems: $HOME/IBM/RationalTestControlPanel
  3. During the Rational Test Control Panel installation, enter the path to the Rational Test Control Panel workspace. See the table below for examples.
    Tip: Set the IBM Rational Test Control Panel workspace to a directory location to which you have write permission. Ensure that the directory path does not have any spaces.
    Rational Test Control Panel workspace locations for administrative and non-adminstrative user instances
    Installation directories Administrative user instance Non-administrative user instance
    Rational Test Control Panel workspace Windows systems: C:\IBM\RTCP-Workspace Windows systems: %UserProfile%\IBM\RTCP-Workspace
    Linux systems: var/rtcp Linux systems: $HOME/var/rtcp
  4. For the technologies that you want to use for testing, configure the application settings and the libraries to include by running the Library Manager for Rational Integration Tester and IBM Rational Integration Tester Agent. For more information on running the Library Manager, see Working with the Library Manager. Running the Library Manager creates the librarysettings.xml file. See the table below for the file location.
    Note: In the non-administrative installation environment, Library Manager cannot access the network interface, so you cannot use the packet capture recording mode. You can only use the external proxy server recording mode.
    Table 2. . Location of the librarysettings.xml file
    File File location
    Rational Integration Tester librarysettings.xml file Windows systems: : %UserProfile%\.rit8
    Linux systems: $HOME/.rit8
    Rational Integration Tester Agent librarysettings.xml file Windows systems: %UserProfile%\IBM\RIT-Agent
    Linux systems: $HOME/IBM/RIT-Agent
You can now run Rational Integration Tester as a non-administrative user.

What to do next

For multiple users on Linux systems, create a non-administrative user group. Assign ownership to the product and log directories to the user group. For more information about assigning directory ownership, see Modifying the directory ownership for Linux systems

Modifying the directory ownership for Linux systems

If you installed Installation Manager and Rational Integration Tester as an administrative or root user on Linux, you can modify the installation directory ownership so that non-root users can run the software.

Note: This procedure is applicable in a Linux environment only. A similar process is not currently identified for Windows installations.

Before you begin

Before you change the directory permissions, ensure that you stop all services.

About this task

This process assumes that you installed Installation Manager as a root user, and then installed Rational Integration Tester by using Installation Manager as a root user.

  1. Change ownership of each product installation directory by running the chown command.

    The command syntax is chown -R user:group dir, where user is the name of the user to change the ownership to, group is the user group name, and dir is the directory path of the directory that you want to change the ownership of.

    For example, to change ownership of the Rational Integration Tester to a non-root user named John, run the following command: chown -Rjohn:usergroup1 opt/IBM/RationalIntegrationTester. You must change the ownership for the following installation directories:
    • /opt/IBM/RationalIntegrationTester
    • /opt/IBM/RIT-Agent
    • /opt/IBM/RationalTestControlPanel
    • /opt/IBM/IMShared
  2. Run the chown command on each product log directory that is not under one of the product installation directories specified in step 1. By default, the product logs are saved to the installation directory. If the location of the log directories is not the product installation directory, you must separately change the ownership of those directories.
  3. Run the chown command on the Rational Test Control Panel workspace directory. The workspace directory is specified by the workingDirectory= property in the /opt/ibm/rtcp/usr/servers/RTCPServer/apps/RTCP.war/WEB-INF/classes/container.server.properties file.

You can now run Rational Integration Tester and its components on Linux as a non-root user.


Feedback