Deploying eperi sEcure Platform on Tomcat

Deploy the WAR file on the Tomcat server.

1. Stop the Tomcat server.
2. Remove the ROOT web application from the Tomcat Server:
   CAUTION: With this step you remove the currently deployed root app! Before you proceed, make sure this app is no longer needed!

   sudo rm -r /opt/tomcat/webapps/ROOT

3. Copy the file eperi-gateway-<version>.war (renamed to ROOT.war) to the Tomcat webapps directory, for example:

   sudo cp /home/admin/eperi-gateway-19.8.1.0-42.war /opt/tomcat/webapps/ROOT.war

4. Set CATALINA_HOME as global system environment variable pointing to the installation directory of Tomcat.
5. Create a new Tomcat startup script which asks for the RAM password and sets this as the environment variable EPERIMASTERKEY to be read by eperi sEcure Platform. Example:

   #!/bin/sh
   echo "Please enter eperi Master Key: "
   read -s EPERIMASTERKEY
   export EPERIMASTERKEY
   $CATALINA_HOME/bin/catalina.sh start

   Note: This is only necessary, if you intend to use "RAM password" as Master Key method. For details see section Performing the initial configuration
6. Create a new Tomcat stop script which is needed because the Tomcat Server is not running as a systemd service. Example:

   #!/bin/sh
   $CATALINA_HOME/bin/catalina.sh stop

7. Execute your scripts to start or stop the Tomcat server.
   Note: Don't forget to set the executable flag to these scripts beforehand.