As we know, Testsigma Agent is mandatory for Hybrid Executions on local machines. Occasionally, when a new version is released, we might need to update the Agent files located in webapps directory inside the Apache Tomcat working directory.


Given below are the steps to be followed in order to update the Agent to latest version.


For Windows

Let us assume that Apache Tomcat working directory is E:\Testsigma\apache-tomcat-xxxx



In order to update the Testsigma Agent to latest version, we need to do the following steps:


1. Stop the apache tomcat server if its already running on the local machine. Else skip to Step 2.

  • Open a Command prompt window if not open already.

  • Navigate to the bin sub-directory inside Apache Tomcat server directory.
    cd E:\Testsigma\apache-tomcat-xxxx\bin


  • Execute the shutdown.bat script by typing the following command and pressing Enter.
    shutdown.bat


Note: Do not close this window yet. You may minimize it till needed again.


2. Go to the 'webapps' directory inside Apache tomcat working directory.


3. Delete the agent.war file and agent folder inside the 'webapps' folder.


4. Download the latest release of agent.war file here


5. Extract the agent.war file from the downloaded zip file.


6. Copy the agent.war file to 'webapps' directory.


7. Switch to the previously opened CMD prompt window.


8. Restart the Apache Tomcat server by typing the following command and pressing Enter key.

startup.bat


For Mac/Linux


Let us assume that Apache Tomcat working directory is ~/documents/testsigma/apache-tomcat-xxxx


In order to update the Testsigma Agent to latest version, we need to do the following steps:


1. Stop the apache tomcat server if its already running on the local machine. Else skip to Step 2.

  • Open a Terminal window if not open already. 
  • Navigate to the bin sub-directory inside Apache Tomcat server directory.
    cd ~/documents/testsigma/apache-tomcat-xxxx/bin


  • Execute the shutdown.sh script by typing the following command and pressing Enter.
    shutdown.sh


Note: Do not close this window yet. You may minimize it till needed again.


2. Go to the 'webapps' directory inside Apache tomcat working directory.


3. Delete the agent.war file and agent folder inside the webapps folder.


4. Download the latest release of agent.war file from here


5. Extract the agent.war file from the downloaded zip file.


6. Copy the agent.war file to webapps directory.


7. Switch to the previously opened Terminal window.


8. Restart the Apache Tomcat server by typing the following command and pressing Enter key.

startup.sh