Hana Sps5 HDBstudioinst En

PUBLIC

SAP HANA Appliance Software SPS 05Document Version: 1.0 - 2013-03-01

SAP HANA Database - Studio Installation and Update Guide

Table of Contents

1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.1 About the SAP HANA Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3

1.2 Supported Platforms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.3 SAP HANA Guides. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2 Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2.1 System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2.2 Installation Paths. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

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

3 Installation or Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3.1 Installation or Update on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3.1.1 Using the Installation Manager on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

3.1.2 Using the Command Line on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3.1.3 Installing or Updating the Repository on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3.2 Installation or Update on Microsoft Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3.2.1 Using the Installation Manager on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.2.2 Using the Command Line on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

3.2.3 Installing or Updating the Repository on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.3 Installation and Update Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

3.4 Call Options for an Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10

4 Additional Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

4.1 Logging the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

4.1.1 Logging the Installation on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

4.1.2 Logging the Installation on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

4.2 Starting the SAP HANA Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

4.2.1 Starting the SAP HANA Studio on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

4.2.2 Starting the SAP HANA Studio on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

4.3 Uninstalling the SAP HANA Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

4.3.1 Uninstalling the SAP HANA Studio on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

4.3.2 Uninstalling the SAP HANA Studio on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

2

P U B L I C© 2013 SAP AG or an SAP affiliate company. All rights reserved.

SAP HANA Database - Studio Installation and Update GuideTable of Contents

1 Introduction

1.1 About the SAP HANA Studio

The SAP HANA studio is a collection of applications for the SAP HANA appliance software. It enables technical users to manage the SAP HANA database, to create and manage user authorizations, and to create new or modify existing models of data in the SAP HANA database. It is a client tool, which can 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 the resources listed below:

Topic Location Quick Link

SAP HANA landscape, deployment, and installation

SAP HANA Knowledge Center on SAP Service Marketplace

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

● SAP HANA Master Guide● SAP HANA Installation Guide with SAP HANA

Unified Installer● SAP HANA Master Update Guide● SAP HANA Automated Update Guide

SAP HANA Database - Studio Installation and Update GuideIntroduction

P U B L I C© 2013 SAP AG or an SAP affiliate company. All

rights reserved. 3

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

https://service.sap.com/hana

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





Topic Location Quick Link

SAP HANA administration and security

SAP HANA Knowledge Center on the SAP Help Portal

http://help.sap.com/hana_appliance:

● SAP HANA Technical Operations Manual● SAP HANA Security Guide

4


SAP HANA Database - Studio Installation and Update GuideIntroduction

http://help.sap.com/hana_appliance

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

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

2 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.

NoteThere is no 32bit version of the repository client. If you install the 32bit version of the SAP HANA studio and want to make use of the repository integration features, for example, in the Project Explorer view in the SAP HANA Development perspective, you must install the 64bit version of the repository client.

2.2 Installation Paths

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

Platform PackageVersion

Installation Path

Microsoft Windows x86, 32-bit

32-bit C:\Program Files\sap\hdbstudio


64-bit C:\Program Files\sap\hdbstudio


32-bit C:\Program Files (x86)\sap\hdbstudio

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

SAP HANA Database - Studio Installation and Update GuidePlanning


rights reserved. 5

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.

6


SAP HANA Database - Studio Installation and Update GuidePlanning

3 Installation or Update

● InstallationYou 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 use the 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, whenever the SAP HANA system is updated, the Software Update Manager (SUM) for SAP HANA offers updates to all SAP HANA studio installations in the system landscape.This is suitable for automated updates of multiple SAP HANA studios. For more information, see Prerequisites for Updating the SAP HANA Studio with SUM for SAP HANA [page 6]

○ You set up the repository manually using the hdbinst program on any server, then manually configure it to be available to the SAP HANA studio installations.This is suitable for large landscapes with multiple SAP HANA studios where the update needs to be centrally available. There is no dependency on SUM for SAP HANA.

3.1 Installation or Update on Linux3.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 perform the

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

SAP HANA Database - Studio Installation and Update GuideInstallation or Update


rights reserved. 7

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

./hdbsetup -a studio4. 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 LinksStarting the SAP HANA Studio on Linux [page 14]

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 --vm option.

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:hdbinst [<option_list>]

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

The SAP HANA studio is installed or updated.Related LinksStarting the SAP HANA Studio on Linux [page 14]Call Options for an Installation [page 10]

3.1.3 Installing or Updating the Repository on LinuxYou 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 Update Server function provided by Eclipse to regularly update your installation. For more information, see the SAP HANA Administration Guide.

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, write access to the files is prevented if you are not running the studio as the Windows administrator. We therefore recommend

8



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


that - if you do not have Windows administrator rights - you install the SAP HANA Studio 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● The Java runtime is accessible either via the PATH or JAVA_HOME variable or by specifying the --vm option.● 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.

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

hdbsetup -a studio3. Choose the activity to be performed and follow the instructions displayed by the Installation Manager.

The SAP HANA studio is installed or updated.Related LinksStarting the SAP HANA Studio on Windows [page 13]

3.2.2 Using the Command Line on Windows● The Java runtime is accessible either via the PATH or JAVA_HOME variable or by specifying the --vm option.● 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>]

The SAP HANA studio is installed or updated.Related LinksStarting the SAP HANA Studio on Windows [page 13]Call Options for an Installation [page 10]

3.2.3 Installing or Updating the Repository on WindowsYou 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.



rights reserved. 9

After you have entered this path as the source for the update in the studio, you can use the Update Server function provided by Eclipse to regularly update your installation. For more information, see SAP HANA Administration Guide

3.3 Installation and Update Commands

Operating System Installation Manager (Graphical User Interface)

Installation in the Command Line

Microsoft Windows hdbsetup -a studio hdbinst [-a studio] [<option_list>] <option_list> :: = <option> <option> ... For the available options, see Call Options for an Installation [page 10].You can omit the call option -a studio if you only have one installation kit - that is, one installation variant - on your system.

Linux ./hdbsetup -a studio ./hdbinst [-a studio] [<option_list>] <option_list> :: = <option> <option> ... For the available options, see Call Options for an Installation [page 10].You can omit the call option -a studio if you only have one installation kit - that is, one installation variant - on your system.

3.4 Call Options for an Installation

Option - Long Option - Short Description

--archive_dir=<dir> -a Installation variant - specifies the directory containing the installation kit. For the studio installation, specify -a studio.

Note

10





Option - Long Option - Short Description

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 setupThe 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, a DVD), specify the absolute path to the configuration file.

--copy_repository=<target_repository_path>

Specifies the target to which the repository should be copied

--help -h Displays the list of installation options

--list_packages -l Displays available software components and their versions

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

--path=<path> Specifies the installation path

--repository=<source_repository_url>

-r Defines the source from which the repository should be copiedIf you do not specify this option, the repository contained in the installation kit is copied.

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

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

Syntax



rights reserved. 11

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

ExampleExample: Short option with value

For the short option to specify the source from which the repository should be copied, the full syntax is:-r <source_repository_url>

12



4 Additional Information

4.1 Logging the Installation

4.1.1 Logging the Installation on LinuxThe 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 WindowsThe 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

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

4.2.1 Starting the SAP HANA Studio on WindowsBefore starting the SAP HANA studio, check the following:

● Ensure that the Java runtime is set in the system PATH variable.● To make use of the repository integration features in the SAP HANA studio, ensure that the SAP HANA

(repository) client is installed.


To start the SAP HANA studio, perform the following steps:

1. In the Windows Start menu, choose SAP HANA studio.

Start All Programs SAP HANA SAP HANA Studio .

SAP HANA Database - Studio Installation and Update GuideAdditional Information


rights reserved. 13

The SAP HANA studio starts.2. Enable access to the SAP HANA repository.

To make use of the repository integration features in the SAP HANA studio, for example, in the Project Explorer view in the SAP HANA Development perspective, you must set the path to the repository client, as follows:

a) In SAP HANA studio, choose Window Preferences SAP HANA Development Repository Access.

b) Choose Browse... to enter the path to the SAP HANA client executable, regi.exe.For example, C:\Program Files\sap\hdbclient\regi.exe

c) Choose Apply to enable the new setting.d) Choose OK to save the settings.

4.2.2 Starting the SAP HANA Studio on LinuxBefore starting the SAP HANA studio, check the following:

● Ensure that the Java runtime is set in the system PATH variable.● To make use of the repository integration features in the SAP HANA studio, ensure that the SAP HANA

(repository) client is installed.


To start the SAP HANA studio, perform the following steps:

1. Open a shell and go to the installation directory, such as the following:/usr/sap/hdbstudio

2. Execute the following command:./hdbstudioThe SAP HANA studio starts.

3. Enable access to the SAP HANA repository.To make use of the repository integration features in the SAP HANA studio, for example, in the Project Explorer view in the SAP HANA Development perspective, you must set the path to the repository client, as follows:

a) In SAP HANA studio, choose Window Preferences SAP HANA Development Repository Access.

b) Choose Browse... to enter the path to the SAP HANA client executable, regi.For example, /usr/sap/hdbclient

c) Choose Apply to enable the new setting.d) Choose OK to save the settings.

14



4.3 Uninstalling the SAP HANA Studio

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

4.3.1 Uninstalling the SAP HANA Studio on LinuxUninstalling the SAP HANA Studio on Linux in Interactive Mode● You are logged on to the host where the SAP HANA 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 SAP HANA studio software that was used for this installation.

2. Enter the following command:./hdbuninstA list of installation IDs is displayed.

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

The studio software is removed from this host.

Uninstalling the SAP HANA Studio on Linux in Batch Mode● You are logged on to the host where the SAP HANA 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 SAP HANA studio 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 that was used for this installation.

2. Enter the following command:./hdbuninst -–path <installation_path> -b

4.3.2 Uninstalling the SAP HANA Studio on WindowsUninstalling the SAP HANA Studio on Windows from the Control PanelYou 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.


Uninstalling the SAP HANA Studio on Windows from the Command LineYou 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:



rights reserved. 15

hdbuninstA list of installation IDs is displayed.

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


16



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.

http://www.sap.com/contactsap

http://www.sap.com/corporate-en/legal/copyright/index.epx

http://www.sap.com/corporate-en/legal/copyright/index.epx

Hana Sps5 HDBstudioinst En

Documents

Transcript of Hana Sps5 HDBstudioinst En