Setting up the HTTP proxy

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

Before you begin

You must have installed the proxy component from Rational® Test Control Panel of the same version as that of Rational® Test Automation Server.

About this task

You must edit the registration.xml file that is located in the <RTCP_install_directory>\httptcp directory for the following attributes:

server base-url
security-token

You must enter the Rational® Test Automation Server URL and offline user token as the values for the attributes. After you restart the proxy, the HTTP proxy registers with Rational® Test Automation Server. You can view the registered intercepts from the Infrastructure > Agents and Intercepts page.

Procedure

Perform the following steps in Rational® Test Automation Server:
1. Log in to Rational® Test Automation Server.
2. Generate the offline user token.
3. Copy the offline user token to a text file.
Perform the following steps to edit the registration.xml file that is located in the <RTCP_install_directory>\httptcp directory:
1. Use a text editor to open the registration.xml file.
2. Enter the Rational® Test Automation Server URL and offline user token generated from Rational® Test Automation Server in the following setting:
  
  <server base-url="<Rational® Test Automation Server_URL>" security-token="<Offline_User_Token>" />
  Note: If an entry exists, you must either comment out that entry and add a new one or replace the contents.
3. Save and close the file.
4. Restart the HTTP proxy.
Perform the following steps in Rational® Test Automation Server:
1. Log in to Rational® Test Automation Server.
2. Click Infrastructure > Agents and Intercepts to view the registered intercepts.
  
  The HTTP proxies that you configured with your offline user token are displayed.

Results

You have successfully configured the HTTP proxy and viewed that it is registered with 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 stubs. See Prerequisites for running HTTP virtual services.
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.