The HTTPS_AGENT_HOME variable referenced here is the base 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 Support Portal and transferred manually to the endpoint, or with internet access can be download downloaded directly to on the endpoint using wget or curl .
Download using wget:
| Code Block |
|---|
wget -o HttpsAgentTomcatComplete.zip https://flexagon.com/downloads/httpsagent |
Or using curl:
| Code Block |
|---|
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(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 | ||
|---|---|---|
| ||
mkdir 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 # 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, /u01/software/agent unzip <download location path>/see https://support.flexagon.com/a/solutions/articles/5000886515 for the latest download link. wget -O HttpsAgentTomcatComplete.zip <link from support site> # or curl -L --max-redirs 5 <link from support site> --output HttpsAgentTomcatComplete.zip unzip HttpsAgentTomcatComplete.zip |
Windows
| Code Block | ||
|---|---|---|
| ||
mkdir set HTTPS_AGENT_TEMP=c:\u01\software\downloaded cd c:\u01\software\downloaded unzip <download location path>\\temp\agent mkdir %HTTPS_AGENT_TEMP% (you may change this to any directory, but don't use HTTPS_AGENT_HOME) cd %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 /u01/software/agent/${HTTPS_AGENT_TEMP}/apache-tomcat-flexdeploy-https-agent . |
Windows
| Code Block |
|---|
cd %AGENT%HTTPS_AGENT_HOME% mkdir apache-tomcat-flexdeploy-https-agent xcopy c:\u01\software\downloaded%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 |
...