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 <Rational Integration Tester Platform Pack installation directory>\JavaVirtualization\agent contains configuration settings for the Java virtualization agent.

Procedure

Use a text editor to open the registration.xml file.

Edit the configuration settings as shown in the following table:

Table 1. Java virtualization agent configuration settings
Configurable setting	Description
`server base-url = "http://<Host name or IP address selected during installation of Rational Test Control Panel>:7819/RTCP/"`	By default, an IBM® Rational® Test Control Panel installation listens for the registration of IBM Rational Integration Tester agents and proxies on port `7819`. 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 IBM Installation Manager to install IBM Rational Integration Tester Platform Pack. Note: If you do not specify a Rational Test Control Panel URL, you will not be able to monitor the Java virtualization agent.
`logger level`	Options are as follows: debug error info warning
`identifier name` Note: This setting is available only in Rational Integration Tester Platform Pack 8.5.0 or later.	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. Note: Only Rational Test Control Panel 8.6.0 or later can display identifier names of agents (and proxies).
`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` Note: This setting is available only in Rational Integration Tester Platform Pack 8.6.0 or later.	Setting the initial state to `on` will set the Observation level for this intercept in Rational Test Control Panel 8.6.0 or later to Statistics when the intercept first registers with Rational Test Control Panel. Setting the initial state to `off` will set the Observation level for this intercept t in Rational Test Control Panel 8.6.0 or later to None when the intercept first registers with 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.

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; otherwise, the changes will not take effect.

Feedback