Menu

Install qTest Automation Agent Host 1.3.8 on Linux

In this article, we will walk you through how to install the qTest Automation Agent Host version 1.3.8 on Linux machine.

1. Download qTest Automation Agent Host 1.3.8

1.1. Go to this page Download Automation Agent Host and download the qTest Automation Agent Host 1.3.8 for Linux

1.2. Open Terminal

1.3. Move the downloaded file agentctl-1.3.8-linux-x64-full.tgz to /usr/local directory:

$ sudo mv agentctl-1.3.8-linux-x64-full.tgz /usr/local

Note: you can move the package to /usr/local or wherever you'd like; sudo is only needed depending on the location it will be moved

1.4. Change current directory to /usr/local:

$ cd /usr/local

1.5. Extract the bundle:

$ tar -zxf agentctl-1.3.8-linux-x64-full.tgz

1.6. Change current directory to the extracted agentctl-1.3.8:

$ cd agentctl-1.3.8

2. Install and Configure the Automation Agent Host

Execute following command to install and configure the automation agent.

/usr/local/agentctl-1.3.8 $ ./agentctl config -Phost=[ip_address] -Pport=[agent_port] -Pqtest.url=[qtest_url] -Pqtest.username=[qtest_username] -Pqtest.password=[qtest_password] -Pproxy.enable=true -Pproxy.host=[proxy_host] -Pproxy.port=[proxy_port] -Pproxy.username=[proxy_username] -Pproxy.password=[proxy_password]

Command parameters description:

Parameter Name Description
 config Execute the configuration command
-Phost IP address or host name or domain name of this machine. If this parameter is omitted, the agent will use the current IP address of this machine
-Pport Specify a port that your automation agent host will be running on. If this parameter is omitted, port 6789 will be used
-Pqtest.url Url of your qTest Manager instance
-Pqtest.username User name used to login to qTest Manager
-Pqtest.password Password used to login to qTest Manager
-Pproxy.enable Possible value is true or false. It the value is true, you will need to provide proxy settings, otherwise, set it to false
-Pproxy.host The IP address or machine name of the proxy server
-Pproxy.port The port that the proxy server is running on
-Pproxy.username If your proxy server requires basic authentication, enter user name to authenticate with the proxy
-Pproxy.password If your proxy server requires basic authentication, enter password to authenticate with the proxy

 

Configure qTest Automation Agent Host without proxy

Example command below shows how to configure the qTest Automation Agent Host 1.3.8 in a non-proxy environment. The values for each parameter are highlighted in bold

/usr/local/agentctl-1.3.8 $ ./agentctl config -Phost=192.168.76.29 -Pport=6789 -Pproxy.enable=false -Pqtest.url=https://demo.qtestnet.com -Pqtest.username=demouser1@qasymphony.com -Pqtest.password=n0thIng4y0u

Configure qTest Automation Agent Host with proxy settings

Example command below shows how to configure the qTest Automation Agent Host 1.3.8 in a proxy environment. The values for each parameter are highlighted in bold

If your proxy does not require authentication:

/usr/local/agentctl-1.3.8 $ ./agentctl config -Phost=192.168.76.29 -Pport=6789 -Pqtest.url=https://demo.qtestnet.com -Pqtest.username=demouser1@qasymphony.com -Pqtest.password=n0thIng4y0u -Pproxy.enable=true -Pproxy.host=192.168.76.138 -Pproxy.port=3128

If your proxy does requires basic authentication with user name and password:

/usr/local/agentctl-1.3.8 $ ./agentctl config -Phost=192.168.76.29 -Pport=6789 -Pqtest.url=https://demo.qtestnet.com -Pqtest.username=demouser1@qasymphony.com -Pqtest.password=n0thIng4y0u -Pproxy.enable=true -Pproxy.host=192.168.76.138 -Pproxy.port=3128 -Pproxy.username=proxyuser@qasymphony.com -Pproxy.password=s0mething#0923

IMPORTANT: Add system environment variable

Open Terminal and execute this command to identify Java version: $ java -version

If the execution result showing your machine is running Java whose version is between 1.8.0_77 and 1.8.0_151, you must add an environment variable to make proxy with basic authentication work properly following below steps:

  • Run below command to edit the bash_profile file: $ vi ./bash_profile
  • Add this line to the bash_profile file: export JAVA_TOOL_OPTIONS=-Djdk.http.auth.tunneling.disabledSchemes=""
  • Below screenshot shows how your updated bash_profile file looks like

bash_profile.png

  • Save the file when you're done.
  • Next, execute below command to load the updated bash_profile: $ source ~/.bash_profile
  • Verify the variable is loaded:  $ echo JAVA_TOOL_OPTIONS
  • If you see the output -Djdk.http.auth.tunneling.disabledSchemes= printed in the Terminal, then you have successfully added a new environment variable.

3. Start the automation agent

To start the automation agent host, run start command with an optional hostname parameter. Note: if you do not specify -Phostname parameter, the default agent host name is set to "Sample Agent".

/usr/local/agentctl-1.3.8 $ ./agentctl start -Phostname="[agent_host_name]"

Example:

/usr/local/agentctl-1.3.8 $ ./agentctl start -Phostname="My Agent Host Name"

4. Access to qTest Automation Agent Host

Open your browser and enter the URL: http://<host>:<port>

  • host: the IP address or host name or domain name that you specified at step #2. If you did not specify the host at step #2, use localhost or the IP address of this machine
  • port: the port that you specified at step #2. If you did not specify the port at step #2, use the default 6789

5. Install the Automation Agent Host as a Service

Access to agentctl directory and execute following commands:

/usr/local/agentctl-1.3.8 $ sudo ./install
/usr/local/agentctl-1.3.8 $ sudo systemctl status qtest-automation-agent

6. Uninstall Service

Open Terminal and execute following commands

/usr/local/agentctl-1.3.8 $ sudo ./uninstall
/usr/local/agentctl-1.3.8 $ sudo systemctl status qtest-automation-agent

 

Subscribe To Our Blog
Powered by Zendesk