Installation
Prerequisites
Creating gateway on the SAP web portal
A gateway must be created in SAP before it is installed. See SAP User Guide.
Installation token
Once the gateway has been created in SAP click the Generate Installation Token button and an email will be sent with an installation token and a download link to get the SAP Gateway Installer.
Downloading the Coherent SAP Gateway installation package
The email from SAP also contains a download link for the The Coherent SAP Gateway installation package can. When downloading the package you will be asked to provide your SAP credentials.
Once downloaded, unzip the file into a temporary directory. The sap-gateway-installer utility can then be run from this directory to install the gateway application.
This command must be run as an administrator.
The sap-gateway-installer utility can also be used to check whether the gateway application is installed, update or uninstall it.
Windows Service Account
The SAP Gateway may user the Local System account to run but it is recommended that a new Windows Account (machine or domain) is created and used.
Initial install
Run the installer
sap-gateway-installer install --token INSTALLATION-TOKEN --account SERVICE-ACCOUNT
The installation utility will do the following:
- Install the SAP gateway binaries to C:\Program Files\Coherent Research\SapGateway
- Create a Windows Service called Coherent-SAP-Gateway
- Install a client certificate to authenticate the gateway to SAP in the Local Machine certificate store (along with the required certificate chain).
- Provide client certificate access to the service account 1.
When installed the service can be started as normal.
Troubleshooting
SAP Gateway will write fatal errors to the Windows Application Event log with source SAP Gateway.
For more detailed troubleshooting SAP Gateway will log to C:\CoherentLogs\SAP
Footnotes
-
If the Local System account is used this will already have access to the client certificate ↩