In this article, we will walk you through how to upgrade your automation host to the latest 2.0.1 version on Linux.
Below is a list of automation host versions that can be upgraded to the newer version.
- 1.3.8 to 2.0.0
- 1.3.8 to 2.0.1
- 1.3.8 to 2.0.2
- 2.0.0 to 2.0.1
- 2.0.0 to 2.0.2
- 2.0.1 to 2.0.2
- This article assumes you are running automation host version 1.3.8 and you want to upgrade it to the 2.0.x version.
Download qTest Automation Host 2.0.x
1. Go to this page Download Automation Host and download the qTest Automation Host 2.0.x for Linux. It is highly recommended that you download the latest 2.0.x version to benefit from bug fixes and enhancement.
2. Open Terminal
3. Change current directory to /usr/local:
$ cd /usr/local
4. Extract the bundle:
$ tar -zxf agentctl-[version]-linux-x64-full.tgz
- You can extract the package to /usr/local or wherever you'd like
- Replace [version] in the command to the actual version that you have chosen to download, e.g. 2.0.1
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 to qTest Automation Host 2.0
1. If your current Automation Host 1.3.8 is running in Terminal, press Ctrl + C to stop it
2. If you have installed qTest Automation Host 1.3.8 as a service, follow below steps to remove it. Otherwise, move to step #3.
Open Terminal and execute following commands at agentctl-1.3.8 directory to uninstall agentctl-1.3.8 as service:
$ cd /usr/local/agentctl-1.3.8
/usr/local/agentctl-1.3.8$ sudo ./uninstall
/usr/local/agentctl-1.3.8$ sudo systemctl status qtest-automation-agent
3. Configure the Automation Host 2.0.x
Open Terminal and navigate to extracted Automation Host 2.0 folder
$ cd /usr/local/agentctl-[version]
Execute below command to configure Automation Host 2.0.x
/usr/local/agentctl-[version]$ ./agentctl config -Phost=[ip_address] -Pport=[agent_port] -Pqtest.url=[qtest_url] -Pqtest.token=[qtest_token]
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=https://demo.qtestnet.com -Pqtest.token=c2FuZGJveHxodXluZ3V5ZW5AcWFzeW1wFAqrrAWEdOEsdqOTODRSFwNTMxODhlZDY5NTg2ZmMyYzA2NDA5MWNmMQ
For more detail about how to configure qTest Automation 2.0.x, follow this article: Install and Configure the Automation Host
4. Run the backup command to copy data and configurations of the Automation Host 1.3.8
/usr/local/agentctl-[version]$ ./agentctl backup -Plocation=[directory_of__qtest_automation_host_1.3.8]/build/qautomation
/usr/local/agentctl-[version]$ ./agentctl backup -Plocation=/usr/local/agentctl-1.3.8/build/qautomation
If the command was successful, a backup file will be created at /usr/local/agentctl-[version]/backup/agentctl_bk.zip.
5. Next execute below command to copy data and configurations of automation host 1.3.8 to Automation Host 2.0
/usr/local/agentctl-[version]$ ./agentctl restore -Pbackup-file=[/path/to/backup file]
/usr/local/agentctl-[version]$ ./agentctl restore -Pbackup-file=/usr/local/agentctl-[version]/backup/agentctl_bk.zip
Start qTest Automation Host 2.0.x
Start the agent from Terminal:
/usr/local/agentctl-[version]$ ./agentctl start
Note: if you want the automation host to be started automatically when the system starts, you need to install it as a service by following this article: Install Automation Host as a Service