sap hana studio installation and update guide

SAP HANA Database - Studio Installation and Update Guide■ SAP HANA Appliance Software SPS 04

2012-04-24

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

Copyright

herein as well as their respective logos are trademarks or registered trademarks of SAP AG inGermany and other countries.Business Objects and the Business Objects logo, BusinessObjects,Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects productsand services mentioned herein as well as their respective logos are trademarks or registeredtrademarks of Business Objects Software Ltd. Business Objects is an SAP company.Sybase andAdaptive Server, iAnywhere, Sybase 365, SQL Anywhere, and other Sybase products and servicesmentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase,Inc. Sybase is an SAP company. Crossgate, m@gic EDDY, B2B 360°, B2B 360° Services areregistered trademarks of Crossgate AG in Germany and other countries. Crossgate 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.

2012-04-24

Contents

Introduction.............................................................................................................................5Chapter 1

About the SAP HANA Studio...................................................................................................51.1Supported Platforms................................................................................................................51.2SAP HANA Guides..................................................................................................................51.3

Planning..................................................................................................................................7Chapter 2

System Requirements..............................................................................................................72.1Installation Paths......................................................................................................................72.2Prerequisites for Updating the SAP HANA Studio with SUM for SAP HANA...........................82.3

Installation or Update .............................................................................................................9Chapter 3

Installation or Update on Linux.................................................................................................93.1Using the Installation Manager on Linux.................................................................................103.1.1Using the Command Line on Linux.........................................................................................103.1.2Installing or Updating the Repository on Linux........................................................................113.1.3Installation or Update on Microsoft Windows.........................................................................113.2Using the Installation Manager on Windows...........................................................................113.2.1Using the Command Line on Windows...................................................................................123.2.2Installing or Updating the Repository on Windows..................................................................133.2.3Installation and Update Commands........................................................................................133.3Call Options for an Installation................................................................................................143.4

Additional Information...........................................................................................................17Chapter 4

Logging the Installation...........................................................................................................174.1Logging the Installation on Linux.............................................................................................174.1.1Logging the Installation on Windows......................................................................................174.1.2Starting the SAP HANA Studio..............................................................................................174.2Starting the Studio on Windows.............................................................................................184.2.1Starting the Studio on Linux...................................................................................................184.2.2Uninstalling SAP HANA Studio..............................................................................................184.3Uninstalling the Studio on Linux.............................................................................................184.3.1Uninstalling the Studio on Windows.......................................................................................194.3.2

2012-04-243

More Information...................................................................................................................21Appendix A

2012-04-244

Contents

Introduction

1.1 About the SAP HANA Studio

The SAP HANA studio is a collection of applications for the SAP HANA appliance software. It enablestechnical users to manage the SAP HANA database, to create and manage user authorizations, andto create new or modify existing models of data in the SAP HANA database. It is a client tool, whichcan be used to access local or remote SAP HANA databases.

The SAP HANA studio runs on the Eclipse platform 3.6.

For more information about SAP HANA, see the SAP HANA Master Guide.

1.2 Supported Platforms

You can use the SAP HANA studio on the following platforms:• Microsoft Windows x32 and x64 versions of:

• Windows XP• Windows Vista• Windows 7

• SUSE Linux Enterprise Server SLES 11: x86 64-bit version

1.3 SAP HANA Guides

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

2012-04-245

Introduction

https://service.sap.com/~sapidb/011000358700000604552011D

Quick LinkLocationTopic

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

• SAP HANA Master Guide• SAP HANA Installation Guide• SAP HANA Information Composer – Installa-

tion and Configuration 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• SAP HANA Automated Update Guide

SAPHANAKnowledgeCenter on the SAPHelp Portal

SAPHANA administra-tion and security

2012-04-246

Introduction

https://service.sap.com/hana

https://service.sap.com/~sapidb/011000358700000604552011


https://service.sap.com/~sapidb/011000358700000993102011E

https://service.sap.com/~sapidb/011000358700000993102011E

http://help.sap.com/hana_appliance

http://help.sap.com/hana/hana1_tom_en.pdf

http://help.sap.com/hana/hana1_sec_en.pdf


Planning

2.1 System Requirements

Java JRE 1.6 or 1.7 must be installed to run the SAP HANA studio.

The Java runtime must be accessible for the user that runs the studio via the PATH variable.

Make sure that you choose the correct Java variant for your installation of SAP HANA studio:• For a 32-bit installation, choose a 32-bit Java variant.• For a 64-bit installation, choose a 64-bit Java variant.

2.2 Installation Paths

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

Installation PathPackage

VersionPlatform

C:\Program Files\sap\hdbstudio32-bitMicrosoft Windowsx86, 32-bit

C:\Program Files\sap\hdbstudio64-bitMicrosoft Windowsx86, 64-bit

C:\Program Files (x86)\sap\hdbstudio32-bitMicrosoft Windowsx86, 64-bit

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

2012-04-247

Planning

2.3 Prerequisites for Updating the SAP HANA Studio with SUM for SAP HANA

Before you update the SAP HANA studio using the Software Update Manager (SUM) for SAP HANA,perform the prerequisites listed below.Make sure that you meet these requirements to use this method:1. Make sure that the SAP HANA studio to be updated was installed with version SPS03 of the SAP

HANA application software, which must have been installed using the SAP HANA unified installer.2. Make sure that SUM for SAP HANA is running.3. Configure the update site by choosing Help > Install New Software and entering the URL

http://<host>:<port>/studio_repository/.

This refers to the https port of the SUM for SAP HANA process, which is by default 8080.

2012-04-248

Planning

Installation or Update

• Installation

You can install the SAP HANA studio with one of the following methods:• You use the GUI-based Installation Manager, which is based on the program hdbsetup.

This is the recommended installation method.

• You use the hdbinst program at the command line.

• Update

You can update the SAP HANA Studio with one of the following methods:• You download the latest version of SAP HANA studio from SAP Service Marketplace, and use

the GUI-based Installation Manager, which is based on the program hdbsetup.

This is the recommended update method.

• You download the latest version of SAP HANA studio from SAP Service Marketplace, and usethe hdbinst program at the command line.

This is suitable for quick updates of individual SAP HANA studios where there is no infrastructure.

• You use the SAP HANA system as the central source of updates. This means that, wheneverthe SAP HANA system is updated, the Software Update Manager (SUM) for SAP HANA offersupdates to all SAP HANA studio installations in the system landscape.

This is suitable for automated updates of multiple SAP HANA studios. For more information, seePrerequisites for Updating the SAP HANA Studio with SUM for SAP HANA

• You set up the repository manually using the hdbinst program on any server, then manuallyconfigure it to be available to the SAP HANA studio installations.

This is suitable for large landscapes with multiple SAP HANA studios where the update needsto be centrally available. There is no dependency on SUM for SAP HANA.

3.1 Installation or Update on Linux

2012-04-249


3.1.1 Using the Installation Manager on Linux

• GTK2 is installed so that you can run the graphical installation tool (this is contained in SLES11).• You are logged on as the root user.• This user is authorized to open a display.• The Java runtime is accessible either via the PATH or JAVA_HOME variable or by specifying the --vm

option.

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

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 Installation Manager as follows:

./hdbsetup

Note:If you have several installation kits - that is, several installation variants - on your system, navigateto the download directory, and enter the following command instead to start the Installation Manager:

./hdbsetup -a studio

4. Choose the activity to be performed.5. Follow the instructions displayed by the Installation Manager.6. Leave the root shell after the installation or update has completed.

The SAP HANA studio is installed or updated.

Related Topics• Starting the Studio on Linux

3.1.2 Using the Command Line on Linux

• You are logged on as the root user.

• The Java runtime is accessible either via the PATH or JAVA_HOME variable or by specifying the --vmoption.

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 installation program as follows:

2012-04-2410


hdbinst [<option_list>]

4. Follow the instructions displayed by the installation tool.5. Leave the root shell after the installation or update has completed.


Related Topics• Starting the Studio on Linux• Call Options for an Installation

3.1.3 Installing or Updating the Repository on Linux

You are logged on as a root user.1. Open a root shell and go to the directory where you unpacked the software for this installation.2. Call the installation program as follows: .

/hdbinst -a studio --copy_repository=<target_repository_path>

3. Leave the root shell after the copy is completed.

The repository is copied to the specified path.

After you have entered this path as the source for the update in the studio, you can use the UpdateServer function provided by Eclipse to regularly update your installation. For more information, see the"SAP HANA Database <Release> - Administration Guide" at the SAP HANA Knowledge Center onSAP Help Portal.

3.2 Installation or Update on Microsoft Windows

If the SAP HANA Studio is installed into the default directory on a Windows 7 operating system, writeaccess to the files is prevented if you are not running the studio as the Windows administrator. Wetherefore recommend that - if you do not haveWindows administrator rights - you install the SAP HANAStudio in an alternative location, such as below the user's home folder or somewhere else on disk.

3.2.1 Using the Installation Manager on Windows

2012-04-2411


http://help.sap.com/hana/hana1_imdb_studio_admin_en.pdf



• You are logged on as a local administrator.

1. Download and extract the software to an empty directory.2. In the Windows Explorer, go to the directory where you unpacked the software and double-click

hdbsetup to start the Installation Manager.

Note:If you have several installation kits - that is, several installation variants - on your system, open acommand prompt, navigate to the download directory, and enter the following command instead tostart the Installation Manager:

hdbsetup -a studio

3. Choose the activity to be performed and follow the instructions displayed by the Installation Manager.


Related Topics• Starting the Studio on Windows

3.2.2 Using the Command Line on Windows


• You are logged on as a local administrator.

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 installation program as follows:

hdbinst [<option_list>]


Related Topics• Starting the Studio on Windows• Call Options for an Installation

2012-04-2412


3.2.3 Installing or Updating the Repository 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. Call the installation program as follows:

hdbinst -a studio --copy_repository=<target_repository_path>

3. Follow the instructions displayed by the installation tool.4. Leave the command prompt after the copy is completed.

The repository is copied to the specified path.

After you have entered this path as the source for the update in the studio, you can use the UpdateServer function provided by Eclipse to regularly update your installation. For more information, see SAPHANA Database - Administration Guide

3.3 Installation and Update Commands

Installation in the CommandLine

Installation Manager(Graphical User Interface)Operating System

hdbinst [-a studio][<option_list>]

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

For the available options, seeCall Options for an Installation.

You can omit the call option -astudio if you only have oneinstallation kit - that is, one instal-lation variant - on your system.

hdbsetup -a studioMicrosoft Windows

2012-04-2413




Installation in the CommandLine

Installation Manager(Graphical User Interface)Operating System

./hdbinst [-a studio][<option_list>]

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

For the available options, seeCall Options for an Installation.

You can omit the call option -astudio if you only have oneinstallation kit - that is, one instal-lation variant - on your system.

./hdbsetup -a studioLinux

3.4 Call Options for an Installation

DescriptionOption - ShortOption - Long

Installation variant - specifies the directorycontaining the installation kit. For thestudio installation, specify -a studio.

Note:

You can omit this call option if you onlyhave one installation kit - that is, one in-stallation variant - on your system. Thisis generally the case when you are in-stalling from the DVD or from SAP Ser-vice Marketplace.

-a--archive_dir=<dir>

Runs the program in batch mode usingdefault values for any relevant call optionsthat are not specified

-b--batch

Checks whether components of the instal-lation kit are already installed on this host--check_files

2012-04-2414


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 theinstallation program as relative to the in-stallation directory.

If the installation kit is located on a read-only file system (for example, a DVD),specify the absolute path to the configu-ration file.

--configfile=<file_name>

Specifies the target to which the reposito-ry should be copied

--copy_repository=<target_repository_path>

Displays the list of installation options-h--help

Displays available software componentsand their versions-l--list_packages

Displays a list of the installed in-memorysystems, clients, and studio on the host--list_systems

Specifies the installation path--path=<path>

Defines the source from which therepository should be copied

If you do not specify this option, therepository contained in the installation kitis copied.

-r--repository=<source_repository_url>

Displays the version of the installationprogram-v--version

Specifies the path of the Java runtime file--vm=<java_vm>

Where values are required, the short options in the table above use the same syntax as the correspondinglong option, except that "=" is replaced by a space (the full syntax of short options is omitted to makethe table more concise).

2012-04-2415


Example: short option with value

For the short option to specify the source from which the repository should be copied, the full syntaxis:

-r <source_repository_url>

2012-04-2416


Additional Information

4.1 Logging the Installation

4.1.1 Logging the Installation on Linux

The installation process 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 GUI

The log files are stored at the following path: /var/tmp/hdb_studio_<time_stamp>

4.1.2 Logging the Installation on Windows

The installation process 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 GUI

The log files are stored at the following path:

%TEMP%\hdb_studio_<time_stamp>

4.2 Starting the SAP HANA Studio

2012-04-2417


After the software and (optionally) the repository have been installed, you can start the SAP HANAstudio.

4.2.1 Starting the Studio on Windows

The Java runtime must be specified in the PATH variable.• Open the SAP HANA studio from the Start menu:

Start > All Programs > SAP HANA > SAP HANA Studio

The SAP HANA studio starts.

4.2.2 Starting the Studio on Linux

The Java runtime must be specified in the PATH variable.1. Open a shell and go to the installation directory, such as the following:

/usr/sap/hdbstudio

2. Execute the following command:./hdbstudio

The SAP HANA studio starts.

4.3 Uninstalling SAP HANA Studio

Each installation has its own uninstallation tool. Use the hdbuninst program of the software packagefor which you want to uninstall the studio software.

4.3.1 Uninstalling the Studio on Linux

2012-04-2418


4.3.1.1 Uninstalling the Studio on Linux in Interactive Mode

• You are logged on to the host where the studio 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 that was used for this

installation.2. Enter the following command:

./hdbuninst

A list of installation IDs is displayed.

3. Enter the installation ID of the studio software and press Enter.

The studio software is removed from this host.

4.3.1.2 Uninstalling the Studio on Linux in Batch Mode

• You are logged on to the host where the studio software is installed.• You are logged on as the root user.

To call the hdbuninst program in batch mode, specify the installation path of the studio 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 that was used for this

installation.2. Enter the following command:

./hdbuninst -–path <installation_path> -b

4.3.2 Uninstalling the Studio on Windows

2012-04-2419


4.3.2.1 Uninstalling the Studio on Windows from the Control Panel

You are logged on as a local administrator.1. Choose the following from the Start menu:

Start > Control Panel > Uninstall a Program.

2. Navigate to the SAP HANA studio and choose Uninstall .


4.3.2.2 Uninstalling the Studio on Windows from the Command Line

You are logged on as a local administrator.1. Open a command prompt and go to the directory where you unpacked the software that was used

for this installation.2. Enter the following command:

hdbuninst

A list of installation IDs is displayed.

3. Enter the installation ID of the studio software and press Enter.


2012-04-2420


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

2012-04-2421

More Information

http://www.sap.com

http://help.sap.com/businessobjects

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

https://service.sap.com/bosap-instguides

http://service.sap.com/releasenotes

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

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

https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary

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


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

2012-04-2422

More Information

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

https://service.sap.com/notes

https://www.sdn.sap.com/irj/scn/forums

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


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

sap hana studio installation and update guide

Documents