Setting up intercepts

When you want to run virtual services on IBM® Rational® Test Automation Server, you can set up intercepts to route requests to the virtual service. You must configure the intercepts with the IBM® Rational® Test Automation Server URL, team space ID, and offline user token that is generated from IBM® Rational® Test Automation Server so that the intercepts can register with IBM® Rational® Test Automation Server.

Examples of intercepts include the HTTP proxy component of Rational® Test Control Panel and the Rational® Integration Tester Java virtualization agent available from the Rational® Test Control Panel tools page.

Before you begin

You must have completed the following tasks:

Installed the intercept from Rational® Test Control Panel of the same version as that of Rational® Test Automation Server. For example, installed the HTTP proxy.
Read the following procedures:
- Generating offline user tokens. See Managing access to IBM Rational Test Automation Server.
- Viewing the Team Space ID as the URL alias of the team space. See Viewing the configuration of a team space.

About this task

You must edit the registration.xml file for the intercept to allow it to register with Rational® Test Automation Server.

Procedure

Perform the following steps in Rational® Test Automation Server:
1. Log in to Rational® Test Automation Server.
  
  The Team Space Dashboard page is displayed.
2. Generate the offline user token by clicking the User icon , and then click Create Token.
3. Copy the offline user token to a text file.
4. Click the Settings icon of the team space in the My Team Spaces page.
  
  The Team Space Configuration page is displayed.
5. Copy the text that is displayed under URL alias as the Team Space ID.

Perform the following steps to edit the registration.xml file for the intercept. For most intercepts this is in the root directory of the extracted intercept compressed file. For the HTTP/TCT proxy it is in the <RTCP_install_directory>\httptcp directory on the computer on which you have installed Rational® Test Control Panel.

Open the registration.xml file by using a text editor.

Enter the values for the following attributes:

Note: If an entry exists, you must either comment out that entry and add a new one or replace the contents with the values indicated.


Attribute	Value
server base-url	URL of Rational® Test Automation Server
security-token	Offline user token generated from Rational® Test Automation Server
team-space-id	ID of the team space to which the proxies must register

Save and close the file.
Perform any of the following actions:
- Restart the HTTP proxy, if you updated the registration.xml file of the HTTP/TCP proxy.
- Restart the application that is configured to use the any of the other intercepts other than HTTP/TCP.

Perform the following steps in Rational® Test Automation Server to view the HTTP proxies that are registered in the team space:
1. Log in to Rational® Test Automation Server.
2. Click Infrastructure > Agents and Intercepts to view the registered intercepts.
  
  The intercepts that you configured with your offline user token and Team Space ID are displayed.

Results

You have successfully configured intercepts and viewed that they are registered with the team space in Rational® Test Automation Server.

What to do next

You can perform the following tasks:

Read for the prerequisite tasks that you must perform before you can run the HTTP virtual services. See Prerequisites for running HTTP virtual services in a Kubernetes cluster.
Run the virtual service resource. See Configuring a run of a virtual service.
View the routing rules for the intercept. See Viewing routing rules of the virtual services.
View the routing rules for the intercept in a running instance of the virtual service. See Viewing configurations of running instances of virtual services.