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

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-windows.zip.
5. Go to the newly created Sovos-S4Hana-JcoServer folder.
   cd <top level>/Sovos-S4Hana-JcoServer
6. Move the following files for SAP Java Connector 3.0.21 into the Sovos S4Hana-JcoServer/lib folder: sapjco3.jar and sapjco3.dll.
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 following values detailed in the Configure the adapter.ini file section.
   Windows: notepad adapter.ini.
9. Optional: Edit the log4j2.properties file configurations detailed in Encrypt passwords for adapter.ini on Windows.
   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.

    Tip:

    You may need to add the correct permissions to run the script. To do this, use the chmod command.

    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%
12. After setupJcoServer completes, confirm the creation of runJcoServer.bat in the Sovos-S4Hana-JcoServer folder by using the ls -al command.
13. Start the JCo Server by executing the runJcoServer script for Windows: runJcoserver.bat