Skip to main content

Troubleshooting

When the SAP Gateway is installed it should start and connect to SAP automatically. The gateway will then appear as ONLINE in the SAP website. If for some reason this doesn't happen there are a number of things to look at.

Installation issues​

If there were issues during the installation log files will be available in the directory C:\CoherentLogs\SapGatewayInstaller. These files can always be sent to Coherent Research for analysis.

SAP Gateway issues​

When running the SAP Gateway will log data to the directory C:\CoherentLogs\SAP. The files in here can provide useful information or can be sent to Coherent Research for analysis.

Windows Service​

Installing the SAP Gateway will create a Windows Service with the name Coherent-SAP-Gateway. Use the Windows Services panel to check if the service is running.

Make sure that the credentials given to run the Windows service are correct. If the credentials are wrong the SAP Gateway will not be able to start. If this happens there will be an Audit Failure event in the Windows Security Event Log.

If the credentials were incorrect when the installation utility was run they can be re-entered via the Windows Services panel and the service restarted.

Certificates​

When the SAP Gateway is installed a unique X.509 client certificate is created and installed in the Windows local machine certificate store. The SAP Gateway uses this certificate to authenticate itself with the SAP service.

If for some reason the SAP Gateway service is running but does not appear online in the SAP website ensure that the certificate has been correctly installed.

Open the Windows Certificate Manager for the local computer and check that there is a certificate under Personal\Certificates issued by "Coherent Research SAP Issuing CA". The subject name for the certificate should have the form "SAP CLIENT xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

Ensure that the certificate is valid and the private key is available (the certificate manager will say "You have a private key that corresponds to this certificate).

Finally, right click on the certificate and select "All Tasks > Manage private keys ..." and check that the account used to run the SAP Gateway has read permission for the private key.