PUBLIC

SAP HANA Appliance Software SPS 05

Document Version: 1.0 - 2012-11-29

SAP HANA Database - Client Installation and Update

Guide
Table of Contents

1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1 Supported Platforms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2 SAP HANA Guides. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3 SAP Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.1 Planning on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.1.1 Available Clients on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.1.2 Default Installation Paths for UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2 Planning on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2.1 Available Clients on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2.2 Default Installation Paths for Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

3 Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.1 Installation on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.1.1 Installing the Client on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.1.2 Logging the Installation on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.2 Installation on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.2.1 Installing the Client on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.2.2 Logging the Installation on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.3 Commands and Call Options for Client Installation with hdbinst. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4 Additional Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.1 Uninstallation of the Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
4.2 Uninstallation on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.2.1 Uninstallation on UNIX in Interactive Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.2.2 Uninstallation on UNIX in Batch Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
4.3 Uninstallation on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

PUBLIC SAP HANA Database - Client Installation and Update Guide

2 © 2012 SAP AG. All rights reserved. Table of Contents
1 Introduction

1.1 Supported Platforms

The following platform types are supported:

● AIX
● HP-UX
● Linux
● Microsoft Windows
● Solaris

For more information about supported platforms, see the tabs Operating Systems Clients for your release
in the SAP Product Availability Matrix (PAM).

1.2 SAP HANA Guides

For more information about SAP HANA landscape, security, installation, and administration, see the resources
listed below:

Topic Location Quick Link

SAP HANA landscape, SAP HANA Knowledge https://service.sap.com/hana:

deployment, and Center on SAP Service
● SAP HANA Master Guide
installation Marketplace
● SAP HANA Installation Guide with SAP HANA
Unified Installer
● SAP HANA Master Update Guide
● SAP HANA Automated Update Guide

SAP HANA administration SAP HANA Knowledge http://help.sap.com/hana_appliance:

and security Center on the SAP Help
● SAP HANA Technical Operations Manual
Portal
● SAP HANA Security Guide

SAP HANA Database - Client Installation and Update Guide PUBLIC

Introduction © 2012 SAP AG. All rights reserved. 3
1.3 SAP Notes

SAP Note Description

1577128 Supported clients for SAP HANA

PUBLIC SAP HANA Database - Client Installation and Update Guide

4 © 2012 SAP AG. All rights reserved. Introduction
2 Planning

2.1 Planning on UNIX

2.1.1 Available Clients on UNIX

When you install the client software package, the following clients are installed:

● SQLDBC
● ODBC
● JDBC

2.1.2 Default Installation Paths for UNIX

Note: If you do not specify an installation path during installation, the following default values apply:

Platform Package Version Installation Path

Linux x86, 32-bit 32-bit /usr/sap/hdbclient

Linux x86, 64-bit 64-bit /usr/sap/hdbclient

Linux x86, 64-bit 32-bit /usr/sap/hdbclient32

Other platforms - /usr/sap/hdbclient

2.2 Planning on Windows

2.2.1 Available Clients on Windows

When you install the client software package, the following clients are installed:

● SQLDBC
● ODBO
● ODBC
● JDBC

Note: To access the SAP HANA database from Microsoft Excel, you can install the 32-bit SAP HANA client
for Microsoft Excel. This is a self-extracting archive, which you can install independently of the other
Windows clients. It uses an ODBC driver.

For more information on the supported clients for SAP HANA, see SAP Note 1577128.

2.2.2 Default Installation Paths for Windows

Note: If you do not specify an installation path during installation, the following default values apply:

SAP HANA Database - Client Installation and Update Guide PUBLIC

Planning © 2012 SAP AG. All rights reserved. 5
Platform Package Version Installation Path

Microsoft Windows x86, 32-bit 32-bit C:\Program Files\sap

\hdbclient

Microsoft Windows x86, 64-bit 64-bit C:\Program Files\sap

\hdbclient

Microsoft Windows x86, 64-bit 32-bit C:\Program Files (x86)\sap

\hdbclient

PUBLIC SAP HANA Database - Client Installation and Update Guide

6 © 2012 SAP AG. All rights reserved. Planning
3 Installation

3.1 Installation on UNIX

3.1.1 Installing the Client on UNIX

● You must be logged on as the root user.

● You need a local X11 graphical environment and an X server on the machine where you perform the
installation.

To install the SAP HANA database client software:

1. Download and extract the software to an empty directory.

2. Open a root shell and go to the directory where you unpacked the software.
3. Call the program hdbsetup (GUI installation) or hdbinst (command-line installation) by entering one of the
following commands:
Option Description
GUI ./hdbsetup [-a client]

Command line ./hdbinst [-a client] [<option_list>]

You can omit the call option -a client if you only have one installation kit - that is, one installation variant -
on your system.
4. Follow the instructions displayed by the installation tool.
5. For the environment of users that will use the client, including the user <SID>adm, add the installatiion path to
the the library path environment variable. The library path environment variable differs according to the
operating system:
Operating System Library Path Environment Variable
AIX LIBPATH

HP-UX SHLIB_PATH

Linux LD_LIBRARY_PATH

Solaris LD_LIBRARY_PATH

For information on how to set environment variables, see your operating system documentation.

The client software is installed.

Related Links
Commands and Call Options for Client Installation with hdbinst [page 9]

3.1.2 Logging the Installation on UNIX

The installation is logged by the system. There are two log files written during installation:

SAP HANA Database - Client Installation and Update Guide PUBLIC

Installation © 2012 SAP AG. All rights reserved. 7
● *.log: can be read using a text editor
● *.msg: XML format for the display in the installation tool with the graphical user interface

The log files are stored here:

/var/tmp/hdb_client_<time_stamp>

3.2 Installation on Windows

3.2.1 Installing the Client on Windows

You are logged on as a local administrator.

To install the client software on Windows:

1. Download and extract the software to an empty directory.

2. Open a command prompt and go to the directory where you unpacked the software.
3. Call the program hdbsetup (GUI installation) or hdbinst (command-line installation) by entering one of the
following commands:
Option Description
GUI hdbsetup [-a client]

Command line hdbinst [-a client] [<option_list>]

You can omit the call option -a client if you only have one installation kit - that is, one installation variant -
on your system.
4. Follow the instructions displayed by the installation tool.
5. Add the installation path to the PATH environment variable.
For information on setting environment variables, see the documentation for your operating system.
6. To install the 32-bit SAP HANA client for Microsoft Excel, double-click the self-extracting file
HDBCLIENTXLS.exe and follow the instructions in the installation manager.

The client software is installed.

Related Links
Commands and Call Options for Client Installation with hdbinst [page 9]

3.2.2 Logging the Installation on Windows

The installation is logged by the system. There are two log files written during installation:

● *.log: can be read using a text editor

● *.msg: XML format for the display in the installation tool with the graphical user interface

The log files are stored here:

%TEMP%\hdb_client_<time_stamp>

PUBLIC SAP HANA Database - Client Installation and Update Guide

8 © 2012 SAP AG. All rights reserved. Installation
3.3 Commands and Call Options for Client Installation with
hdbinst

Table 1: Commands

Operating System Syntax

UNIX ./hdbinst [-a client] [<option_list>]

<option_list> :: = <option> <option> ...

Microsoft Windows hdbinst [-a client] [<option_list>]

<option_list> :: = <option> <option> ...

Table 2: Call Options

Option - Long Option - Short Description

--archive_dir=<dir> -a <dir> Installation variant - specifies the directory

containing the installation kit. For the client
installation, specify -a client.

Note:

You can omit this call option if you only

have one installation kit - that is, one
installation variant - on your system. This
is generally the case when you are
installing from the DVD or from SAP
Service Marketplace.

--batch -b Runs the program in batch mode using default

values for any relevant call options that are not
specified

--check_files Checks whether components of the installation

kit are already installed on this host

--configfile=<file_name> Specifies a configuration file for using a

preconfigured setup

The file must be in regular ini file format.

The specified name is interpreted by the

installation program as relative to the installation
directory. If the installation kit is located on a
read-only file system (for example DVD), specify
the absolute path to the configuration file.

--help -h Displays the list of installation options

SAP HANA Database - Client Installation and Update Guide PUBLIC

Installation © 2012 SAP AG. All rights reserved. 9
Option - Long Option - Short Description

--hostname=<host_name> -H Specifies a virtual host name

If this option is not specified on the command

line, the value is taken from the entry Hostname
in the file <inst directory>/install/
installation.ini (UNIX) or <inst
directory>\install\installation.ini
(Windows), if present.

Default: system host name, as returned by the

operating system command hostname. This is
generally the computer name without domain
suffix.

--list_packages -l Displays available software components and their

versions

--list_systems Displays a list of the installed SAP HANA

systems, clients and studio on the host

--no_debug_packages Suppresses the installation of debug packages

--path=<path> Specifies the installation path

The default values are given here:

Default Installation Paths for UNIX [page 5]

Default Installation Paths for Windows [page 5]

--version -v Displays the version of the installation program

PUBLIC SAP HANA Database - Client Installation and Update Guide

10 © 2012 SAP AG. All rights reserved. Installation
4 Additional Information

4.1 Uninstallation of the Client

Each installation has its own uninstallation tool.

Use the hdbuninst program of the software package for which you want to uninstall the client software.

4.2 Uninstallation on UNIX

4.2.1 Uninstallation on UNIX in Interactive Mode

You are logged on to the host where the client software is installed.

You are logged on as the root user.

1. Open a root shell and go to the directory where you unpacked the software for this installation.
2. Enter the following command:
./hdbuninst
3. Enter the ID of the client software installation and press Enter .

The client software is removed from this host.

4.2.2 Uninstallation on UNIX in Batch Mode

To call the hdbuninst program in batch mode, specify the installation path of the client software using the –path
option.

If you omit the installation path, the program does not run in batch mode but instead queries the installation ID.

1. Open a root shell and go to the directory where you unpacked the software for this installation.
2. Enter the following command:
./hdbuninst --path <installation_path> -b

4.3 Uninstallation on Windows

You are logged on as a local administrator.

SAP HANA Database - Client Installation and Update Guide PUBLIC

Additional Information © 2012 SAP AG. All rights reserved. 11
1. Open a command prompt and go to the directory where you unpacked the software for this installation.
2. Enter the following command:
hdbuninst
3. Enter the installation ID assigned to the client software installation and press Enter .

The client software is removed from this host.

Note: You can also use the standard Windows functionality Start Control Panel Add or remove

programs to remove the client software.

PUBLIC SAP HANA Database - Client Installation and Update Guide

12 © 2012 SAP AG. All rights reserved. Additional Information
www.sap.com/contactsap

© 2012 SAP AG. All rights reserved.

No part of this publication may be reproduced or transmitted in

any form or for any purpose without the express permission of
SAP AG.
The information contained herein may be changed without prior
notice.
Some software products marketed by SAP AG and its distributors
contain proprietary software components of other software
vendors.
Microsoft, Windows, Excel, Outlook, and PowerPoint are
registered trademarks of Microsoft Corporation.
IBM, DB2, DB2 Universal Database, System ads, System i5,
System p, System p5, System x, System z, System z10, System
z9, z10, z9, iSeries, pSeries, xSeries, zSeries, eServer, z/VM,
z/OS, i5/OS, S/390, OS/390, OS/400, AS/400, S/390 Parallel
Enterprise Server, PowerVM, Power Architecture, POWER6+,
POWER6, POWER5+, POWER5, POWER, OpenPower, PowerPC,
BatchPipes, BladeCenter, System Storage, GPFS, HACMP,
RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex,
MVS/ESA, AIX, Intelligent Miner, WebSphere, Netfinity, Tivoli and
Informix are trademarks or registered trademarks of IBM
Corporation.
Linux is the registered trademark of Linus Torvalds in the U.S. and
other countries.
Adobe, the Adobe logo, Acrobat, PostScript, and Reader are
either trademarks or registered trademarks of Adobe Systems
Incorporated in the United States and/or other countries.
Oracle is a registered trademark of Oracle Corporation.
UNIX, X/Open, OSF/1, and Motif are registered trademarks of the
Open Group.
Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame,
VideoFrame, and MultiWin are trademarks or registered
trademarks of Citrix Systems, Inc.
HTML, XML, XHTML and W3C are trademarks or registered
trademarks of W3C®, World Wide Web Consortium,
Massachusetts Institute of Technology.
Java is a registered trademark of Sun Microsystems, Inc.
JavaScript is a registered trademark of Sun Microsystems, Inc.,
used under license for technology invented and implemented by
Netscape.
SAP, R/3, xApps, xApp, SAP NetWeaver, Duet, PartnerEdge,
ByDesign, SAP Business ByDesign, and other SAP products and
services mentioned herein as well as their respective logos are
trademarks or registered trademarks of SAP AG in Germany and
in several other countries all over the world. All other product and
service names mentioned are the trademarks of their respective
companies. Data contained in this document serves informational
purposes only. National product specifications may vary.
These materials are subject to change without notice. These
materials are provided by SAP AG and its affiliated companies
("SAP Group") for informational purposes only, without
representation or warranty of any kind, and SAP Group shall not
be liable for errors or omissions with respect to the materials. The
only warranties for SAP Group products and services are those
that are set forth in the express warranty statements
accompanying such products and services, if any. Nothing herein
should be construed as constituting an additional warranty.