Upgrading from a release <=19.7.1.0 to a release >= 19.8.1.0

Please note the following hints when upgrading to the new release.

About this task

With release 19.8.1.0, the OSGi framework used internally by the eperi sEcure Platform has been replaced by the Spring framework.

Unlike a normal upgrade, you must first remove the currently installed application packages. If besides the eperi sEcure Platform also the eperi SMTP Relay is installed, the eperi SMTP Relay must be removed first. Removing the current installation packages preserves the current application configuration and migrates when the new packages are installed.

To migrate to the new version, please install the eperi sEcure Platform (and possibly the eperi SMTP Relay) according to the procedure described below.

Important: The file names used in the procedure below are examples. Please use the files provided in the eperi Customer Portal for the actual installation, according to the operating system and version used.

Important: In a cluster setup with multiple eperi sEcure Platform nodes proceed as follows:

Shut down all eperi sEcure Platform nodes in the cluster.
Back up the eperi sEcure Platform and Token database.
Perform the upgrade of the first eperi sEcure Platform node as described below while keeping the other nodes offline.
Proceed in the same pattern with all other eperi sEcure Platform nodes.

Procedure

Before you start installing the new release, back up the current eperi sEcure Platform installation and the eperi sEcure Platform database (and possibly a separate token database). Please also note the information in the Admin Manual, section Backup and Restore.
Download the installation packages of the new release from the eperi Customer Portal.
Upload the new installation packages to the target system.
If installed, stop the eperi SMTP Relay from the command line:
```
systemctl stop eGfCA-smtp
```
Stop the eperi sEcure Platform from the command line:
```
systemctl stop eGfCA
```
If installed, first remove the eperi SMTP Relay as follows:
```
sudo dpkg -r eGfCA-smtp
```
```
rpm -e eGfCA-smtp
```
Remove the eperi sEcure Platform as follows:
```
sudo dpkg -r eGfCA
```
```
rpm -e eGfCA
```

Install the new eperi sEcure Platform package:

sudo dpkg -i eperi-gateway-19.8.1.0-17515.x86_64.deb

rpm -i eperi-gateway-19.8.1.0-17515.el7.x86_64.rpm

If needed, install the new eperi SMTP Relay package:

sudo dpkg -i eperi-smtp-relay-19.8.1.0-17516.x86_64.deb

rpm -i eperi-smtp-relay-19.8.1.0-17516.el7.x86_64.rpm

If you have previously changed the file wrapper.conf manually, you must manually enter those changes again in the wrapper.conf file. After the upgrade of the eperi SMTP Relay, the wrapper.conf file is in the directory /etc/eperi/gateway/smtp-relay. In the same directory, there is also a backup of the file called wrapper.conf.dpkg-old (in case of Debian Linux) or wrapper.conf.rpmsave (in case of RHEL/CentOS). From there you can copy the settings back to the file wrapper.conf.
If needed, copy the new version of the respective Adapter file, for Salesforce for example, to the directory /opt/eperi/gateway/tomcat/webapps/ROOT/WEB-INF/lib:
```
sudo cp ca.salesforce-19.8.1.0.jar /opt/eperi/gateway/tomcat/webapps/ROOT/WEB-INF/lib
```
Copy additional JAR files needed for the appropriate Adapter into the .../WEB-INF/lib directory. In case of the Salesforce Adapter, these are, for example, the following files:
- rhino-1.7R4.jar
- super-csv-2.4.0.jar
Check, if the user and the group of the Adapter file as well as the additional JAR files is eperi.

If this is not the case, change it as follows:

sudo chown eperi:eperi ca.salesforce-19.8.1.0.jar

Restart the eperi sEcure Platform:
```
sudo systemctl restart eperi-gateway
```

Results

You have successfully upgraded to the new release.

Important: Please note that the service names of the eperi sEcure Platform and the eperi SMTP Relay have changed. The old service names are linked to the new ones.


Service	Service name old	Service name new
eperi sEcure Platform	eGfCA	eperi-gateway
eperi SMTP Relay	eGfCA-smtp	eperi-smtp-relay