Install eperi sEcure Platform on your target system with the help of the automated
installation package. The installation package includes all software components on which eperi sEcure Platform relies, e.g., Apache Tomcat, Java JCE cryptography patch, Java,
etc.
Before you begin
The automated installation package requires the following:
- For RHEL and Ubuntu only: The
package vim-common to check if eperi master key is needed during service start
- For SLES only: The package vim to
check if eperi master key is needed during service start
- The package acl. This is necessary to allow asking for eperi master key by using
systemd tools.
- For SLES only: The packages libcap2
& libcap-progs which are needed to allow opening ports <1024 with delivered
java
Please check if those packages are already installed on your system. If not please
install them
before installing the eperi sEcure Platform by using the following
command:
For
Ubuntu: sudo apt install vim-common acl
For RHEL:sudo yum install vim-common acl
About this task
Note: The following procedure describes the installation under Ubuntu, RHEL and SLES.
Procedure
-
Connect to the target server using your preferred ssh tool (e.g. putty) and log
in.
-
Navigate to the directory you copied the installation packages to.
-
For Ubuntu:Set the automated eperi sEcure Platform restart option which will be initiated consecutive to the installation if set to true with following commands:
To disable:debconf-set-selections <<< 'eperi-gateway service/restart boolean false'
To enable:debconf-set-selections <<< 'eperi-gateway service/restart boolean true'
Note: The default setting for the restarting option is true.
-
Execute the package manager with root privileges to install the software, for
example:
For Ubuntu:sudo dpkg -i eperi-gateway-<version>.x86_64.deb
For SLES:sudo rpm -i eperi-gateway-<version>-<buildnumber>.sles15.x86_64.rpm
For RHEL:sudo rpm -i eperi-gateway-<version>.<RHEL-version>.x86_64.rpm
Note: Be sure to install the correct package according to your
operating system version.
This package for example:
eperi-gateway-<version>.el8.x86_64.rpm is to be used
for RHEL version 8.
This package instead:
eperi-gateway-<version>-<buildnumber>.sles15.x86_64.rpm
is to be used for SLES version 15.
And this
package :
eperi-gateway-<version>-<buildnumber>.x86_64.deb is to
be used for Ubuntu.
Note: The open files limit for the Tomcat process is already pre-configured to the maximum value (65.535) from
version 21.12.1.0 on to prevent eperi sEcure Platform failure caused by an exceeded amount of open files.
If this needs to be adjusted in the future, please follow the instructions under
Gateway crashes because of too many open files.
This automated installation procedure installs the following components:
- Java
- Apache Tomcat
- the eperi sEcure Platform
Results
The software bundle gets installed and the start-up scripts are
created. The installation package will create two directory structures as
follows:
/opt/eperi/gateway
- OpenJDK Java
- Apache Tomcat
- eperi sEcure Platform
/etc/eperi/gateway
- eperi sEcure Platform configuration
- Apache Tomcat configuration
