...
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 |
Step 2. Download HTTPS Agent software
Make sure that you have downloaded Download and unzip the latest version of the agent and unzip it into a temporary location (for example, /u01/software/temp/agent), so it can be accessed during the upgrade process. You can get download links from http://support.flexagon.com .
The agent software can be downloaded from the Flexagon 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 | ||
|---|---|---|
| ||
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, see /u01/software/agent unzip <download location path>/HttpsAgentTomcatComplete-6.5.x.x.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>\HttpsAgentTomcatComplete-6.5.x.x.\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 |
Step 3. Backup Current Installation
Backup the current apache-tomcat-flexdeploy-https-agent folder. We This will use this be used to reference the existing configuration.
| Note |
|---|
This step is required. Otherwise your 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 |
Step 5. Apply old configuration
You will need to apply 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 |
Step 7. Perform Test Connection of Endpoint
Visit this page for details on testing connectivity from FlexDeploy to the Agent endpoint.