Working with Library Manager

HCL OneTest™ API 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 HCL OneTest™ API that is used to manage the libraries (Java™ JAR files) that are required by different plug-ins.

Important: If HCL OneTest™ API 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 HCL® program group (default is IBM > HCL OneTest™ API).
Click the LibConfig.exe file in the installation directory of HCL OneTest™ API.

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 HCL OneTest™ API installation directory. To ensure that Library Manager can write to the HCL OneTest™ API installation directory, the user ID used to install HCL OneTest™ API must be used when running Library Manager.

On the Library Manager application window, HCL OneTest™ API 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 HCL OneTest™ API 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 HCL OneTest™ API 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 HCL OneTest™ API. Allocating more memory can increase the performance of the application.
HTTP Bind Address	When HCL OneTest™ API 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 HCL OneTest™ API 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 HCL OneTest™ API 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 HCL OneTest™ API 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 HCL OneTest™ API 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 HCL OneTest™ API 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 HCL OneTest™ API 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 HCL OneTest™ API 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 HCL OneTest™ API 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 HCL OneTest™ API. If a host name is not specified, HCL OneTest™ API uses `localhost` as the default value.
Security Policy	Reserved for future use.
Original Software Path	The path to the Original Software TestDrive testing module, version 6 or earlier. This path is used for running scripts and action maps with the GUI Interaction test action, where you specify the directory that contains the Programs folder.
Original Software v7 Path	The path to the Original Software TestDrive testing module, version 7 or later.
Hewlett Packard Path	The installation path of HP QuickTest Professional, which is required for running QTP scripts with the GUI Interaction test action.
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 HCL OneTest™ API 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 HCL OneTest™ API 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 HCL OneTest™ API to interact with the application. Each provider requires a specific set of libraries for use by HCL OneTest™ API.

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 HCL OneTest™ API, 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 HCL OneTest™ API.