Installing the SFDC-Adapter

Install the eperi sEcure Salesforce on your target system.

About this task

Note: The following procedure describes the installation under Ubuntu.

As of release 19.13.1.0, an installation package is provided as an alternative to the manual installation. The following describes both ways of installation.

Procedure

  1. Option 1: To install the Adapter manually, proceed as follows:
    1. Navigate to the directory you copied the eperi sEcure Salesforce to.
    2. Copy the eperi sEcure Salesforce file into the Tomcat WEB-INF/lib directory:
      sudo cp ca.salesforce-<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 Salesforce file into the .../WEB-INF/lib directory. In case of the Salesforce Adapter, these are currently the following files:
      • rhino-1.7R4.jar
      • super-csv-2.4.0.jar
    4. Change to the directory to which you copied the eperi sEcure Salesforce file.
    5. Check, if the user and the group of the eperi sEcure Salesforce 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 ca.salesforce-<version>.jar
  2. Option 2: To install the Adapter with the installation package, execute the following command:
    sudo dpkg -i eperi-adapter-sfdc-<version>.x86_64.deb
    Note: If you are upgrading from a version without Adapter installation package, you must remove all old JAR files of the Adapter before upgrading with the adapter installation package!
  3. Restart the eperi sEcure Platform:
    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.