Part V: Configuring Rational Integration Tester Agent

  1. Review installed itemsThe following are the example of the typical directories are created an populated under the installation directory RITagent
  1. Verify the storage of user filesRational Integration Tester Agents will create a .rit8 in the user’s home directory to store project and it’s configuration information. In a successful installation of the RIT you will typically see the .rit8 in the user home directory (IE: /home/user-name/.rit8) with the following configuration for the library manager settings, recently used project lists, individual project details, project workspace properties and schema propertieslsrit8
  1. Running Integration tester Agent on LINUX/UNIXThere are two ways to run the Rational Integration tester Agent
    1. Run the agent script in the top-levl of the installation directory
    2. Run the agent as a service by including the scrip to be included in an init script that runs at boot time
Advertisements

Part IV: Configuring Rational Integration Tester

1. Creating a project result database. IBM Rational Integration Tester v8.5 supports four types of the database from IBM DB2, Microsoft SQL server, Oracle and MySQL databases. For more information on the exact version that we support, please refer to Crating the project result database using IBM DB2, Microsoft SQL Server, Oracle, and MysQL

In my example, I’m going to use MySQL database to store my project results. Therefore, I will have to run the following command as root and use the mysql script that shipped with the product against my MySQL database.

A.     Logged in as user root then I run the following command

services mysql start

mysqlcreatedb

B.     Run the ghtester_mysql.sql script against the new database

source /opt/IBM/RationalIntegrationtester/scripts/ghtester_mysql.sql;

populatedb

Part III: An example of my Rational Test Workbench’s response file for the silent install

 Click here to download my IBM Rational Test Workbench’s sample response file
<?xml version=”1.0″ encoding=”UTF-8″ ?>
<!–

The "acceptLicense" attribute has been deprecated. Use "-acceptLicense" command line option to accept license agreements.

–>

<agent-input acceptLicense=”true“>
<server>
  <repository location=”/root/download/RTW_SETUP/” />
  <repository location=”/root/download/RIT_SETUP/disk1” />
  <repository location=”/root/download/RTCP_SETUP/disk1” />
  <repository location=”/root/download/RITPP_SETUP/disk1” />
  </server>
<profile id=”IBM Rational Integration Tester” installLocation=”/opt/IBM/RationalIntegrationTester“>
  <data key=”eclipseLocation” value=”/opt/IBM/RationalIntegrationTester” />
  <data key=”user.import.profile” value=”false” />
  <data key=”cic.selector.os” value=”linux” />
  <data key=”cic.selector.arch” value=”x86_64” />
  <data key=”cic.selector.ws” value=”gtk” />
  <data key=”cic.selector.nl” value=”en” />
  <data key=”user.help.option” value=”remote” />
  <data key=”user.help.url” value=”” />
  </profile>
<install modify=”false“>
  <offering id=”com.ibm.rational.ritw.offering” version=”8.5.0.I20130529_1634” profile=”IBM Rational Integration Tester” features=”main.feature” installFixes=”none” />
  <offering id=”com.ibm.rational.ritpp.offering” version=”8.5.0.I20130529_1634” profile=”IBM Rational Integration Tester Platform Pack” features=”ip.feature,jdbc.feature,wmq.zos.feature,rtcp.ant.client.feature,ctg.feature,cics.feature,jva.feature,jbi.feature” installFixes=”none” />
  <offering id=”com.ibm.rational.rtcp.offering” version=”8.5.0.I20130529_1634” profile=”IBM Rational Test Control Panel” features=”main.feature” installFixes=”none” />
  </install>
<profile id=”IBM Rational Integration Tester Platform Pack” installLocation=”/opt/IBM/RIT-Platform“>
  <data key=”eclipseLocation” value=”/opt/IBM/RIT-Platform” />
  <data key=”user.import.profile” value=”false” />
  <data key=”cic.selector.os” value=”linux” />
  <data key=”cic.selector.arch” value=”x86_64” />
  <data key=”cic.selector.ws” value=”gtk” />
  <data key=”cic.selector.nl” value=”en” />
  <data key=”user.RTCP_url” value=”http://localhost.localdomain:7819/RTCP” />
  </profile>
<profile id=”IBM Rational Test Control Panel” installLocation=”/opt/IBM/RationalTestControlPanel“>
  <data key=”eclipseLocation” value=”/opt/IBM/RationalTestControlPanel” />
  <data key=”user.import.profile” value=”false” />
  <data key=”cic.selector.os” value=”linux” />
  <data key=”cic.selector.arch” value=”x86_64” />
  <data key=”cic.selector.ws” value=”gtk” />
  <data key=”cic.selector.nl” value=”en” />
  <data key=”user.help.option” value=”remote” />
  <data key=”user.help.url” value=”” />
  <data key=”user.workspacePath,com.ibm.rational.rtcp.offering” value=”/var/rtcp” />
  <data key=”user.networkPort,com.ibm.rational.rtcp.offering” value=”7819” />
  <data key=”user.oslcHostname,com.ibm.rational.rtcp.offering” value=”http://localhost.localdomain” />
  <data key=”user.defaultDomain,com.ibm.rational.rtcp.offering” value=”” />
  <data key=”user.securityConfig,com.ibm.rational.rtcp.offering” value=”#RTCP security configuration #Wed Oct 16 18:12:25 CEST 2013 credentialsStore=FILE” />
  </profile>
  <preference name=”com.ibm.cic.common.core.preferences.eclipseCache” value=”/opt/IBM/IBMIMShared” />
  <preference name=”com.ibm.cic.common.core.preferences.connectTimeout” value=”30” />
  <preference name=”com.ibm.cic.common.core.preferences.readTimeout” value=”45” />
  <preference name=”com.ibm.cic.common.core.preferences.downloadAutoRetryCount” value=”0” />
  <preference name=”offering.service.repositories.areUsed” value=”true” />
  <preference name=”com.ibm.cic.common.core.preferences.ssl.nonsecureMode” value=”false” />
  <preference name=”com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication” value=”false” />
  <preference name=”http.ntlm.auth.kind” value=”NTLM” />
  <preference name=”http.ntlm.auth.enableIntegrated.win32” value=”true” />
  <preference name=”com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts” value=”true” />
  <preference name=”com.ibm.cic.common.core.preferences.keepFetchedFiles” value=”false” />
  <preference name=”PassportAdvantageIsEnabled” value=”false” />
  <preference name=”com.ibm.cic.common.core.preferences.searchForUpdates” value=”false” />
  <preference name=”com.ibm.cic.agent.ui.displayInternalVersion” value=”false” />
  <preference name=”com.ibm.cic.common.sharedUI.showErrorLog” value=”true” />
  <preference name=”com.ibm.cic.common.sharedUI.showWarningLog” value=”true” />
  <preference name=”com.ibm.cic.common.sharedUI.showNoteLog” value=”true” />
  </agent-input>

Part II: Step by step instructions on how to silently install IBM Rational Test Workbench version 8.5

Section 1: Creating a response file for Rational Test Workbench silent install

To do a silent install, the Install Manager needs what is called a response file that contains responses to all the questions that it would normally ask in the GUI interface.

However, before installing/recording the response file for the Rational Test Control panel, it’s important to consider whether and how you want Rational Test Control panel to authenticate users:

  • If you want to use either Active Directory or LDAP, you will need the assistance of an Active Directory/LDAP Administrator in your organization.
  • If your organization does not have any Active Directory or LDAP servers or if you are unsure about the configuration details of any such servers in your organization, you can use the Rational Test Control Panel Built-in authentication type.

Note: In this documentation, we are using the Rational Test Control Panel Built-in authentication type. Also the example of my response file is in Part III of my post. Please feel free to use them as reference guidelines to create your own installation response file.

Tips: If you are not sure what is supposed to be put inside the response file. Find another test machine that would allow you to launch the Installation Manager wizard and via the command line and use –record option to capture the output for your response file. One of the key benefits for using the Installation Manager with –record option to record your response is that you can be certain that your response file is error free.

[ppetpray@localhost RTW_SETUP]# /opt/IBM/InstallationManager/eclipse/IBMIM -record /opt/response_file/RTW8.5.xml -skipInstall /skipInstall/IBM_product

Upon existing the Installation Manager the installation manager will ask if you want to launch the Rational Integration Tester and to configure the 3d-party JAR files.

In this example, I have configured my Rational Integration Tester library for IBM WebSquare MQ 7.5 and MySQL.

Section 2: Generating a Rational Integration Tester Configuration file for silent installation

In order for me to save the setting for the Rational Integration Tester, I will have to run the following command from the command line and save my settings to a response file.

command line:     ./LibConfig -genLibSettings  < response file path and name>

For example:

[ppetpray@localhost RationalIntegrationTester]# ./LibConfig           -genLibSettings /opt/response_file/RIT_LibSettings.xml

InstallLocation: /opt/IBM/RationalIntegrationTester/Configuration/

InstanceLocation: /root/.rit8/.eclipse/LibConfig/workspace/

UserLocation: /root/user/

Oct 22, 2013 7:51:44 PM com.ghc.a3.Activator start

INFO: loading library manager definitions

Oct 22, 2013 7:51:44 PM com.ghc.a3.a3utils.configurator.LibraryConfig <init>

INFO: Loading config from: /opt/IBM/RationalIntegrationTester/librarysettings.xml

Oct 22, 2013 7:51:45 PM com.ghc.a3.Activator loadLibraryManagerDefinititions

INFO: Adding 7 new bundle fragments

Oct 22, 2013 7:51:45 PM com.ghc.a3.a3utils.configurator.LibraryConfig <init>

INFO: Loading old config from: /root/.ghTester5/librarysettings.xml

Oct 22, 2013 7:51:45 PM com.ghc.a3.a3utils.configurator.LibraryConfig save

INFO: Saving config to primary location: /opt/response_file/RIT_LibSettings.xml

Oct 22, 2013 7:51:45 PM com.ghc.a3.a3utils.configurator.LibraryConfig save

INFO: Saving config to user location: /root/.ghTester/librarysettings.xml

Caution

Installation Manager sets file permissions on the response file. The file permissions are changed to allow read and write permissions only for the user ID or group ID that recorded the response file. Before you proceed with the silent install using a response file, please check the permission of the response file by running the “ls -al” command and make sure that the response file permission is set properly

  • If the installation is going to be done by the administrator, then the permission of the response file should be set to “600
  • If the installation is going to be done by the non-administrator, then the permission of the response file should be set to “660
  • If you run Installation Manager as a non-administrator and plan to use the response file to install on another users computer, you must change the file paths in your response file from absolute paths to relative paths

In this example, my response response file was captured using the Rational Test Control Panel built-in security type, which means that the user names and passwords are managed by the Rational Test Control Panel and each user will be required to enter a user name and password to log in. Thus only authenticated user can control the IBM Rational Test Virtualization Server environment.

In addition, users who are identified as administrator can create other users. However you must enter a user name and password for the first user, who will be created as an administrator. After Rational Test Control Panel is installed, you can log in as the administrator user and create additional users (for information about this, refer to IBM Rational Test Virtualization Server Reference Guide).

For more information regarding a different security model and if you want to modify the RTCP security configuration after the installation, please refer to Modifying RTCP security model settings after installation – Doc 1.0 guideline.

Section 3: Running the silent installation from a command line

Assuming that you already have your response file created, next we will be installing the following product via a silent install.

    • IBM Rational Integration Test version 8.5
    • IBM Rational Integration Tester Platform Pack version 8.5
    • IBM Rational Integration Test Control Panel version 8.5
    • Configure Library Manager for IBM Rational Integration Tester

Note: Since this is my test environment, I have created my response file to install the above three products packages all in one machine. If this is not what you want to do, the response file could easily modified to install just one product at a time on its own environment.

Things to watch out for

  1. Please, check the directory name and its path name of your products installation repository and modify the response file accordingly.

        For example:

         <server>

                <repository location=”/root/download/RTW_SETUP/” />

               <repository location=”/root/download/RIT_SETUP/disk1” />

               <repository location=”/root/download/RTCP_SETUP/disk1” />

               <repository location=”/root/download/RITPP_SETUP/disk1” />

        </server>

My RTW’s response file name repository server location is at /root/download , if this is not where you have extracted your products installation file, this section will need to be changed. 

Instructions and UNIX command line syntax

  1. Change directory to where you will be running the Install Manager fromcd /opt/IBM/InstallationManager/eclipse
  2. Type in the following command./IBMIM –launcher.ini silent-install.ini –input /opt/response_file/RTW8.5.xml –log /opt/logs/RTW8.5_RFT_RPT_install.log –acceptLicense

 Note: You will need to specify the appropriate response file name and log output file name. Also if you run into any permission issue you might need the -accessRights admin option in your command line

[ppetpray@localhost eclipse]# ./IBMIM –launcher.ini silent-install.ini –input /opt/response_file/RTW8.5.xml –log /opt/logs/RTW8.5_RFT_RPT_install.log –acceptLicense

Installed com.ibm.rationa.ritw.offering_8.5.I20130529_1634 to the /opt/IBM/RationalIntegrationTester directory.

Installed com.ibm.rational.ritpp.offering_8.5.0.I20130529_1634 to the /opt/IBM/RIT-Platform directory.

Installed com.ibm.rational.rtcp.offering_8.5.0.I20130529_1634 to the /opt/IBM/RationalTestControlPanel directory.

[ppetpray@localhost eclipse]#

  1. Once the installation is completed. Check your installation log to make sure that the installation is completed successfully with out any error messages.

 Example of a successful silent installation log file.

       <?xml version=”1.0” encoding=”UTF-8”?>

      <result>

      </result>

  1. Applying a Rational Integration Tester Configuration file using the following command format

        LibConfig -processLibSettings <RIT reponse file path name>

Note: If you chose to run the Rational Integration Tester Configuration on the target computer, first the Rational Integration Tester Configuration file must be copied to the target computer and then use the LibConfig -processLibSettings command format to apply the configuration file on the target computer

LibConfig -processLibSettings <RIT reponse file path name>

 

 

Example

./LibConfig -processLibSettings /opt/response_file/RIT_LibSettings.xml

Section 4: How to silently install the IBM Rational Integration Test Agent v8.5

IBM Rational Integration Tester Agent has two key functions: at run-time it hosts one or more virtual services designed in IBM Rational Integration Tester, and it generates service-level load for performance testing. A single agent can run multiple virtual services using many different transports (subject to memory and processor limits). If multiple agents are available within the environment, users can choose which agent will host a particular service or serve as a load agent for IBM Rational Integration Tester.” — Rational Test Virtualization Server overview documentation

To silently install the Rational Integration Tester Agent, we must first create a response file for Rational Integration Test Agent. For more information on how to create a response file, please checkout Part II of my blog post over here.

Since I want to make it very easy for us, I have made the sample of the Rational Integration Tester Agent available on my drop-box account. Please feel free to download and modify them accordingly to fit your environments/configurations.

Click here to download a sample of the Rational Integration tester Agent’s response file

Part I: How to silently install IBM Installation Manager 1.7 and Rational Test Workbench 8.5 (aka GreenHat)

The purpose of this post is to provide a step by step instruction on how to silently install the IBM Installation Manager version 1.7, IBM Rational Integration Tester version 8.5, IBM Rational Test Control Panel version 8.5 and IBM Rational Test Platform Pack version 8.5 on the UNIX® platform.

The most easiest way to install the Rational Test Workbench 8.5 is via the Installation Manager Wizard. The Installation Manager (IM) Setup wizard is a GUI installer that provides an easy-to-use interface for installing IBM Rational products and for performing initial setup and configuration tasks. The IM Setup wizard on LINUX® and UNIX® requires an X server to display the GUI. However, in the LINUX® and UNIX® operating systems where security is one of the main concerns, the IM wizard GUI installer might not be available. One of the options to get around this problem is to install and configure IM and Rational Test Workbench version 8.5 via command line or a silent install.

 Part I: Install Rational Installation Manager in a silent mode

1. Download Installation 1.7 files from http://www-01.ibm.com/support/docview.wss?uid=swg24034941

2. Click FC to download the installation package

fc

3. Create a directory to store the Installation file

4. Extract the installation files to the directory that you just created

5. Open a command line and go to the directory

Example:

cd /opt/IM

./installc -log /opt/IMInstalllog.txt -acceptLicense

 [ppetpray@localhost IM]# ./installc -log /opt/IMInstalllog.txt                        -acceptLicense

Installed com.ibm.cic.agent_1.70.20130828_2012 to the /opt/IBM/InstallationManager/eclipse directory

6. Confirm that the installation was run successfully. A successful installation log file should contained the following content

[ppetpray@localhost IM]# cat /opt/IMInstalllog.txt

<?xml version=”1.0” encoding=”UTF-8”?>

<result>

</result>