2.6.  Test Center as Backend Services

Table of Contents

2.6.1. Test Center as Windows service
2.6.2. Apache Reverse Proxy Example
2.6.3. Hitch TLS Proxy

This section shows examples of how to start Test Center as a Windows service as well as to how to integrate Test Center in an existing Web service setup and/or to enable HTTPS access to Test Center. The Test Center TCP listen port can be configured in the application.ini file located in config directory. The option is ListenPort. Its value may also be a unix domain socket, e.g. ListenPort=unix:/tmp/testcenter.

2.6.1.  Test Center as Windows service

The following steps describe the actions that need to be taken to start Test Center as a Windows service. First, install the service via the following commandline:

bin\testcenter service-install

Note that this might require elevated privileges to work without error. Now you can start it in the Services panel from Windows. In case the service fails to start then Test Center will output information in the Event log of Windows. Stopping Test Center service can be done in the same place where it was started, the Services panel. Finally it is also possible to uninstall the service by running the following commandline:

bin\testcenter service-uninstall

2.6.2.  Apache Reverse Proxy Example

Here is an example of Reverse Proxy using an Apache Web server. The modules mod_proxy and mod_proxy_http must be enabled

cd mods-enabled/
ln -s ../mods-available/proxy.load .
ln -s ../mods-available/proxy_http.load .
ln -s ../mods-available/proxy_wstunnel.load .
ln -s ../mods-available/rewrite.load .

The following VirtualHost configuration forwards requests to Testcenter's default port 8800 on the same host:

<VirtualHost _default_:443>
        ProxyPass        / http://localhost:8800/ connectiontimeout=600 timeout=600
        ProxyPassReverse / http://localhost:8800/
        ProxyPreserveHost On
        ProxyRequests Off
        RewriteEngine on
        RewriteCond %{HTTP:Upgrade} websocket [NC]
        RewriteCond %{HTTP:Connection} upgrade [NC]
        RewriteRule ^/?(.*) "ws://localhost:8800/$1" [P,L]
        SSLEngine on
        SSLCertificateFile    your-crt-file.crt
        SSLCertificateKeyFile your-key-file.key

2.6.3.  Hitch TLS Proxy

Below is a configuration of the hitch proxy server, which can be used as an SSL frontend for Test Center.

frontend = {
    host = "*"
    port = "443"
backend = "[]:8800"
pem-file = "your-pem-file.pem"