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 |
Step 2
...
- Download HTTPS Agent software
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 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 | ||
|---|---|---|
| ||
HTTPS_AGENT_TEMP=/u01/software/temp/agent (you may change this to any directory, but do not use don't use HTTPS_AGENT_HOME or anything inside HTTPS_AGENT_HOME) mkdir -p ${HTTPS_AGENT_TEMP} cd ${HTTPS_AGENT_TEMP} unzip <download location path>/HttpsAgentTomcatComplete.zip # DOWNLOAD either using wget or curl or transfer here manually # For FlexDeploy 6.5, please use the 6.5 version of the agent. # A newer version may be available, see https://support.flexagon.com/a/solutions/articles/5000880644 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 | ||
|---|---|---|
| ||
set HTTPS_AGENT_TEMP=c:\u01\software\temp\agent mkdir %AGENT%HTTPS_AGENT_TEMP% (you may change this to any directory, but dodon't not use HTTPS_AGENT_HOME) cd %AGENT_TEMP% unzip <download location path>\%HTTPS_AGENT_TEMP% # Download https://flexagon.com/downloads/httpsagent in HTTPS_AGENT_TEMP folder unzip 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.
| 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 |
Step 4
...
- Apply new version
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 |
Step 5
...
- Apply old configuration
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 can 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 |
Step 7
...
- Perform Test Connection of Endpoint
Visit this page for details on testing connectivity from FlexDeploy to the Agent endpoint.