Modifying the configuration settings of the Java™ virtualization agent

You can modify the registration.xml file of the Java™ virtualization agent to change the server address, log level, and other settings.

About this task

The registration.xml file in JavaAgent.zip package that is provided with Rational® Test Control Panel contains configuration settings for the Java™ virtualization agent.

Procedure

Download and extract the Java™ Virtualization Agent package that is provided with Rational® Test Control Panel. For more information, see Rational Integration Tester tool packages.
From the extracted JavaAgent package, open the registration.xml file using a text editor.

Edit the configuration settings as shown in the following table:

Table 1. Java™ virtualization agent configuration settings
Configurable setting	Description
`server base-url = "https://Host name or IP address selected during installation of Rational® Test Control Panel>:5443/RTCP" security-token="" />`	By default, an Rational® Test Control Panel installation listens for the registration of Rational® Integration Tester proxies and agents on port `5443`. If your Rational® Test Control Panel installation is using a different port number, enter the number in the server URL setting. This port number can also be configured when you are using Installation Manager to install the Rational® Test Control Panel. Note: If you do not specify a Rational® Test Control Panel URL, you will not be able to monitor the Java™ virtualization agent. Set the `security-token` value if you want to use domain-level security for the proxy. For more information about security-tokens, see Configuring agents and proxies to use security tokens.
`ssl`	The SSL connection details that you want to use to connect to the server. The SSL element is optional. If the `ssl` element is not included, then the proxy uses the Java keystore location and password that is found in the system properties javax.net.ssl.trustStore and javax.net.ssl.trustStorePassword. If these properties are not set, then the proxy trusts all server certificates. `trustAll` If set to true, this attribute tells the proxy to trust all certificates that are presented by the server. In this case, the `trustStore`, `trustStoreType` and `trustStorePassword` attributes are ignored. `trustStore` The path to the keystore that contains the trusted certificates that are used to verify the certificate that is presented by the server. By default this attribute's value is set to the path of the greenhatTrusted.jks keystore, which is included with the HTTP/TCP proxy and contains the Rational® Integration Tester Root CA certificate. If the server's certificate was changed, then this value must also be changed to point to a keystore that contains a certificate that can be used to verify the new server certificate. For more information about configuring the server certificate, see Using your own truststore for server SSL connections. `trustStoreType` The type attribute specifies the type of the keystore. If not specified, the default value is `jks`. `trustStorePassword` The password attribute specifies the password that is used to load the keystore file. The password for the default truststore is `passphrase`. `protocol` The protocol attribute defines the SSL handshake protocol used to connect to the server. Default value: `SSL_TLSv2, TLS`. The specified default options are checked for availability. SSL_TLSv2 protocol is supported by the JRE and, if it is unavailable, the TLS protocol is used.
`logger level`	Options are as follows: debug error info warning
`identifier name`	This setting enables you to specify a name for this agent. This makes it easier to identify a specific agent when there are two or more agents of the same type registered with Rational® Test Control Panel. Note: By default, this setting is commented out. Therefore, to use this setting, you must first uncomment it and then edit the identifier name.
`domains`	Ordinarily, there is no need to edit the `domain` and `environment` tags. However, if Rational® Test Control Panel is used to set up specific business domains and environments, you might make the following changes to the setting: Set the name attribute of the `domain` tag to the domain name in the Rational® Integration Tester project that is being used to intercept and record Java™ method calls. Set the name attribute of the `environment` tag to the name of the environment that is selected in the Rational® Integration Tester project for recording or virtualizing Java™ method calls.
`statistics initial-state`	Setting the initial state to `on` will set the Observation level for this intercept in Rational® Test Control Panel to Statistics when the intercept first registers with the Rational® Test Control Panel. Setting the initial state to `off` will set the Observation level for this intercept in Rational® Test Control Panel to None when the intercept first registers with the Rational® Test Control Panel. Note: For Java™ virtualization intercepts, the only statistics reported are statistics for interactions that are recorded or stubbed. Statistics for general interactions are not reported.
`reporting frequency`	By default, observations are reported every 10 seconds. If you increase the reporting interval, fewer observation messages are sent over the network, but the data is not available to Rational® Integration Tester as frequently. The value is specified in seconds, and values between 5 and 30 are allowed.
`capture`	Set this property to `on` to capture credentials when you observe JMS requests.

Save and close the file.

Results

If you make any changes to the registration.xml file after deploying the Java™ virtualization agent, you must restart the Java™ application into which the agent is installed. If you do not restart the application, the changes will not take effect.