Setting up the HTTP proxy

When you want to run HTTP virtual services on HCL OneTest™ Server, you can set up an HTTP proxy to route requests to the virtual service. 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

You must have completed the following tasks:

Installed the proxy component from HCL® Quality Server of the same version as that of HCL OneTest™ Server.
Read the following procedures:
- Generating offline user tokens. See Managing access to HCL OneTest 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 that is located in the <QS_install_directory>\httptcp directory for the following attributes:

server base-url
security-token
team-space-id

You must enter the HCL OneTest™ Server URL, offline user token, and the ID of the team space to which the proxies must register as the values for the attributes. After you restart the proxy, the HTTP proxy registers with the team space on HCL OneTest™ Server. You can view the registered intercepts from the Infrastructure > Agents and Intercepts page in your team space.

Procedure

Perform the following steps in HCL OneTest™ Server:
1. Log in to HCL OneTest™ 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 that is located in the <QS_install_directory>\httptcp directory on the computer on which you have installed HCL® Quality Server:

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 HCL OneTest™ Server
security-token	Offline user token generated from HCL OneTest™ Server
team-space-id	ID of the team space to which the proxies must register

Save and close the file.
Restart the HTTP proxy.

Perform the following steps in HCL OneTest™ Server to view the HTTP proxies that are registered in the team space:
1. Log in to HCL OneTest™ Server and open the team space that contains your project.
2. Click Infrastructure > Agents and Intercepts to view the registered intercepts.
  
  The HTTP proxies that you configured with your offline user token and Team Space ID are displayed.

Results

You have successfully configured the HTTP proxies and viewed that they are registered in the team space on HCL OneTest™ 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.