Cannot connect to SAP HANA database because the database software client failed to load

Last Published: April 25, 2020

Error Message

Attempting to register an SAP HANA database with ArcGIS Server after configuring an ODBC driver returns the error message:

Cannot connect to database because the database client software failed to load. Be sure the database client software is installed and configured correctly.
Image of the error message


This error is caused by an incorrect environment variables path.

Solution or Workaround

To resolve the problem, add the PATH system variable to the machine.

  1. Click Start on the Windows taskbar.
  2. Right-click This PC, and select Properties.
  3. Select Advanced system settings to open the System Properties window.
Image of the Advanced system settings selection
  1. Click on the Advanced tab, and select Environment Variables.
Image of the System Properties Advanced tab selection
  1. Click New to open an Edit System Variable dialog box. Fill in the fields with the following, and click OK.
Variable name: PATH

Variable value: C:\Program Files (x86)\sap\hdbclient
Image of the New System Variable dialog box
Installing the SAP HANA client without administrative rights limits the client's availability to the user who installed it. The default installation folder for this is <%USERPROFILE%>\SAP\hdbclient.
The default location for an installation with administrative rights is C:\Program Files (x86)\sap\hdbclient.

Article ID:000021782

  • Third Party Product
  • ArcGIS Server

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Related Information

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options