To install the Global Tax Determination adapter for SAP ECC, or S/4 HANA complete the following steps.
When installing the Global Tax Determination adapter on Windows, use the Windows command line. The following instructions are based on the command line.
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-windows.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.
- Windows: sapjco3.jar; sapjco3.dll
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.
- Windows: notepad adapter.ini
9. Optional: Edit the log4j2.properties file configurations detailed in Encrypting passwords for adapter.ini.
- Windows: notepad log4j2.properties
10. Go to the Sovos-S4Hana-JcoServer folder.
- cd <top level>/Sovos-S4Hana-JcoServer
11. Run the setupJcoServer executable file.
- Windows: setupJcoserver.bat
You may need to add the correct permissions to run the script. To do this, use the chmod command.
12. setupJcoserver.bat won't prompt for the location of the Java JDK 1.8. Instead, it uses the JAVA_HOME environment variable for the computer. Before running setupJcoServer.bat, make sure JAVA_HOME is configured correctly with the following command: echo %JAVA_HOME%
13. After setupJcoServer completes, confirm the creation of runJcoServer.sh (Unix) or runJcoServer.bat (Windows) in the Sovos-S4Hana-JcoServer folder. To confirm that runJcoServer has executed permissions, use the ls -al command.
14. Start the JCo Server by executing the runJcoServer script:
- Windows: runJcoserver.bat
15. The Global Tax Determination adapter installation is complete.