Skip to Content
Author's profile photo Stefan Seemann

SAP HANA Client Software , hdbuserstore when using virtual hostnames

This post should give you an overview about the SAP HANA client software and the settings inside the hdbuserstore-container when you are using virtual hostnames for the SAP application server.

Presumed that the installation is done with the software provisioning manager.

To use virtual hostnames you have to add a parameter when you start:

/DVDs/IM_LINUX_X86_64/sapinst SAPINST_USE_HOSTNAME=<virtual hostname>

By using the parameter the <virtual hostname> will be used as server name:


sidadm>grep <virtual hostname> DEFAULT.PFL

SAPGLOBALHOST = <virtual hostname>

rdisp/mshost = <virtual hostname>

enque/serverhost = <virtual hostname>

Relating to SAP HANA two additional actions are done during the installation.

  1. The SAP HANA client software will be installed with the additional parameter –hostname=<virtual hostname>
    You can check the file HdbCmdOut.log for this:
    By using the parameter a special file called installation.ini is created by hdbinst:
  2. The hdbuserstore-container is created in a subdirectory named after the <virtual hostname>. For that the parameter -H <virtual hostname> is used.
    To see the call check file sapinst_dev.log:
    To see the content of the hdbuserstore container logon as sidadm and run the follwoing command:
    As you can see you also have to use the parameter -H <virtual hostname> to list the content of the hdbuserstore-container.

That means when the SAP kernel software loads the SAP HANA client software the content from file installation.ini is used to find the directory in the home directory of user sidadm to read the connection data from the hdbuserstore-container.

As the file installation.ini is unique there is a restriction to the SAP HANA client installation!
It is not possible to install the client software in the central directory of the SAP instance in case you are using the sapinst option SAPINST_USE_HOSTNAME


You might also want to check Oss-note: 2120226 for further information.

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Former Member
      Former Member


      The same configuration apply to all Platform (AS ABAP on Win, AS ABAP on AIX, AS ABAP on HPUX) ?

      Author's profile photo Stefan Seemann
      Stefan Seemann
      Blog Post Author


      the functionality of virtual hostnames in this scenario only applies to UNIX. It is not available on Windows.

      Best regards, Stefan