qTest Automation Host 1.3.8 Installation Guide on Windows
In this article, we will walk you through how to install qTest Automation Host version 1.3.8 on Windows machine.
Download qTest Automation Host 1.3.8 for Windows
-
Go to this page Download qTest Automation Host and download the qTest Automation Host 1.3.8 for Windows.
-
Extract agentctl-1.3.8-windows-x64-full.zip to C:\agentctl-1.3.8
Install and configure the automation host
Execute following command to install and configure the automation host.
C:\agentctl-1.3.8> agentctl.bat 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, localhost will be used |
-Pport | Specify a port that your Automation 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. If the value is set to 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. This parameter is required when -Pproxy.enable parameter is set to true. |
-Pproxy.port | The port that the proxy server is running on. This parameter is required when -Pproxy.enable parameter is set to true. |
-Pproxy.username | If your proxy server requires basic authentication, enter username to authenticate with the proxy |
-Pproxy.password | If your proxy server requires basic authentication, enter password to authenticate with the proxy |
Configure qTest Automation Host without proxy
Example command below shows how to configure the qTest Automation Host 1.3.8 in a non-proxy environment. The values for each parameter are highlighted in bold
C:\agentctl-1.3.8> agentctl.bat 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 Host with proxy settings
Example command below shows how to configure the qTest Automation Host 1.3.8 in a proxy environment. The values for each parameter are highlighted in bold
Your proxy does not require authentication:
C:\agentctl-1.3.8> agentctl.bat 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
Your proxy does requires basic authentication with user name and password:
C:\agentctl-1.3.8> agentctl.bat 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
If your PC is running Java 8 whose version is ranging from 1.8.0_77 to 1.8.0_151 (you can find your Java version on Windows here), you must add a system environment variable to make proxy with basic authentication work properly by following below steps.
-
Add system environment variable on Windows
-
Select Start, select Control Panel, double click System, and select the Advanced tab.
-
Click Environment Variables.
-
In the System variables section, click New. The New System Variable dialog is displayed
-
In Variable Name field, enter: JAVA_TOOL_OPTIONS
-
In Variable Value field, enter: -Djdk.http.auth.tunneling.disabledSchemes=
-
Click OK to close New System Variable dialog
Below screenshot shows how the new system variable looks like
-
Click OK to close Environment Variables dialog.
Start the automation host
To start the host, execute start command as below. Notes: If you do not specify -Phostname parameter and value, "Sample Agent" will be used as default host name.
C:\agentctl-1.3.8> agentctl.bat start -Phostname="[automation_host_name]"
Example:
C:\agentctl-1.3.8> agentctl.bat start -Phostname="My Automation Host Name"
Access to the Automation 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
-
port: the port that you specified at step #2. If you did not specify the port at step #2, use use the default 6789
Install qTest Automation Host as a Windows service
If you want the Automation Host to automatically starts when Windows starts, you should install it as a Windows service.
Run command prompt as Administrator, access to agentctl directory and execute following command to install qTest Automation Host as a service on Windows
C:\agenctl-1.3.8> install.bat
Uninstall qTest Automation Host service
Run command prompt as Administrator, access to agentctl directory and execute following command to uninstall qTest Automation Host as a service on Windows
C:\agenctl-1.3.8>uninstall.bat