Configuring Rational Integration Tester Agent

You can find the following information:

Review installed items to verify that the installation completed correctly.
Verify the storage of user files.
Modifying the Agent.config file.
Run Rational Integration Tester Agent on Unix-like systems.
Deploy probes.
Uninstall Rational Rational Integration Tester Agent.

Review installed items

Depending on what is installed, the following directories are created and populated under the installation directory.


Directory	Contents
config	Configuration and template files for charts, reporting, projects, and test plans
configuration	System configuration files
drop-ins	User-created plug-in files
externalSchemaCache	Search location for schema files that can be accessed frequently but may not be accessible from the client computer
features	Version information for installed features/plug-ins
jre	Bundled Java™ run time environment
license	Licensing files
p2	Eclipse files
plug-ins	Rational® Integration Tester transport plug-in JAR files
properties	(Used by IBM Tivoli® software.)
scripts	SQL scripts
tools	Additional tools

Verify the storage of user files

Rational® Integration Tester Agent projects can be created in any location to which a user has access. However, using a remote or network location can reduce the performance of Rational® Integration Tester Agent significantly, so it is recommended that Rational® Integration Tester Agent is installed on a local drive.

Rational® Integration Tester Agent creates a .integrationtester directory in the user's home directory to store project and configuration information.

Subject to licensing agreements, a single shared location can be used to allow multiple Rational® Integration Tester Agent users on the same computer.

On the Windows™ platform, the directory is C:\Documents and Settings\User ID\.integrationtester or C:\Users\User ID\.integrationtester.
On Unix-like systems, the directory is ~/.integrationtester.

The following configuration details are stored:

Library Manager settings
Recently used project lists
Individual project details
Project workspace properties
Schema properties

Modifying the Agent.config file

When you want to use certain features along with Rational® Integration Tester Agent, you must edit and modify the attributes that are in the Agent.config file. Use the following table to identify the circumstances in which you must modify the Agent.config file:


When you want to...	More information...
Configure the temporary storage location that is used by the agents	Configuring the temporary storage location used by the agents Configuring the temporary storage location used by the agents
Register Rational® Integration Tester Agent with Rational® Test Control Panel	Registering Rational Integration Tester Agent with Rational Test Control Panel
Configure the HTTP endpoint of Rational® Test Control Panel	Configuring the server HTTP Endpoint
Rational® Integration Tester Agent to connect securely with Rational® Test Control Panel when the domain level security is enabled.	Configuring agents and proxies to use security tokens
Define custom attributes and instance name for a running agent.	Defining custom tags or instance name for a running agent
Create multiple test engines when you want to run performance tests.	Creating multiple test engines (optional)
Use custom signed certificates to connect with Rational® Test Control Panel in the SSL mode of authentication.	Using your own truststore for server SSL connections
Configure the network ports.	Network ports
Specify the ephemeral ports as an option to override the server socket when you use the RunTests command.	Running tests by using the command line
Run Rational® Integration Tester Agent on Unix-like systems.	Running Rational Integration Tester Agent on Unix-like systems
Configure Rational® Integration Tester Agent as an IBM® Engineering Test Management adapter.	Configuring Rational Integration Tester Agent as an IBM Engineering Test Management adapter
Configure Rational® Integration Tester Agent as an IBM® Rational® Quality Manager adapter.	Configuring Rational Integration Tester Agent as Rational Quality Manager adapter

Run Rational® Integration Tester Agent on Unix-like systems

You can run the Rational® Integration Tester Agent in several ways:

To run the Rational® Integration Tester Agent on Unix-like systems, run the agent script in the top-level installation directory.
To run the agent as a service, the script can be included in the init script that runs at boot time. Contact your system or network administrator for assistance.

Deploy probes

A probe measures variables from a particular component in the system, such as a broker, process engine, or host machine, and reports back its findings for processing and storage.

You can use IBM® Rational® Performance Test Server to create probes that gather statistics for all of the messaging and integration components that are supported by the product.

Uninstall Rational® Rational® Integration Tester Agent

You can use the Installation Manager to uninstall Rational® Integration Tester Agent.

The .integrationtester directory and some workspace and schema files that it contains might remain in the home directory of any user who launched Rational® Integration Tester Agent. These files or the entire directory can also be removed manually.

Configuring Rational® Integration Tester Agent