SAP HANA Database - Studio Installation and Update Guide

SAP HANA Appliance Software SPS 04

2012-04-30

Copyright

2012 SAP AG. All rights reserved.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP
BusinessObjects Explorer, StreamWork, SAP HANA 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.Business Objects and the Business Objects logo, BusinessObjects,
Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products
and services mentioned herein as well as their respective logos are trademarks or registered
trademarks of Business Objects 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 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 are
registered trademarks of Crossgate AG in Germany and other countries. Crossgate is an SAP
company. 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.
2012-04-30

Contents

Chapter 1

Introduction.............................................................................................................................5

1.1
1.2
1.3

About the SAP HANA Studio...................................................................................................5

Chapter 2

Planning..................................................................................................................................7

2.1
2.2
2.3

System Requirements..............................................................................................................7

Chapter 3

Installation or Update .............................................................................................................9

3.1
3.1.1
3.1.2
3.1.3
3.2
3.2.1
3.2.2
3.2.3
3.3
3.4

Installation or Update on Linux.................................................................................................9

Chapter 4

Additional Information...........................................................................................................17

4.1
4.1.1
4.1.2
4.2
4.2.1
4.2.2
4.3
4.3.1
4.3.2

Logging the Installation...........................................................................................................17

Supported Platforms................................................................................................................5
SAP HANA Guides..................................................................................................................5

Installation Paths......................................................................................................................7
Prerequisites for Updating the SAP HANA Studio with SUM for SAP HANA...........................8

Using the Installation Manager on Linux.................................................................................10

Using the Command Line on Linux.........................................................................................10
Installing or Updating the Repository on Linux........................................................................11
Installation or Update on Microsoft Windows.........................................................................11
Using the Installation Manager on Windows...........................................................................11
Using the Command Line on Windows...................................................................................12
Installing or Updating the Repository on Windows..................................................................13
Installation and Update Commands........................................................................................13
Call Options for an Installation................................................................................................14

Logging the Installation on Linux.............................................................................................17

Logging the Installation on Windows......................................................................................17
Starting the SAP HANA Studio..............................................................................................17
Starting the Studio on Windows.............................................................................................18
Starting the Studio on Linux...................................................................................................18
Uninstalling SAP HANA Studio..............................................................................................18
Uninstalling the Studio on Linux.............................................................................................18
Uninstalling the Studio on Windows.......................................................................................19

2012-04-30

Contents

Appendix A

More Information...................................................................................................................21

2012-04-30

Introduction

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:

2012-04-30

Introduction

Topic

Location

Quick Link

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

SAP HANA landscape,

deployment, and installation

SAP HANA Knowledge Center on SAP

Service Marketplace

SAP HANA administration and security

SAP HANA Knowledge Center on the

SAP Help Portal

SAP HANA Master Guide

SAP HANA Installation Guide with SAP HANA
Unified Installer
SAP HANA Master Update Guide
SAP HANA Automated Update Guide

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

SAP HANA Technical Operations Manual

SAP HANA Security Guide

2012-04-30

Planning

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:

Platform

Package
Version

Installation Path

Microsoft Windows
x86, 32-bit

32-bit

C:\Program Files\sap\hdbstudio

Microsoft Windows
x86, 64-bit

64-bit

C:\Program Files\sap\hdbstudio

Microsoft Windows
x86, 64-bit

32-bit

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

Linux x86, 64-bit

64-bit

/usr/sap/hdbstudio

2012-04-30

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

Installation or Update

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

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 Linux

2012-04-30

Installation or Update

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

10

2012-04-30

Installation or Update

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

11

2012-04-30

Installation or Update

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.
Note:
If 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 studio
3. Choose the activity to be performed and follow the instructions displayed by the Installation Manager.
The SAP HANA studio is installed or updated.
Related Topics
Starting the Studio on Windows

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 Topics
Starting the Studio on Windows
Call Options for an Installation

12

2012-04-30

Installation or Update

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 Update
Server function provided by Eclipse to regularly update your installation. For more information, see SAP
HANA Database - Administration Guide

3.3 Installation and Update Commands

Operating System

Installation Manager
(Graphical User Interface)

Installation in the Command

Line
hdbinst [-a studio]
[<option_list>]
<option_list> :: =
<option> <option> ...

Microsoft Windows

hdbsetup -a studio

For the available options, see

Call Options for an Installation.
You can omit the call option -a
studio if you only have one
installation kit - that is, one installation variant - on your system.

13

2012-04-30

Installation or Update

Operating System

Installation Manager
(Graphical User Interface)

Installation in the Command

Line
./hdbinst [-a studio]
[<option_list>]
<option_list> :: =
<option> <option> ...

Linux

./hdbsetup -a studio

For the available options, see

Call Options for an Installation.
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

Installation variant - specifies the directory

containing the installation kit. For the
studio installation, specify -a studio.
Note:
--archive_dir=<dir>

-a

--batch

-b

--check_files

14

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.

Runs the program in batch mode using

default values for any relevant call options
that are not specified
Checks whether components of the installation kit are already installed on this host

2012-04-30

Installation or Update

Option - Long

Option - Short

Description

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.

--configfile=<file_name>

If the installation kit is located on a readonly file system (for example, a DVD),
specify the absolute path to the configuration file.
Specifies the target to which the repository should be copied

--copy_repository=<tar
get_repository_path>
--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

Defines the source from which the
repository should be copied

--repository=<source_repos
itory_url>

-r

--version

-v

--vm=<java_vm>

If you do not specify this option, the

repository contained in the installation kit
is copied.
Displays the version of the installation
program
Specifies the path of the Java runtime file

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

15

2012-04-30

Installation or Update

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

16

2012-04-30

Additional Information

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

17

2012-04-30

Additional Information

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

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 package
for which you want to uninstall the studio software.

4.3.1 Uninstalling the Studio on Linux

18

2012-04-30

Additional Information

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 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 Studio on Windows

19

2012-04-30

Additional Information

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 .
The studio software is removed from this host.

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.
The studio software is removed from this host.

20

2012-04-30

More Information

More Information

Information Resource

Location

SAP BusinessObjects product information

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

SAP Help Portal

You can access the most up-to-date documentation covering all SAP
BusinessObjects 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 not
available from the SAP Help Portal. These guides are listed on the Help
Portal accompanied by a link to the SAP Service Marketplace. Customers
with a maintenance agreement have an authorized user ID to access
this site. To obtain an ID, contact your customer support representative.
http://service.sap.com/bosap-support > Documentation

SAP Service Marketplace

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

Release notes: http://service.sap.com/releasenotes

The SAP Service Marketplace stores certain installation guides, upgrade

and migration guides, deployment guides, release notes and Supported
Platforms documents. Customers with a maintenance agreement have
an authorized user ID to access this site. Contact your customer support
representative to obtain an ID. If you are redirected to the SAP Service
Marketplace from the SAP Help Portal, use the menu in the navigation
pane on the left to locate the category containing the documentation you
want to access.
https://cw.sdn.sap.com/cw/community/docupedia

Docupedia

Docupedia provides additional documentation resources, a collaborative

authoring environment, and an interactive feedback channel.
https://boc.sdn.sap.com/

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

21

2012-04-30

More Information

Information Resource

Location

SAP BusinessObjects articles on

the SAP Community Network

https://www.sdn.sap.com/irj/boc/businessobjects-articles
These articles were formerly known as technical papers.
https://service.sap.com/notes

Notes
These notes were formerly known as Knowledge Base articles.
Forums on the SAP Community
Network

https://www.sdn.sap.com/irj/scn/forums
http://www.sap.com/services/education

Training

From traditional classroom learning to targeted e-learning seminars, we

can offer a training package to suit your learning needs and preferred
learning style.
http://service.sap.com/bosap-support

Online customer support

The SAP Support Portal contains information about Customer Support

programs and services. It also has links to a wide range of technical information and downloads. Customers with a maintenance agreement
have an authorized user ID to access this site. To obtain an ID, contact
your customer support representative.
http://www.sap.com/services/bysubject/businessobjectsconsulting

Consulting

22

Consultants can accompany you from the initial analysis stage to the
delivery of your deployment project. Expertise is available in topics such
as relational and multidimensional databases, connectivity, database
design tools, and customized embedding technology.

2012-04-30