qTest Automation Agent Host 2.0 Upgrade Guide on Mac

In this article, we will walk you through how to upgrade your automation agent host version 1.3.8 to 2.0 on Mac machine.

Download qTest Automation Agent Host 2.0

1. Go to this page Download Automation Agent Host and download the qTest Automation Agent Host 2.0 for Mac. It is highly recommended that you download the latest 2.0 version to benefit from bug fixes and enhancement.

2. Open Terminal

3. Move the downloaded file to /usr/local directory:

$ sudo mv agentctl-[version]-osx-x64-full.tgz /usr/local


  • 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
  • Replace [version] in the command to the actual version that you have chosen to download, e.g. 2.0.0, 2.0.1 and so on

4. Change current directory to /usr/local:

$ cd /usr/local

5. Extract the bundle:

/usr/local$ tar -zxf agentctl-[version]-osx-x64-full.tgz

Get your qTest API token

1. Login to qTest Manager as an Administrator and access to Resource page

2. Expand APIs and SDK section

3. Copy the API Token, as show from below screenshot.


Upgrade Automation Agent Host to 2.0

1. If your current Automation Host 1.3.8 is running in Terminal, press Ctrl + C to stop it

2. Open Terminal and navigate to extracted Automation Agent Host 2.0 folder

$ cd /usr/local/agentctl-[version]

3. Execute below command to configure the agent 2.0

/usr/local/agentctl-[version]$ ./agentctl  config -Phost=[ip_address] -Pport=[agent_port] -Pqtest.url=[qtest_url] -Pqtest.token=c2FuZGJveHxodXluZ3V5ZW5AcWFzeW1wFAqrrAWEdOEsdqOTODRSFwNTMxODhlZDY5NTg2ZmMyYzA2NDA5MWNmMQ

Note: -Phost and -Pport parameters are optional

  • If you do not specify -Phost parameter, localhost will be used
  • If do you not specify -Pport parameter, 6789 will be used


/usr/local/agentctl-[version]$ ./agentctl config -Pqtest.url= -Pqtest.token=c2FuZGJveHxodXluZ3V5ZW5AcWFzeW1wFAqrrAWEdOEsdqOTODRSFwNTMxODhlZDY5NTg2ZmMyYzA2NDA5MWNmMQ

For more detail about how to configure qTest Automation Agent 2.0, follow this article: Install and Configure the Automation Agent Host

4. Run the backup command to copy data and configurations of the Automation Agent Host 1.3.8

/usr/local/agentctl-[version]$ ./agentctl backup -Plocation=[directory_of_qtest_automation_host_1.3.8]


/usr/local/agentctl-[version]$ ./agentctl backup -Plocation=/usr/local/agentctl-1.3.8

If the command was successful, a backup file will be created at /usr/local/agentctl-[version]/backup/

5. Next execute below command to copy data and configurations of automation agent 1.3.8 to automation agent 2.0

/usr/local/agentctl-[version]$ ./agentctl restore -Pbackup-file=[/path/to/agentctl-[version]/backup/]


/usr/local/agentctl-[version]$ ./agentctl restore -Pbackup-file=/usr/local/agentctl-[version]/backup/

Start qTest Automation Agent 2.0

Start the agent from Terminal:

/usr/local/agentctl-[version]$ ./agentctl start

Note: if you want the automation agent host to be started automatically when the system starts, you need to install it as a service by following this article: Install Automation Agent Host as a Service

Subscribe To Our Blog
Powered by Zendesk