The FlexDeploy HTTP Agent distribution contains the following components:
A tomcat 9 server with required libraries, and base configurations
The HttpAgent WAR
Step 1. Ensure Java 8 is installed on the server.
You can set JAVA_HOME in the configuration later. This Java will be used to run the tomcat server, different Java versions can be selected on the endpoint configuration in FlexDeploy and those will be used to actually execute the plugin.
Step 2. Prepare software
The HTTP Agent can be downloaded from the Flexagon Support Site. You will download specific version of agent (This will correspond with FlexDeploy version), download file is named Tomcat_Complete-X.X.X.X.zip, where X.X.X.X represents four digit version number.
Extract the zip file in the desired location (referred to as "HTTPS_AGENT_HOME" in this document). See example below, where zip was extracted in /u01/httpsagent folder.
Screenshot
Step 3. Configure authentication
We are going to configure basic auth, with the username and password being stored in tomcat-users.xml.
You must configure the user to have the role 'FlexDeployHTTPSAgent
'
For basic configuration you will only need to configure password in the given tomcat-users.xml file. Here’s what that will look like:
<role rolename="FlexDeployHTTPSAgent" /> <user username="tomcat" password="PASSWORD" roles="FlexDeployHTTPSAgent" />
Step 4. Configure SSL
The use of SSL is required. These steps will be for generating and using a self signed certificate. You can of course use any other certificate compatible with Tomcat. See the Tomcat Documentation for more details.