Setting up the HTTP proxy

When you want to run stubs on HCL OneTest™ Server, you must set up an HTTP proxy that the stubs can use. You must configure the HTTP proxy with the HCL OneTest™ Server URL and offline user token generated from HCL OneTest™ Server so that the HTTP proxy can register with HCL OneTest™ Server.

Before you begin

Before you set up the HTTP proxy, you must ensure that the following conditions are satisfied:
  • You have installed HCL Quality Server V10.1.1 and enabled the HTTP proxy to register with HCL OneTest™ Server V10.1.1.
  • You have installed HCL OneTest™ API V10.1.1 and created the stubs and configured them to use the HTTP proxy.
  • You are using HCL OneTest™ Server V10.1.1 to start the stubs.
Important: The version of the software packages that you use to install HCL Quality Server, HCL OneTest™ API, and HCL OneTest™ Server must be the same. If the versions are not the same, you cannot start the stubs from HCL OneTest™ Server.

About this task

Important: You must set up the HTTP proxy server by using the same version as the version of HCL OneTest™ Server.
When you create stubs in HCL OneTest™ API, 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 HCL OneTest™ Server URL and offline user token as the values for the attributes. After you restart the proxy, the HTTP proxy registers with HCL OneTest™ 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 HCL OneTest™ API 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 HCL OneTest™ Server:
    1. Log in to HCL OneTest™ 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 HCL OneTest™ Server URL and offline user token generated from HCL OneTest™ Server in the following setting:

      <server base-url="<HCL OneTest™ Server_URL>" security-token="<Offline_User_Token>" />

    3. Save and close the file.
    4. Restart the HTTP proxy.
  4. Perform the following steps in HCL OneTest™ Server:
    1. Log in to HCL OneTest™ 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.