6.2.2 Installing & Configuring Automation Host on CentOS

»Install and Configure your Automation Host

»Stop your Automation Host

Install and Configure your Automation Host


  • Java version 1.7+ has been installed on your machine and JAVA_HOME environment variable has been configured before you run the tool.
  • You will need to switch to Root user before executing the below steps.

Download qtest-automation-x.x.x.noarch.rpm and qtest-automation-1.0.0.tar.gz from qTest Resources page.


After file qtest-automation-x.x.x.noarch.rpm has been downloaded, place it in a directory on your machine (eg: /usr/local) and run the following commands.

# cd /usr/local
# rpm -ivh qtest-automation-x.x.x.noarch.rpm


By default, the tool will use domain localhost and port 6789 when it is running. However, you can change the default values:

  • Create an environment variable named AGENT_SERVER_HOST and specify your desired domain name.
  • Create an environment variable named AGENT_SERVER_PORT and specify your desired port number.
# export AGENT_SERVER_PORT=5768

After file qtest-automation-1.0.0.tar.gz has been downloaded, place it in a directory on your machine (eg: /usr/local) and run the following commands.

# cd /usr/local
# tar –zxf qtest-automation-x.x.x.tar.gz
# cd qtest-automation-x.x.x
#  ./start-server.sh


  • New group qas and new user qas have been created during the installation.
  • If you want your Automation projects to integrate with qTest, you will need to associate group qas with your project directories.
    # chgrp -R qas /usr/local/automation_demo/testng
  • Change access permissions in your working automation project
    # chmod -R g+rw /usr/local/ automation _demo /testng

Open your browser and access to the URL with the domain and port as you specified  above (eg: localhost:6789). For the very first time, you will need to input the following information:

  • Host Name: the displayed name of this host in your qTest application. For now, you will not be able to modify this field after registering.
  • qTest URL: the URL to access to your qTest application.
  • Full Name: the displayed name of your qTest account.
  • qTest username and Password: the credentials to login to your qTest application.
  • If a proxy server is being used, click on Configure Proxy and then enter its info so the agent is able to submit test results to your qTest instance
    • Enable: select it in case a proxy is used
    • Host (required): host name or IP address of the proxy server
    • Port (required): port number of the proxy server
    • Username and Password: you can specify the domain before your username

After you have done filling in the information, click on Register button to register the host in your qTest.



  • It is strongly recommended that the account is granted with Create Test Cases and Execute Test Runs permissions.

On the next screen, you can see the status indicates that the Automation Host has been registered successfully. You can also modify the followings:

  1. Polling frequency: select how often your automation agents will poll qTest for new automation schedules.
  2. Automation frameworks: there is a plugin for each supported framework. You can freely download the framework your project is working on from the list by clicking on the Download icon.
  3. Automation Agents: you can create new agents or edit existing ones' configurations.

Click on Save button to save the host's configurations.

To verify if the host has been registered successfully in qTest:

  • Login to your qTest application and access to any projects in which Automation Integration feature is activated.
  • Click on Automation Settings and choose tab Schedules.
  • You will see the list of registered Automation Host in the left panel.


  • It is required that your qTest account is granted with Manage Project Settings permission to view registered host and agents' schedules in qTest.

Stop your Automation Host

# cd /usr/local/qtest-automation-x.x.x
# ./stop-server.sh