The AGENT_HOME variable referenced here is the base directory of the agent, which contains the apache-tomcat-flexdeploy-https-agent and config folders as well as the start and stop scripts.
Step 1. Stop the Tomcat server
Linux
cd $AGENT_HOME ./StopFlexDeployHttpsAgent.sh
Windows
cd %AGENT_HOME% StopFlexDeployHttpsAgent.bat
Step 2. Download HTTPS Agent software
Download and unzip the latest version of the agent into a temporary location (for example, /u01/software), so it can be accessed during the upgrade process.
The agent software can be downloaded and transferred manually to the endpoint, or with internet access can be download directly to the endpoint using wget or curl.
Download using wget:
wget -o HttpsAgentTomcatComplete.zip https://flexagon.com/downloads/httpsagent
Or using curl:
curl -L --max-redirs 5 https://flexagon.com/downloads/httpsagent --output HttpsAgentTomcatComplete.zip
Download the agent software from the Flexagon website and transfer it manually to the endpoint if you do not have internet access on the endpoint.
Do not unzip the distribution directly into the AGENT_HOME directory so we can prevent existing configuration file(s) or folder(s) from being overwritten.
Linux
mkdir /u01/software/agent cd /u01/software/agent unzip <download location path>/HttpsAgentTomcatComplete.zip
Windows
mkdir c:\u01\software\downloaded cd c:\u01\software\downloaded unzip <download location path>\HttpsAgentTomcatComplete.zip
Step 3. Backup Current Installation
Backup the current apache-tomcat-flexdeploy-https-agent folder. This will be used to reference the existing configuration.
This step is required. Otherwise the existing configuration will be lost later on.
Linux
cd $AGENT_HOME mv apache-tomcat-flexdeploy-https-agent apache-tomcat-flexdeploy-https-agent-old
Windows
cd %AGENT_HOME% rename apache-tomcat-flexdeploy-https-agent apache-tomcat-flexdeploy-https-agent-old
Step 4. Apply new version
Copy the apache-tomcat-flexdeploy-https-agent folder from the download.
Linux
cd $AGENT_HOME cp -r /u01/software/agent/apache-tomcat-flexdeploy-https-agent .
Windows
cd %AGENT_HOME% mkdir apache-tomcat-flexdeploy-https-agent xcopy c:\u01\software\downloaded\apache-tomcat-flexdeploy-https-agent apache-tomcat-flexdeploy-https-agent /s
Step 5. Apply old configuration
Apply the old configuration from the backup.
Linux
cd $AGENT_HOME cp apache-tomcat-flexdeploy-https-agent-old/conf/server.xml apache-tomcat-flexdeploy-https-agent/conf/server.xml cp apache-tomcat-flexdeploy-https-agent-old/conf/tomcat-users.xml apache-tomcat-flexdeploy-https-agent/conf/tomcat-users.xml
Windows
cd %AGENT_HOME% copy apache-tomcat-flexdeploy-https-agent-old/conf/server.xml apache-tomcat-flexdeploy-https-agent/conf/server.xml copy apache-tomcat-flexdeploy-https-agent-old/conf/tomcat-users.xml apache-tomcat-flexdeploy-https-agent/conf/tomcat-users.xml
Step 6. Start server
Linux
cd $AGENT_HOME ./StartFlexDeployHttpsAgent.sh
Windows
cd %AGENT_HOME% StartFlexDeployHttpsAgent.bat