Share this page

# Connect with the VTS server

The data in the VTS table is maintained on a server known as the VTS server. The name or IP address of the VTS server is displayed after Server Name, in the top left of the VTS user interface.

In this topic:

## Access the VTS server

You can access the data in the VTS table in any of the following ways:

Item | Description
--- | ---
VTS user interface | You can use the standard functionality in the VTS user interface to access data in the VTS table. For example, you can modify an existing parameter value or add a new value. For details, see Manipulate the contents of the VTS table. The VTS Service Windows service enables UI access to the VTS table. By default, when VTS is installed, VTS Service is set to start automatically. If you experience problems accessing VTS, make sure that VTS Service is started. By default, port 4000 is used for UI access to VTS. For details on changing the default UI access port, see Configure VTS.
Vuser scripts | Vuser scripts can include API functions that enable Vusers to read and modify data in the VTS table. VTS lets you enable or disable API access to the VTS server. When you enable API access, you must specify the port that Vuser scripts use to access the VTS server. The currently used port is displayed after API Access Port, in the top left of the VTS user interface. The default API access port is 8888, and a direct connection is needed between the VTS server and the load generator machine. For details on how to change the default API access port, see Configure VTS. To enable API access to the VTS server, from the Enabled/Disabled dropdown, click Enabled. In the Enable Script Access dialog box, enter the API access port. To disable API access to the VTS server, from the Enabled/Disabled dropdown, click Disabled.

## Enable port forwarding

If your VTS server can only open port 80 or 443 for inbound communications, but many VTS instances are already running on those ports, you can use port forwarding or reverse proxy to redirect communication requests from one port to another. This enables you to connect to your VTS server and work normally.

To enable VTS port forwarding:

1. Configure the VTS service host machine to support port forwarding. The machine should forward requests on port 80 to the true port passed in the URL query string (portnumber).

   See the Example configurations below.

2. Enable port forwarding in the script runtime settings.

   1. In the script runtime settings, open the General > Miscellaneous tab.
   2. In the VTS section, select the Access VTS port by query string checkbox.
   3. Change the HTTP or HTTPS port value as needed (the default ports are 80 for HTTP and 443 for HTTPS).

3. Use the existing VTS API to connect to the VTS server.

## Example configurations

The following are common configuration examples.

### NGINX web server

Copy code

    server {
        listen  80;
        server_name  localhost;

        location / {
            if ($query_string ~* ^portnumber=(\d+)(.*)$) {
                set $port $1;
                set $para $2;
                proxy_pass http://127.0.0.1:$port$para;
                       }
                       proxy_pass http://127.0.0.1;
        }
    }

### HAProxy

Copy code

    frontend http-in
      bind *:8080
      use_backend apiserver-8888 if { urlp(portnumber) -i 8888/api/ }
      use_backend default

    #apiserver
    backend apiserver-8888
      mode http
      http-request replace-path /(.*) /api/
      option forwardfor
      server instance 127.0.0.1:8888
    #admin UI
    backend default
      mode http
      option forwardfor
      server ui 127.0.0.1:4000

## See also

- Use authentication
- VTS Data

https://admhelp.microfocus.com VuGen,Professional Performance Engineering,Performance Engineering for Developers 8942
Tips to improve your search results... OpenText™ Virtual User Generator Help Center OpenText™ VuGen Help 26.1-26.3 All View Local Help Center View Online Help Center Version: