To install the Global Tax Determination adapter for SAP ECC, or S/4 HANA for Unix, complete the following steps.
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 Adapter 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 of the SAP Java Connector 3.0.21 into the Sovos S4Hana-JcoServer/lib folder:
- Unix: sapjco3.jar; libsapjco3.so
7. Go to Sovos-S4Hana-JcoServer/configuration folder.
- cd <top level>/Sovos-S4Hana-JcoServer/configuration
8. Edit the adapter.ini file to update the Adapter configurations according to the following values detailed in Configuring the adapter.ini File.
- Unix: vi adapter.ini
9. Optional: Edit the log4j2.properties file configurations detailed in Encrypting passwords for adapter.ini.
- Unix: vi log4j2.properties
10. Go to the Sovos-S4Hana-JcoServer folder.
- cd <top level>/Sovos-S4Hana-JcoServer
11. Run the setupJcoServer executable file.
- Unix: ./setupJcoserver.sh
You may need to add the correct permissions to run the script. To do this, 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 Pre-installation instructions: /<path>/jdk1.8.0_60
Include the forward slash (“/”) before <path>. Don’t end the line with a slash or /bin.
13. Start the JCo Server by executing the runJcoServer script:
- Unix: ./runJcoServer.sh
You can run the server in the background with the following command: nohup./runJcoServer.sh &
14. The Global Tax Determination adapter installation is complete.