Installing the REST Protection Proxy adapter

How to install eperi sEcure AnyApp REST-based on your target system.

About this task

Note: The following procedure describes the installation under Ubuntu.

Procedure

  1. Option 1: To install eperi sEcure AnyApp REST-based manually, proceed as follows:
    1. Navigate to the directory you copied the eperi sEcure AnyApp REST-based JAR file to.
    2. Copy the eperi sEcure AnyApp REST-based JAR file into the Tomcat WEB-INF/lib directory:
      sudo cp eperi-adapter-restprotection-<version>.jar /opt/eperi/gateway/tomcat/webapps/ROOT/WEB-INF/lib
      Important: The destination directory may be different if you have installed eperi sEcure Platform manually with the eperi-gateway.war file, for example /opt/tomcat/webapps/ROOT/WEB-INF/lib.
    3. Copy all additional JAR files provided alongside the eperi sEcure AnyApp REST-based JAR file into the .../WEB-INF/lib directory.
    4. Change to the directory to which you copied the eperi sEcure AnyApp REST-based JAR file.
    5. Check, if the user and the group of the eperi sEcure AnyApp REST-based JAR file as well as the additional JAR files is eperi.
    6. If this is not the case, change it as follows:
      sudo chown eperi:eperi eperi-adapter-restprotection-<version>.jar
  2. Option 2: To install eperi sEcure AnyApp REST-based with the installation package, execute the following command:
    sudo dpkg -i eperi-adapter-restprotection-<version>.x86_64.deb
    Note: If you are upgrading from a version without installation package, you must remove all old JAR files of the existing installation before upgrading with the installation package!
  3. Restart the eperi sEcure Platform services:
    sudo service eperi-gateway restart
    Important: In a cluster setup, the changes must be made on every eperi sEcure Platform instance and each eperi sEcure Platform instance must be restarted.