Setting up the HTTP proxy

When you want to run stubs on Rational® Test Automation Server, you must set up an HTTP proxy that the stubs can use. 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

Before you set up the HTTP proxy, you must ensure that the following conditions are satisfied:
  • You have installed Rational® Test Control Panel V10.1.1 and enabled the HTTP proxy to register with Rational® Test Automation Server V10.1.1.
  • You have installed Rational® Integration Tester V10.1.1 and created the stubs and configured them to use the HTTP proxy.
  • You are using Rational® Test Automation Server V10.1.1 to start the stubs.
Important: The version of the software packages that you use to install Rational® Test Control Panel, Rational® Integration Tester, and Rational® Test Automation Server must be the same. If the versions are not the same, you cannot start the stubs from Rational® Test Automation Server.

About this task

Important: You must set up the HTTP proxy server by using the same version as the version of Rational® Test Automation Server.
When you create stubs in Rational® Integration Tester, you must configure the HTTP proxy in the Client tab for the HTTP transport. You must also edit the registration.xml file that is located in the <QS_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. When you start the stubs from the Execution page, the stubs run on the HTTP proxy configured in the transport.

Procedure

  1. Perform the following steps in Rational® Integration Tester before you commit the test resources to the remote repository:
    1. Open the HTTP transport in the Physical View.
    2. Click the Client tab.
    3. Enter the host name or IP address of the computer that hosts the proxy server in the Proxy Host field.
    4. Enter the number of the port that is configured to connect with the proxy server in the Proxy Port field.
    5. Save and commit the project to the remote repository.
  2. 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.
  3. Perform the following steps to edit the registration.xml file that is located in the <QS_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>" />

    3. Save and close the file.
    4. Restart the HTTP proxy.
  4. Perform the following steps in Rational® Test Automation Server:
    1. Log in to Rational® Test Automation Server.
    2. Open your project.
    3. Click Infrastructure.

    The HTTP proxies that you configured with your offline user token are displayed.

Results

You have successfully configured the HTTP proxy.

What to do next

You can check for the prerequisite tasks that you must complete before you can run the HTTP stubs. See Prerequisites for running HTTP stubs.