Menu

Install and Register the Automation Host

Download the Automation Agent onto the location machine where the automation scripts are deployed. Run the Automation Agent on the machine so that it is registered in qTest as an Automation Host. 

NOTE: Java 7 or 8 needs to be installed in your Automation Host so our qTest Automation Agents can work properly.

1. Download Automation Agent Tool

  1. Login to your qTest application and go to qTest's Resources page.
  2. Click on the link to download the Automation Agent tool for the OS of the local machine in which your automation scripts are deployed

2. Install the Automation Host

Install on Windows

PREREQUISITE: Java version 1.7+ should be installed on your machine and JAVA_HOME environment variable has been configured before proceeding.

  1. After the zip file (qtest-automation-x.x.x.zip) has been downloaded, extract it. 
  2. By default, the tool will use domain localhost and port 6789 when it is running. However, you can change the default values:
    1. Create an environment variable named AGENT_SERVER_HOST and specify your desired domain name or this machine's IP address. If you are using a domain name, you will need to map the machine's IP Address with the domain name. Eg: AGENT_SERVER_HOST: 192.168.76.1
    2. Create an environment variable named AGENT_SERVER_PORT and specify your desired port number. Eg: AGENT_SERVER_PORT: 6789
  3. If you want to use other Java version than the one specified in JAVA_HOME, you can create variable named QA_AGENT_JAVA_HOME and specify your desired Java home directory. Eg: C:Program FilesJavajdk1.7.0_25
  4. Open a command console and change the current path to the extracted Automation Host tool directory. Extracted_Automation_Host.png
  5. Execute the following command to install the tool.
    service install
  6. After the service has been installed, run the below command to start it. 
    service start
  7. Check the services which were installed on your local server and search for qTest Automation Agent. Right click on the qTest Automation Agent service, select Properties and change its Startup Type to Automatic
  8. Open your browser and access to the URL with the domain and port as you specified above (eg: localhost:6789).
  9. Proceed to Register the Automation Host

Install on CentOS

PREREQUISITES:

  • 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.
  1. Download qtest-automation-x.x.x.noarch.rpm and qtest-automation-1.0.0.tar.gz from qTest Resources page. 
  2. 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
  3. 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.

  4. 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

    IMPORTANT: 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
  5. Open your browser and access to the URL with the domain and port as you specified above (eg: localhost:6789). 
  6. Proceed to Register the Automation Host

Install on Ubuntu

PREREQUISITES:

  • 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 steps below
  1. After you have downloaded the debian file (qtest-automation-x.x.x.deb) to your machine, execute the following command: 
    # dpkg -i qtest-automation-1.0.0.deb
  2. By default, the tool will use domain localhost and port 6789 when it is running. However, you can change the default values:
    • Modify file /etc/default/qtest-automation.
    • Change the value of AGENT_SERVER_PORT and specify your desired port number.
    • Change the value of AGENT_SERVER_HOST and specify your desired domain name. 
      # vim /etc/default/qtest-automation
      AGENT_SERVER_PORT=6879
      export AGENT_SERVER_PORT
      AGENT_SERVER_HOST=192.168.74.80
      export AGENT_SERVER_HOST
      SERVER_WORK_DIR=/var/lib/qtest-automation
      export SERVER_WORK_DIR
      DAEMON=Y
      JAVA_HOME=/usr/lib/jvm/java-8-oracle/jre
      export JAVA_HOME
  3. Verify status of qtest-automation service: 
    # invoke-rc.d qtest-automation status
  4. If it is not running, start the service by the command below: 
    # invoke-rc.d qtest-automation start
    IMPORTANT:  New group qas and new user qas have been created during the installation.
  5. 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
  6. Change access permissions in your working automation project 
    # chmod -R g+rw /usr/local/ automation _demo /testng
  7. Open your browser and access to the URL with the domain and port as you specified  above (eg: localhost:6789). 
  8. Proceed to Register the Automation Host

Install on Mac

PREREQUISITE: Java version 1.7+ should be installed on your machine before proceeding

  1. After the zip file (qtest-automation-x.x.x-release-osz.zip) has been downloaded, place it in a directory on your machine. Extract it and you will find the installation file. 
  2. By default, the tool will use domain localhost and port 6789 when it is running. However, you can change the default values:
    1. Right click on the installation file and choose Show Package Contents
    2. Open and modify file Info.plist
    3. Input your desired domain and port values and close the file. 
  3. Double click on the installation file. The tool will be starting up. You can find its icon at the bottom bar. 
  4. After it has started up, it will open your browser.
  5. Proceed to Register the Automation Host

3. Register the Automation Host

  1. When you open the Automation Host for the very first time, you will need to register it with your qTest account. Input the following information into the Automation Host Registration window: 
    1. 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.
    2. qTest URL: the URL to access to your qTest application.
    3. Full Name: the displayed name of your qTest account.
    4. qTest username and Password: the credentials to login to your qTest application. Make sure that this user has the permissions within the project to Create Test Cases and Execute Test Runs permissions
    5. 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 
  2. Click on Register button to register the host with your qTest account.
  3. On the next screen, you can see the status indicates that the Automation Host has been registered successfully.
  4. From this screen, you can also modify the Polling frequency to select how often your automation agents will poll qTest for new automation schedules. Click on Save button to save the host's configurations. 

Once the Automation Host is registered, make sure to install framework plugins. Check out this article for next steps: Install Automation Agents

If your Automation Host is offline, check out this article to Restart the Automation Host.

Subscribe To Our Blog
Powered by Zendesk