Setting up intercepts

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

Examples of intercepts include the HTTP proxy component of HCL® Quality Server and the HCL OneTest™ API Java virtualization agent available from the HCL® Quality Server tools page.

Before you begin

You must have completed the following tasks:

Installed the intercept from HCL® Quality Server of the same version as that of HCL OneTest™ Server. For example, installed the HTTP proxy.
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 for the intercept to allow it to register with HCL OneTest™ Server.

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 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 <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.
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 HCL OneTest™ Server to view the HTTP proxies that are registered in the team space:
1. Log in to HCL OneTest™ 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 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 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.