sap hana client installation update guide en
DESCRIPTION
sap hana sp6 reference client installationTRANSCRIPT
PUBLIC
SAP HANA Platform SPS 06Document Version: 1.0 - 26-06-2013
SAP HANA Database - Client Installation and Update Guide
Table of Contents1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.1 Supported Platforms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.2 SAP HANA Guides. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.3 SAP Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2 Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.1 Planning on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.1.1 Available Clients on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.1.2 Default Installation Paths for UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2 Planning on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52.2.1 Available Clients on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.2.2 Default Installation Paths for Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3 Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73.1 Installation on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.1.1 Installing the Client on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73.1.2 Logging the Installation on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.2 Installation on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83.2.1 Installing the Client on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83.2.2 Logging the Installation on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.3 Commands and Call Options for Client Installation with hdbinst. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4 Additional Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124.1 Uninstallation of the Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124.2 Uninstallation on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
4.2.1 Uninstallation on UNIX in Interactive Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124.2.2 Uninstallation on UNIX in Batch Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
4.3 Uninstallation on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved.
SAP HANA Database - Client Installation and Update GuideTable 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, deployment, and installation
SAP HANA Knowledge Center on the SAP Help Portal
http://help.sap.com/hana_platform:
● SAP HANA Master Guide● SAP HANA Server Installation Guide● SAP HANA Master Update Guide● SAP HANA Update and
Configuration Guide
SAP HANA administration and security
SAP HANA Knowledge Center on the SAP Help Portal
http://help.sap.com/hana_platform:
● SAP HANA Technical Operations Manual
● SAP HANA Administration Guide● SAP HANA Security Guide
SAP HANA documentation for previous Support Package Stacks
SAP HANA Knowledge Center on SAP Service Marketplace
https://service.sap.com/hana:
● SAP HANA SPS 05 Documentation (ZIP)
● SAP HANA SPS 04 Documentation (ZIP)
● SAP HANA SPS 03 Documentation (ZIP)
SAP HANA Database - Client Installation and Update GuideIntroduction
P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved. 3
1.3 SAP Notes
SAP Note Description
SAP Note 1577128 Supported clients for SAP HANA
4P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved.
SAP HANA Database - Client Installation and Update GuideIntroduction
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
When using unixODBC, install release 2.3.0 or higher (check with command isql --version).● 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
SAP HANA Database - Client Installation and Update GuidePlanning
P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved. 5
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:
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
6P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved.
SAP HANA Database - Client Installation and Update GuidePlanning
3 Installation
3.1 Installation on UNIX
3.1.1 Installing the Client on UNIX
Prerequisites
● 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.
Context
To install the SAP HANA database client software:
Procedure
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
SAP HANA Database - Client Installation and Update GuideInstallation
P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved. 7
Operating System Library Path Environment Variable
Solaris LD_LIBRARY_PATH
For information on how to set environment variables, see your operating system documentation.
Results
The client software is installed.
Related LinksCommands and Call Options for Client Installation with hdbinst [page 10]
3.1.2 Logging the Installation on UNIX
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:
/var/tmp/hdb_client_<time_stamp>
3.2 Installation on Windows
3.2.1 Installing the Client on Windows
Prerequisites
You are logged on as a local administrator.
Context
To install the client software on Windows:
8P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved.
SAP HANA Database - Client Installation and Update GuideInstallation
Procedure
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.
Results
The client software is installed.
Related LinksCommands and Call Options for Client Installation with hdbinst [page 10]
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>
SAP HANA Database - Client Installation and Update GuideInstallation
P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved. 9
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.
NoteYou 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
10P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved.
SAP HANA Database - Client Installation and Update GuideInstallation
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 6]
--version -v Displays the version of the installation program
SAP HANA Database - Client Installation and Update GuideInstallation
P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved. 11
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
Prerequisites
You are logged on to the host where the client software is installed.
You are logged on as the root user.
Procedure
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.
Results
The client software is removed from this host.
4.2.2 Uninstallation on UNIX in Batch Mode
Context
To call the hdbuninst program in batch mode, specify the installation path of the client software using the –path option.
12P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved.
SAP HANA Database - Client Installation and Update GuideAdditional Information
If you omit the installation path, the program does not run in batch mode but instead queries the installation ID.
Procedure
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
Prerequisites
You are logged on as a local administrator.
Context
Procedure
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.
Results
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.
SAP HANA Database - Client Installation and Update GuideAdditional Information
P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved. 13
www.sap.com/contactsap
© 2013 SAP AG or an SAP affiliate company. 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. National product specifications may vary.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.SAP 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 other countries.Please see http://www.sap.com/corporate-en/legal/copyright/index.epx for additional trademark information and notices.