SAP HANA Appliance Software SPS 03

SAP HANA Database - Client Installation and Update Guide

2011-10-24

© 2011 SAP AG. All rights reserved.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAPBusinessObjects Explorer, StreamWork, and other SAP products and services mentioned herein as

Copyright

well as their respective logos are trademarks or registered trademarks of SAP AG in Germany andother countries.Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports,Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and servicesmentioned herein as well as their respective logos are trademarks or registered trademarks of BusinessObjects Software Ltd. Business Objects is an SAP company.Sybase and Adaptive Server, iAnywhere,Sybase 365, SQL Anywhere, and other Sybase products and services mentioned herein as well astheir respective logos are trademarks or registered trademarks of Sybase, Inc. Sybase is an SAPcompany. All other product and service names mentioned are the trademarks of their respectivecompanies. Data contained in this document serves informational purposes only. National productspecifications may vary.These materials are subject to change without notice. These materials areprovided 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 oromissions with respect to the materials. The only warranties for SAP Group products and servicesare those that are set forth in the express warranty statements accompanying such products andservices, if any. Nothing herein should be construed as constituting an additional warranty.

2011-10-24

Contents

Supported Platforms...............................................................................................................5Chapter 1

SAP HANA Guides..................................................................................................................7Chapter 2

Commands and Call Options for Client Installation with hdbinst...........................................9Chapter 3

Client Installation on Linux....................................................................................................13Chapter 4

Available Clients on Linux.......................................................................................................134.1Default Values for Linux.........................................................................................................134.2Installing the Client on Linux...................................................................................................134.3Logging the Installation on Linux.............................................................................................144.4

Client Installation on Microsoft Windows.............................................................................15Chapter 5

Available Clients on Windows................................................................................................155.1Default Values for Windows...................................................................................................155.2Installing the Client on Windows.............................................................................................165.3Logging the Installation on Windows......................................................................................165.4

Uninstallation of the Client...................................................................................................17Chapter 6

Uninstallation on Linux...........................................................................................................176.1Uninstallation on Linux in Interactive Mode.............................................................................176.1.1Uninstallation on Linux in Batch Mode....................................................................................176.1.2Uninstallation on Windows.....................................................................................................186.2

More Information...................................................................................................................19Appendix A

2011-10-243

2011-10-244

Contents

Supported Platforms

The following platforms are supported:• Microsoft Windows x32 and x64 versions of:

• Windows XP• Windows Vista• Windows 7

• SUSE Linux Enterprise Server:• x86 64-bit: minimum version Linux SLES11 SP1• x86 32-bit: minimum version Linux SLES 11

2011-10-245

Supported Platforms

2011-10-246

Supported Platforms

SAP HANA Guides

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

Quick LinkLocationTopic

https://service.sap.com/hana:

• SAP HANA Master Guide• SAP HANA Installation Guide

SAPHANAKnowledgeCenter on SAP ServiceMarketplace

SAPHANA landscape,deployment, and instal-lation

http://help.sap.com/hana_appliance:• SAP HANA Technical Operations Manual• SAP HANA Security Guide

SAPHANAKnowledgeCenter on SAP HelpPortal

SAPHANA administra-tion and security

2011-10-247

SAP HANA Guides

2011-10-248

SAP HANA Guides

Commands and Call Options for Client Installation withhdbinst

Table 3-1: Commands

SyntaxOperating System

./hdbinst -a client [<option_list>]

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

hdbinst -a client [<option_list>]

<option_list> :: = <option> <option> ...Microsoft Windows

Table 3-2: Call Options

DescriptionOption - ShortOption - Long

Installation variant - specifies the directorycontaining the installation kit. For the clientinstallation, specify -a client. On Win-dows, you can omit this call option if youonly have one installation kit - that is, oneinstallation variant - on your system.

-a <dir>--archive_dir=<dir>

Runs the program in batch mode using de-fault values for any relevant call options thatare not specified

-b--batch

Checks whether components of the installa-tion kit are already installed on this host--check_files

2011-10-249

Commands and Call Options for Client Installation with hdbinst

DescriptionOption - ShortOption - Long

Specifies a configuration file for using apreconfigured setup

The file must be in regular ini file format.

The specified name is interpreted by the in-stallation program as relative to the installa-tion directory. If the installation kit is locatedon a read-only file system (for exampleDVD), specify the absolute path to the con-figuration file.

--configfile=<file_name>

Displays the list of installation options-h--help

Specifies a virtual host name

If this option is not specified on the commandline, the value is taken from the entry Hostname in the file <instdirectory>/install/installation.ini(UNIX) or <instdirectory>\install\installation.ini(Windows), if present.

Default: system host name, as returned bythe operating system command hostname.This is generally the computer name withoutdomain suffix.

-H--hostname=<host_name>

Displays available software components andtheir versions-l--list_packages

Displays a list of the installed SAP HANAsystems, clients and studio on the host--list_systems

Suppresses the installation of debug pack-ages--no_debug_packages

2011-10-2410

Commands and Call Options for Client Installation with hdbinst

DescriptionOption - ShortOption - Long

Specifies the installation path

The default values are given here:

Default Values for Linux

Default Values for Windows

--path=<path>

Displays the version of the installation pro-gram-v--version

2011-10-2411

Commands and Call Options for Client Installation with hdbinst

2011-10-2412

Commands and Call Options for Client Installation with hdbinst

Client Installation on Linux

4.1 Available Clients on Linux

When you install the client software package, the following clients are installed:• SQLDBC• ODBC• JDBC

4.2 Default Values for Linux

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

Installation PathPackage VersionPlatform

/usr/sap/hdbclient32-bitLinux x86, 32-bit

/usr/sap/hdbclient64-bitLinux x86, 64-bit

/usr/sap/hdbclient3232-bitLinux x86, 64-bit

4.3 Installing the Client on Linux

• You must be logged on as the root user.

2011-10-2413

Client Installation on Linux

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:

DescriptionOption

./hdbsetup -a clientGUI

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

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, set the environment

variable LD_LIBRARY_PATH to the installation path.For information on how to set environment variables, see your operating system documentation.

The client software is installed.

Related Topics• Commands and Call Options for Client Installation with hdbinst

4.4 Logging the Installation on Linux

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>

2011-10-2414

Client Installation on Linux

Client Installation on Microsoft Windows

5.1 Available Clients on Windows

When you install the client software package, the following clients are installed:• SQLDBC• ODBO• ODBC• JDBC

5.2 Default Values for Windows

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

Installation PathPackage VersionPlatform

C:\ProgramFiles\sap\hdbclient

32-bitMicrosoft Windows x86, 32-bit

C:\ProgramFiles\sap\hdbclient

64-bitMicrosoft Windows x86, 64-bit

C:\Program Files(x86)\sap\hdbclient

32-bitMicrosoft Windows x86, 64-bit

2011-10-2415

Client Installation on Microsoft Windows

5.3 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:

DescriptionOption

hdbsetup -a clientGUI

hdbinst -a client [<option_list>]Command line

You can omit the call option -a client if you only have one installation kit - that is, one installationvariant - on your system.

4. Follow the instructions displayed by the installation tool.5. Set the PATH environment variable to the installation path.

For information on setting environment variables, see the documentation for your operating system.

The client software is installed.

Related Topics• Commands and Call Options for Client Installation with hdbinst

5.4 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>

2011-10-2416

Client Installation on Microsoft Windows

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.

6.1 Uninstallation on Linux

6.1.1 Uninstallation on Linux 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.

6.1.2 Uninstallation on Linux in Batch Mode

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

If you omit the installation path, the program does not run in batch mode but instead queries theinstallation ID.1. Open a root shell and go to the directory where you unpacked the software for this installation.2. Enter the following command:

2011-10-2417

Uninstallation of the Client

./hdbuninst --path <installation_path> -b

6.2 Uninstallation on Windows

You are logged on as a local administrator.

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.

2011-10-2418

Uninstallation of the Client

More Information

LocationInformation Resource

http://www.sap.comSAPBusinessObjects product infor-mation

Navigate to http://help.sap.com/businessobjects and on the "SAP Busi-nessObjects Overview" side panel click All Products.

You can access the most up-to-date documentation covering all SAPBusinessObjects products and their deployment at the SAP Help Portal.You can download PDF versions or installable HTML libraries.

Certain guides are stored on the SAP Service Marketplace and are notavailable from the SAP Help Portal. These guides are listed on the HelpPortal accompanied by a link to the SAP Service Marketplace. Customerswith a maintenance agreement have an authorized user ID to accessthis site. To obtain an ID, contact your customer support representative.

SAP Help Portal

http://service.sap.com/bosap-support > Documentation• Installation guides: https://service.sap.com/bosap-instguides• Release notes: http://service.sap.com/releasenotes

The SAP Service Marketplace stores certain installation guides, upgradeand migration guides, deployment guides, release notes and SupportedPlatforms documents. Customers with a maintenance agreement havean authorized user ID to access this site. Contact your customer supportrepresentative to obtain an ID. If you are redirected to the SAP ServiceMarketplace from the SAP Help Portal, use the menu in the navigationpane on the left to locate the category containing the documentation youwant to access.

SAP Service Marketplace

https://cw.sdn.sap.com/cw/community/docupedia

Docupedia provides additional documentation resources, a collaborativeauthoring environment, and an interactive feedback channel.

Docupedia

https://boc.sdn.sap.com/

https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibraryDeveloper resources

2011-10-2419

More Information

LocationInformation Resource

https://www.sdn.sap.com/irj/boc/businessobjects-articles

These articles were formerly known as technical papers.SAP BusinessObjects articles onthe SAP Community Network

https://service.sap.com/notes

These notes were formerly known as Knowledge Base articles.Notes

https://www.sdn.sap.com/irj/scn/forumsForums on the SAP CommunityNetwork

http://www.sap.com/services/education

From traditional classroom learning to targeted e-learning seminars, wecan offer a training package to suit your learning needs and preferredlearning style.

Training

http://service.sap.com/bosap-support

The SAP Support Portal contains information about Customer Supportprograms and services. It also has links to a wide range of technical in-formation and downloads. Customers with a maintenance agreementhave an authorized user ID to access this site. To obtain an ID, contactyour customer support representative.

Online customer support

http://www.sap.com/services/bysubject/businessobjectsconsulting

Consultants can accompany you from the initial analysis stage to thedelivery of your deployment project. Expertise is available in topics suchas relational and multidimensional databases, connectivity, databasedesign tools, and customized embedding technology.

Consulting

2011-10-2420

More Information