Skip to Content

Installing SAP HANA HDB Client (Mac)

Install the client package if you intend to develop XS applications on a machine that will not have a local SAP HANA 2.0, express edition installation.
You will learn

How to install the SAP HANA client on a Mac, using either a graphical user interface or a command line.

aplata-sapAdrian PlataOctober 28, 2020
Created by
JCurrie27
April 13, 2018
Contributors
JCurrie27
aplata-sap

The server machine in these instructions refers to the laptop on which SAP HANA 2.0, express edition is installed, while client machine refers to your local machine. You do not need to install the two on the same machine or VM.

The clients let you access SAP HANA 2.0, express edition, from your client machine. This is the Reduced SAP Client package.

The clients included with the SAP HANA HDB client software package are:

  • JDBC

  • ODBC

  • SQLDBC

  • ODBO/MDX

  • Python (PyDBAPI)

  • ADO.NET

  • Step 1

    Install the Download Manager to your client machine and download the client package.

    1. Save the Download Manager installation files to your client machine and open it. For instructions on downloading and running the Download Manager, see either the Installing SAP HANA 2.0, express edition (Binary Installer Method) or Installing SAP HANA 2.0, express edition (Virtual Machine Method) tutorials, or go straight to the SAP HANA, express edition registration page.

    2. In Download Manager, in the Image menu, select either Virtual Machine or Binary Installer.

    3. Click Browse and select a directory where your client package will be saved.

    4. Select the Clients (Mac) package. Clear the Select boxes of all other packages.

    5. Click Download. The clients_mac.tgz file downloads to your save directory.

    6. Use a compression utility to extract the compressed clients file.

      This extracts the following files and their contents:

      • hdb_client_mac.tgz

      • xs.onpremise.runtime.client_darwinintel64.zip

  • Step 2

    To install the SAP HANA client on a Mac machine, do the following:

    1. Go to the directory where you wish to unpack the hdb_client_mac.tgz files:

      bash
      Copy
      cd <your_destination>
      
    2. Unpack the file:

      bash
      Copy
      sudo tar -xvzf <unzipped_filepath>/hdb_client_mac.tgz
      

      The directory HDB_CLIENT_MACOS is created.

    3. Navigate to the HDB_CLIENT_MACOS directory and run hdbinst to start the installer:

      bash
      Copy
      cd HDB_CLIENT_MACOS
      sudo ./hdbinst
      

      Follow the instructions on the screen to install the SAP HANA HDB client.

  • Step 3

    The system automatically logs the SAP HANA HDB client installation. The log files are stored at %TEMP%\hdb_client_<time_stamp> for Windows and /var/temp/hdb_client_<time_stamp> for Linux.

  • Step 4

    Connect to a SAP HANA 2.0, express edition system using either JDBC or Python:

    Use Clients to Query an SAP HANA Database

  • Step 5

    Each installation has its own uninstallation tool. Use the hdbuninst command to uninstall the client software from your command prompt.

    bash
    Copy
    sudo <unzipped_filepath>/HDB_CLIENT_<version>/hdbuninst
    

    Follow the instructions on the screen to uninstall the SAP HANA HDB client.

Back to top