The following steps describe how to install the Tax Determination connector for SAP ECC, or S/4 HANA for Unix.

1. Download the Sovos-S4Hana-JcoServer-9.x.x-<OS>.zip package.
   The zip file contains the following folders:

   • Sovos-S4Hana-JcoServer

   • Sovos-S4Hana-JcoServer/lib

   • Sovos-S4Hana-JcoServer/configuration

2. Create a folder for the connector file in your system.
   This will be the top-level folder. Example: /gtd.
3. Move Sovos-S4Hana-JcoServer-9.x.x-<OS>.zip to the top-level folder.
4. Unzip Sovos-S4Hana-JcoServer-9.x.x-<OS>.zip.
   Unix: unzip Sovos-S4Hana-JcoServer-linux.zip
5. Go to the newly created Sovos-S4Hana-JcoServer folder.
   cd <top level>/Sovos-S4Hana-JcoServer.
6. Move the following files for the SAP Java Connector 3.0.21 into the Sovos S4Hana-JcoServer/lib folder:
   Unix: sapjco3.jar; libsapjco3.so
7. Go to the Sovos-S4Hana-JcoServer/configuration folder.
   cd <top level>/Sovos-S4Hana-JcoServer/configuration
8. Edit the adapter.ini file to update the connector configurations according to the Configure the adapter.ini file section.
   Unix: vi adapter.ini.
9. Edit the log4j2.properties file configurations detailed in Encrypt passwords for the adapter.ini file on Linux.
10. Go to the Sovos-S4Hana-JcoServer folder.
    cd <top level>/Sovos-S4Hana-JcoServer
11. Run the setupJcoServer executable file.
    Unix: ./setupJcoserver.sh
    Tip:

    You may need to add the correct permissions to run the script. Use the chmod command.

12. setupJcoServer.sh will prompt for the Java installation folder. Enter the full path name to the location of the Java JDK 1.8 mentioned in the Pre-installation instructions: /<path>/jdk1.8.0_60

    Include the forward slash ("/") before <path>. Do not end the line with a slash or /bin.

13. Start the JCo Server by executing the runJcoServer script:
    Unix: ./runJcoServer.sh

    Tip:

    You can run the server in the background with the nohup./runJcoServer.sh & command.