Working with Library Manager

Rational® Integration Tester uses a plug-in architecture to provide support for various middleware and messaging technologies, so the list of third-party products with which it interacts can become large. You can manage this list by using Library Manager. When support for a new architecture or messaging plug-in is required, you use Library Manager to add that support.

Library Manager is an application that is installed with Rational® Integration Tester that is used to manage the libraries (Java™ JAR files) that are required by different plug-ins.

Important: If Rational® Integration Tester and its Agent are installed on the same computer, Library Manager must be run during the installation of both applications.

Starting Library Manager

Start the Library Manager in any of the following methods:

In Microsoft™ Windows™, you can start Library Manager from the IBM® program group (default is IBM > Rational® Integration Tester).
Click the LibConfig.exe file in the installation directory of Rational® Integration Tester.

For example, the installation directory path can be C:\Program Files\IBM\RationalIntegrationTester

Important: Library Manager writes some of its configuration details to the users home directory, .integrationtester, and to the Rational® Integration Tester installation directory. To ensure that Library Manager can write to the Rational® Integration Tester installation directory, the user ID used to install Rational® Integration Tester must be used when running Library Manager.

On the Library Manager application window, Rational® Integration Tester properties and third-party plug-ins are listed alphabetically on the left side.

To view/modify a specific configuration, select it in the list. The settings for the selected entry are displayed on the right side of the screen.

When you complete configuring Library Manager, click OK to save any changes that were made and to apply the new settings. If Rational® Integration Tester is running, you must restart it to ensure that any changes that you made take effect.

Note: If Library Manager changes are not applied, you do not have sufficient user privileges. You must rerun Library Manager as a user with administrative privileges or as an administrator (whichever is applicable), depending on the operating system that is being used.

Application settings

Application settings are used to configure general properties of the Rational® Integration Tester application. Required values are populated with default settings when Library Manager is run for the first time. However, any of the default values can be modified.


Setting	Description
Max memory usage	The amount of memory (in MB) that is allocated to Rational® Integration Tester. Allocating more memory can increase the performance of the application.
HTTP Bind Address	When Rational® Integration Tester or one of its Agents is running an HTTP-based stub, this value is the host name or IP address of the network adapter that it listens on. In most cases, you also enter the same information in the other bind address fields on this page. This setting is for use in an environment with a firewall, a VPN, or multiple network connections. For more information, see Firewalls, VPNs, and multihomed machines.
HTTP Proxy Port	When Rational® Integration Tester or one of its Agents uses an HTTP proxy to make outbound HTTP connections, this value is the port number that is used to connect to the proxy. This setting is for use in an environment with a firewall, a VPN, or multiple network connections. The value must refer to a unique port number that is open in the firewall. For more information, see Firewalls, VPNs, and multihomed machines.
HTTP Proxy Server	When Rational® Integration Tester or one of its Agents uses an HTTP proxy to make outbound HTTP connections, this value represents the host name or IP address of the proxy server. This setting is for use in an environment with a firewall, a VPN, or multiple network connections. For more information, see Firewalls, VPNs, and multihomed machines.
Environment Recording Port	During recording, the proxies and intercept technologies send information back to Rational® Integration Tester over an HTTP connection. This field contains the port number that is used to connect to the proxy. This setting is for use in an environment with a firewall, a VPN, or multiple network connections. The value must refer to a unique port number that is open in the firewall. For more information, see Firewalls, VPNs, and multihomed machines.
Environment Recording Bind Address	During recording, the proxies and intercept technologies send information back to Rational® Integration Tester over an HTTP connection. This value is the host name or IP address of the network adapter that it listens on. In most cases, you also enter the same information in the other bind address fields on this page. This setting is for use in an environment with a firewall, a VPN, or multiple network connections. For more information, see Firewalls, VPNs, and multihomed machines.
WMIS Server Port	The port where Rational® Integration Tester listens for webMethods Integration Server requests. This setting is for use in an environment with a firewall, a VPN, or multiple network connections. The value must refer to a unique port number that is open in the firewall. For more information, see Firewalls, VPNs, and multihomed machines.
WMIS Server Bind Address	The host name or IP address to which Rational® Integration Tester is bound for webMethods Integration Server requests. In most cases, you also enter the same information in the other bind address fields on this page. This setting is for use in an environment with a firewall, a VPN, or multiple network connections. For more information, see Firewalls, VPNs, and multihomed machines.
CICS® Stub Server Port	The port where Rational® Integration Tester listens for CICS® Stub Server requests. This setting is for use in an environment with a firewall, a VPN, or multiple network connections. The value must refer to a unique port number that is open in the firewall. For more information, see Firewalls, VPNs, and multihomed machines.
CICS® Stub Server Bind Address	The host name or IP address to which Rational® Integration Tester is bound for CICS® Stub Server requests. In most cases, you also enter the same information in the other bind address fields on this page. This setting is for use in an environment with a firewall, a VPN, or multiple network connections. For more information, see Firewalls, VPNs, and multihomed machines.
IDB Client Port	The port where the integrated simulation database listens for JDBC requests.
IMS™ Connect Stub Server Bind Address	The host name that is used for any IMS™ Connect stubs created by using Rational® Integration Tester. If a host name is not specified, Rational® Integration Tester uses `localhost` as the default value.
Security Policy	Reserved for future use.
CentraSite Publication fields	The default fields to be made available for publishing test suite summary reports to a configured CentraSite server. For more information, see Testing with Software AG CentraSite.
Feature Enablement	Enter the code from a license to enable extended features.
Default Network Device	The default, local network device to use for any direct network-related tasks, such as capturing HTTP packets. The properties of the selected device are displayed below the selection.
Networking	Prefer IPV4 : The application will prefer IPv4 addresses over IPv6 ones where possible. Prefer IPV6 : The application will prefer IPv6 addresses over IPv4 ones where possible. For more information see Internet Protocol IPv4 and IPv6
JVM Arguments	Arguments to pass to the JVM used by Rational® Integration Tester and the command-line application. For example, to set the maximum amount of memory (in MB) allocated to the Java™ heap, you would use the format `-Xmxmem_sizem`, and specify a size, such as`-Xmx512m`. Note: Each argument must be entered on a separate line in Library Manager.

Third-party plug-ins

The third-party systems (plug-ins) that Rational® Integration Tester supports are listed on the left side of Library Manager. For each plug-in, one or more providers can be configured. Generally speaking, a provider is a version of an application whose libraries are needed by Rational® Integration Tester to interact with the application. Each provider requires a specific set of libraries for use by Rational® Integration Tester.

Each plug-in is configured in two sections of Library Manager. The specific provider is selected in the upper portion of the screen. The libraries that are required by that provider are specified or customized in the lower portion of the screen.

In the example that is shown, the TIBCO Runtime Agent is selected and the JAR files are displayed. The support for TIBCO BusinessWorks is provided by an installation of the Runtime Agent that when installed shows in the specified default location on the C: drive.

For the provider you want to use with Rational® Integration Tester, select the check box next to the specific provider name. If you do not select the relevant check box, Library Manager does not apply the changes.

Note: For certain provider-types, only one specific provider at a time can be selected for use by Rational® Integration Tester.