qTest Automation Host 1.3.8 Upgrade Guide on Mac

In this article, we will walk you through how to upgrade your Automation Host version 1.3.7, or 1.3.7.1, to 1.3.8 on Mac machine.

Download qTest Automation Host 1.3.8

1. Go to this page Download qTest Automation Host and download the qTest Automation Host 1.3.8 for Mac

2. Open Terminal

3. Change current directory to /usr/local:

   $ cd /usr/local

4. Extract the bundle:

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

Upgrade to qTest Automation Host .3.8

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

2. Open Terminal and navigate to extracted Automation Host 1.3.8 folder

   $ cd /usr/local/agentctl-1.3.8

3. Execute below command to configure the agent 1.3.8

   $ ./agentctl  config -Phost=[ip_address] -Pport=[agent_port] -PqTest.url=[qTest_url] -PqTest.username=[qTest_username] -PqTest.password=[qTest_password]

   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

   Example:

   $ ./agentctl config -PqTest.url=https://demo.qTestnet.com -PqTest.username=demouser1@qasymphony.com -PqTest.password=n0thIng4y0u

   For more detail about how to configure qTest Automation 1.3.8, 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.7

   $ ./agentctl backup -Plocation=[directory_of_qTest_automation_host_1.3.7]

   Example:

   $ ./agentctl backup -Plocation=/usr/local/qTest-automation-1.3.7

   If the command was successful, a backup file will be created at /usr/local/agentctl-1.3.8/backup/agentctl_bk.zip

5. Next execute below command to copy data and configurations of Automation Host 1.3.7 to Automation Host 1.3.8

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

   Example:

   $ ./agentctl restore -Pbackup-file=/usr/local/agentctl-1.3.8/backup/agentctl_bk.zip

Start qTest Automation Host 1.3.8

Start the agent from Terminal:

$ ./agentctl start