The HTTPS_AGENT_HOME variable referenced here is the installation 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 Agent
Linux
| Code Block |
|---|
cd $AGENT$HTTPS_AGENT_HOME ./StopFlexDeployHttpsAgent.sh |
Windows
| Code Block |
|---|
cd %AGENT%HTTPS_AGENT_HOME% StopFlexDeployHttpsAgent.bat |
...
Download and unzip the latest version of the agent into a temporary location (for example, /u01/software/temp/agent), so it can be accessed during the upgrade process.
The agent software can be downloaded from the Flexagon website Support Portal and transferred to the endpoint, or can be downloaded directly on the endpoint using wget or curl (provided internet access is available on endpoint).
| Note |
|---|
Do not unzip the distribution directly into the HTTPS_AGENT_HOME directory so we can prevent existing configuration file(s) or folder(s) from being overwritten. |
Linux
| Code Block | ||
|---|---|---|
| ||
HTTPS_AGENT_TEMP=/u01/software/temp/agent (you may change this to any directory, but don't use HTTPS_AGENT_HOME or anything inside HTTPS_AGENT_HOME) mkdir -p ${HTTPS_AGENT_TEMP} cd ${HTTPS_AGENT_TEMP} # DOWNLOAD either using wget or curl or transfer here manually wget -O HttpsAgentTomcatComplete.zip # FlexDeploy 7.0 requires version 7.0 of the https agent. # The 8.0 version is not compatible with FlexDeploy 7.0. # A newer version may be available, see https://support.flexagon.com/a/downloads/httpsagentsolutions/articles/5000886515 for the latest download link. wget -O HttpsAgentTomcatComplete.zip <link from support site> # ORor curl -L --max-redirs 5 https://flexagon.com/downloads/httpsagent <link from support site> --output HttpsAgentTomcatComplete.zip unzip HttpsAgentTomcatComplete.zip |
...
| Code Block | ||
|---|---|---|
| ||
set HTTPS_AGENT_TEMP=c:\u01\software\temp\agent mkdir %AGENT%HTTPS_AGENT_TEMP% (you may change this to any directory, but don't use HTTPS_AGENT_HOME) cd %AGENT%HTTPS_AGENT_TEMP% # Download https://flexagon.com/downloads/httpsagent in HTTPS_AGENT_TEMP folder unzip HttpsAgentTomcatComplete.zip |
...
| Note |
|---|
This step is required. Otherwise the existing configuration will be lost later on. |
Linux
| Code Block |
|---|
cd $AGENT$HTTPS_AGENT_HOME mv apache-tomcat-flexdeploy-https-agent apache-tomcat-flexdeploy-https-agent-old |
Windows
| Code Block |
|---|
cd %AGENT%HTTPS_AGENT_HOME% rename apache-tomcat-flexdeploy-https-agent apache-tomcat-flexdeploy-https-agent-old |
...
Copy the apache-tomcat-flexdeploy-https-agent folder from the download.
Linux
| Code Block |
|---|
cd $AGENT$HTTPS_AGENT_HOME cp -r ${HTTPS_AGENT_TEMP}/apache-tomcat-flexdeploy-https-agent . |
Windows
| Code Block |
|---|
cd %AGENT%HTTPS_AGENT_HOME% mkdir apache-tomcat-flexdeploy-https-agent xcopy %AGENT%HTTPS_AGENT_TEMP%\apache-tomcat-flexdeploy-https-agent apache-tomcat-flexdeploy-https-agent /s |
...
Apply the old configuration from the backup.
Linux
| Code Block |
|---|
cd $AGENT$HTTPS_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
| Code Block |
|---|
cd %AGENT%HTTPS_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 |
| Info |
|---|
You may remove the apache-tomcat-flexdeploy-agent-old directory after testing the connection in step 7. |
Step 5.1 - Adjust server.xml
Beginning with Agent version 6.5.0.8 we will be shipping a server.xml change that only allows TLS 1.2. Since the old server.xml was copied from the previous install we recommend you make this change as well.
You will need to change the sslProtocol to be TLSv1.2 instead of just TLS. Here’s what the change will look like in the connector:
| Code Block |
|---|
<Connector port="8444" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="150" secure="true"
clientAuth="false" sslProtocol="TLSv1.2" SSLEnabled="true"
keystoreFile="../config/tomcat.jks" keystorePass="*PASSWORD_HERE*">
</Connector> |
Step 6. Start Agent
Linux
| Code Block |
|---|
cd $AGENT$HTTPS_AGENT_HOME ./StartFlexDeployHttpsAgent.sh |
Windows
| Code Block |
|---|
cd %AGENT%HTTPS_AGENT_HOME% StartFlexDeployHttpsAgent.bat |
...