sap hana installation guide with sap hana unified installer(sps 05)

54
PUBLIC SAP HANA Appliance Software SPS 05 Document Version: 1.0 - 2012-12-20 SAP HANA Installation Guide with SAP HANA Unified Installer

Upload: abhishek-h-tiwari

Post on 21-Jan-2016

117 views

Category:

Documents


12 download

DESCRIPTION

hana

TRANSCRIPT

Page 1: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

PUBLIC

SAP HANA Appliance Software SPS 05Document Version: 1.0 - 2012-12-20

SAP HANA Installation Guide with SAP HANA Unified Installer

Page 2: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Table of Contents

1 Installing SAP HANA Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.1 Software Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.2 Software Download. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61.3 Important SAP Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61.4 Hardware and Software Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.5 SAP HANA Guides. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.6 Technical System Landscape. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2 Running SAP HANA Unified Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.1 Preparation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.1.1 Required File Systems and Directories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.1.2 Installation Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142.1.3 Users Created During the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .162.1.4 Preparing the Installer Configuration File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.1.5 Performing a Distributed System Installation (Optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

2.2 Running the Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222.2.1 Installed SAP HANA Components and Directories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232.2.2 Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242.2.3 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

3 Using SAP HANA On-Site Configuration Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263.1 Global Call Options for the On-Site Configuration Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263.2 Add Additional SAP HANA Systems on a Single SAP HANA Appliance. . . . . . . . . . . . . . . . . . . . . . . . . 27

3.2.1 Call Options for Adding SAP HANA Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273.3 Remove Additionally Added SAP HANA Systems From a Single SAP HANA Appliance . . . . . . . . . . . . . .28

3.3.1 Call Options for Removing Additionally Added SAP HANA Systems. . . . . . . . . . . . . . . . . . . . 293.4 Installing and Configuring Solution Manager Diagnostics (SMD) Agent on a SAP HANA System. . . . . . . 30

3.4.1 Installing SMD on a SAP HANA System with the GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303.4.2 Installing SMD on a SAP HANA System in Interactive Mode. . . . . . . . . . . . . . . . . . . . . . . . . . 303.4.3 Installing SMD on a SAP HANA System in Batch Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .313.4.4 Call Options for Installing SMD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

3.5 Uninstalling the Solution Manager Diagnostics (SMD) Agent from a SAP HANA System . . . . . . . . . . . . 333.5.1 Uninstalling SMD Agent in GUI mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333.5.2 Uninstalling SMD Agent in Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343.5.3 Uninstalling SMD Agent in Batch Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343.5.4 Call Options for Uninstalling SMD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

3.6 Renaming a SAP HANA System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

2P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerTable of Contents

Page 3: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

3.6.1 Renaming a SAP HANA System with GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .353.6.2 Renaming a SAP HANA System in Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363.6.3 Renaming a SAP HANA System in Batch Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363.6.4 Call Options for Renaming a SAP HANA System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

3.7 Configuring a SAP HANA System to Connect to System Landscape Directory (SLD) . . . . . . . . . . . . . . .383.7.1 Configuring Connection to SLD in GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393.7.2 Configuring Connection to SLD in Interactive Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393.7.3 Configuring Connection to SLD in Batch Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393.7.4 Call Options for Connecting to SLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

3.8 Installing Application Function Libraries (AFLs) on a SAP HANA System. . . . . . . . . . . . . . . . . . . . . . . 403.8.1 Call Options for Installing AFLs on SAP HANA System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

3.9 Changing SAP HANA System Edition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413.9.1 Call Options for Changing SAP HANA System Edition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

3.10 Perform a Distributed SAP HANA Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423.10.1 Call Options for Adding/Removing Hosts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43

4 Post-Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444.1 Starting and Stopping the SAP HANA System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444.2 Performing Initial Backup of SAP HANA System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454.3 Enabling Persistence Encryption. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454.4 Displaying the Process List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .464.5 Logging on to the SAP HANA System Using the SAP HANA Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . 474.6 Ensuring User Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .474.7 Configuring the Software Update Manager for SAP HANA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474.8 Accessing the SAP HANA Studio Repository. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494.9 Enabling Automatic Start of the SAP HANA Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494.10 Applying Updates and Support Packages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .494.11 Monitoring the SAP HANA System Landscape. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

5 Installing Trigger-Based Replication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

6 Installing the SAP HANA Direct Extractor Connection (DXC). . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

7 Installing ETL-Based Replication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

SAP HANA Installation Guide with SAP HANA Unified InstallerTable of Contents

P U B L I C© 2012 SAP AG. All rights reserved. 3

Page 4: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

1 Installing SAP HANA Overview

This SAP HANA installation guide describes how to install SAP HANA with the SAP HANA unified installer. Before starting the installation of SAP HANA, make sure that you have read the SAP HANA Master Guide.

Related LinksSAP HANA Master Guide

1.1 Software Components

SAP HANA appliance software is available in different editions:

● SAP HANA appliance software platform edition● SAP HANA appliance software enterprise edition

The SAP HANA appliance software platform edition is intended for customers who want to use ETL-based replication and already have a license for SAP Data Services. It is comprised of the following components:

4P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerInstalling SAP HANA Overview

Page 5: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

● SAP HANA database● SAP HANA studio● SAP HANA client● SAP Host Agent 7.20● SAP HANA information composer● Diagnostics Agent 7.3● SAP HANA client package for Microsoft Excel● SAP HANA UI for Information Access (INA)

As of SAP HANA SPS 05, this component is part of the SAP HANA database.● Software Update Manager for SAP HANA● SAP HANA AFL 1.0

This library has to be installed using the SAP HANA on-site configuration tool which is located on the installation DVD.

The SAP HANA appliance software enterprise edition is intended for customers who want to use either trigger-based replication or ETL-based replication and do not already have all of the necessary licenses for SAP Data Services. It is comprised of the following components:

● SAP HANA database● SAP HANA studio● SAP HANA client● SAP Host Agent 7.20● SAP HANA information composer● Diagnostics Agent 7.3● SAP HANA client package for Microsoft Excel● SAP HANA UI for Information Access (INA)

As of SAP HANA SPS 05, this component is part of the SAP HANA database.● Software Update Manager for SAP HANA● SAP HANA AFL 1.0

This library has to be installed using the SAP HANA on-site configuration tool which is located on the installation DVD.

● SAP LT Replication AddOn● SAP LT Replication Server● SAP HANA Direct Extractor Connection (DXC)

As of SAP HANA SPS 05, this component is part of the SAP HANA database.● SAP Data Services 4.0

The editions of the SAP HANA appliance software are included in the following editions for special purposes:

● SAP HANA Database edition for BW● SAP HANA Limited edition for Apps / Accelerators● SAP HANA EDGE edition

Note: The Software Update Manager (SUM) for SAP HANA is installed by the SAP HANA unified installer together with other SAP HANA components. For a more complete list of the components actually installed on the SAP HANA appliance, see SAP HANA Installation Guide with SAP HANA Unified Installer, section "Installed SAP HANA Components and Directories".

SAP HANA Installation Guide with SAP HANA Unified InstallerInstalling SAP HANA Overview

P U B L I C© 2012 SAP AG. All rights reserved. 5

Page 6: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Note: SAP HANA information composer is a Web-based environment that allows business users to upload data to the SAP HANA database and to manipulate that data by creating information views. The SAP HANA information composer is installed separately from the SAP HANA system. For more information, see the SAP HANA Information Composer – Installation and Configuration Guide.

1.2 Software Download

The components of SAP HANA can only be installed by certified hardware partners on validated hardware running a specific operating system. Any other system or content developed with such systems is not supported by SAP. For more information, see the information page of the product version. Support Package Stacks (SPS) can be downloaded and applied to appliances according to agreements with the respective hardware partner.

1.3 Important SAP Notes

You must read the following SAP Notes before you start the installation. These SAP Notes contain the latest information about the installation, as well as corrections to the installation documentation.

Make sure that you have the most up-to-date version of each SAP Note, which you can find on SAP Service Marketplace at https://service.sap.com/notes.

SAP Note Number Title

1514967 SAP HANA: Central Note

1771591 SAP HANA Appliance Software SPS 05 Release Note

1523337 SAP HANA Database: Central Note

1681092 Support for multiple SAP HANA databases on a single SAP HANA appliance

1661202 Support for multiple applications on SAP HANA

1577128 Supported clients for SAP HANA

1514966 SAP HANA: Sizing SAP HANA Database

1637145 SAP BW on HANA: Sizing SAP HANA Database

1597355 Swap space recommendation for Linux

For the SAP HANA system there are no special requirements regarding swap space.

Check the current SAP Notes for the various parts of SAP HANA by searching for any of the following application areas:

SAP HANA Platform Edition

6P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerInstalling SAP HANA Overview

Page 7: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

● BC-DB-HDB SAP HANA Database● BC-DB-HDB-AFL SAP HANA Advanced Function Library● BC-DB-HDB-AFL-PAL SAP HANA Predictive Analysis Library● BC-DB-HDB-AFL-SOP SAP HANA Sales and & Operations Planning● BC-DB-HDB-BAC SAP HANA Backup & Recovery● BC-DB-HDB-CCM CCMS for SAP HANA● BC-DB-HDB-CLI SAP HANA Clients (JDBC, ODBC)● BC-DB-HDB-DBA SAP HANA database administration (DBA cockpit)● BC-DB-HDB-DXC SAP HANA direct extractor connector● BC-DB-HDB-ENG SAP HANA database engine● BC-DB-HDB-MDX MDX Engine / MS Excel client● BC-DB-HDB-PER SAP HANA database persistence● BC-DB-HDB-PLE Planning Engine● BC-DB-HDB-POR DB Porting for SAP HANA● BC-DB-HDB-R SAP HANA Integration with R● BC-DB-HDB-SCR SAP HANA SQL Script● BC-DB-HDB-SEC SAP HANA Security & User Management● BC-DB-HDB-SYS SAP HANA database interface/DBMS● BC-DB-HDB-TXT SAP HANA Text & Search Features● BC-DB-HDB-XS SAP HANA Application Services● BC-HAN-MOD SAP HANA studio / information modeler● BC-HAN-3DM SAP HANA information composer● BC-HAN-SRC SAP HANA UI Toolkit● BC-CCM-HAG SAP Host Agent● SV-SMG-DIA SAP Solution Manager Diagnostics Agent

SAP HANA Lifecycle Management

● BC-HAN-SL-STP SAP HANA unified installer● BC-DB-HDB-INS SAP HANA database installation (hdbinst)● BC-HAN-UPD Software Update Manager for SAP HANA● BC-DB-HDB-UPG SAP HANA database upgrade (hdbupd)

SAP HANA Enterprise Edition

● BC-HAN-LOA SAP HANA load controller (log-based replication)● BC-HAN-REP Sybase rep. server (log-based replication)● BC-HAN-LTR SAP Landscape Transformation (trigger-based replication)● BC-HAN-DXC SAP HANA Direct Extractor Connection● EIM-DS Data Services (ETL-based replication)

End User Clients

● BI-BIP, BI-BIP-CMC Business intelligence platform (formerly known as BOE)● BI-RA-EXP SAP BusinessObjects Explorer● BI-RA-CR, BI-BIP-CRS SAP Crystal Reports● BI-RA-XL Dashboard Designer● BI-BIP-IDT Information design tool● BI-RA-WBI Web Intelligence

SAP HANA Installation Guide with SAP HANA Unified InstallerInstalling SAP HANA Overview

P U B L I C© 2012 SAP AG. All rights reserved. 7

Page 8: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

● BI-RA-AO-XLA MS Excel Add-In

The search also supports using the wildcard asterisk (*) in searches, so you can, for example, also search for BC-DB-HDB* or similar and you will get results for all sub-components.

Customer MessagesIf you encounter any problems with the software, create a customer message on the SAP Service Marketplace athttp://service.sap.com/message.

In addition the Customer Interaction Center (CIC) is available 24 x 7 in every region to help you resolve any issues you may run into (https://service.sap.com/supportcenters).

The CIC requires a valid S-user number. Follow the steps in this guide to create an S-user ID (https://service.sap.com/~sapidp/011000358700000905192010E.pdf).

While creating a customer message, you can chose from the above list of components for the relevant software part.

1.4 Hardware and Software Requirements

Note: You can find a complete list of all SAP HANA components and the respective SAP HANA hardware and software requirements in the Product Availability Matrix (PAM) on the SAP Service Marketplace.

Software Requirements

Note: Only the software installed by your hardware partners is recommended for use on the SAP HANA box. Do not install additional software on the SAP HANA box.

Operating System for SAP HANA

SUSE Linux Enterprise Server (SLES) 11 (see Product Availability Matrix (PAM)) – for information about installing SLES 11 in an SAP environment see SAP Note 1310037. For the SAP HANA system there are no specific requirements regarding swap space (see SAP Note 1597355).

The following additional components need to be installed on the SAP HANA box:

● saphostagent● gtk2 (use version as provided with operating system distribution (SLES11 SPS1))● java-1_6_0-ibm (use version as provided with operating system distribution (SLES11 SPS1), necessary

for the SAP HANA studio on the SAP HANA system)● libicu (use version as provided with operating system distribution (SLES11 SPS1))● mozilla-xulrunner192-1.9.2.xx-x.x.x (use version as provided with operating system, but at

given minimum version)● ntp● sudo● syslog-ng (use version as provided with operating system distribution (SLES11 SPS1))● tcsh

8P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerInstalling SAP HANA Overview

Page 9: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

● libssh2● expectObserve the following requirements:

● Turn off the SLES kernel dump function (kdump) if not needed for specific reasons (for example, root cause analysis).

● Configure the following SLES kernel parameter as follows:

net.ipv4.tcp_slow_start_after_idle=0● Adhere to the following shared memory settings (if not already set during installation):

Size shmmni value Physical Memory

S(mall) 4096 < 64 GB

M(edium) 65536 > 64 GB & < 256 GB

L(arge) 524288 > 256 GB

Network Time Protocol (NTP)

We strongly recommend that you set up an NTP server for the SAP HANA system landscape.

Note:

If an NTP sever is not available, for example, trace files from distributed nodes cannot be displayed in the correct chronological order.

Hardware Requirements

Hardware Check

During the update and the installation of the SAP HANA database (part of installation by the unified installer), a hardware check is performed. For more information, see SAP Note 1652078.

Hardware Requirements for SAP HANA Network Connection

We recommend dedicated server network communication of 10 GBit/s between the SAP HANA landscape and the source system for efficient data replication.

Note: For more information about validated hardware configurations see the Product Availability Matrix (PAM) on SAP Service Marketplace at https://service.sap.com/pam.

1.5 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 InstallerInstalling SAP HANA Overview

P U B L I C© 2012 SAP AG. All rights reserved. 9

Page 10: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Topic Location Quick Link

● SAP HANA Installation Guide with SAP HANA Unified Installer

● SAP HANA Master Update Guide● SAP HANA Automated Update Guide

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

1.6 Technical System Landscape

The figure below shows an overview of the technical system landscape for the SAP HANA appliance software and its related components, such as the SAP HANA studio and other applications, one of which is the SAP HANA information composer. Note that the figure below shows a sample configuration with three SAP HANA database servers. The figure also shows some optional components that may be purchased separately.

10P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerInstalling SAP HANA Overview

Page 11: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

SAP HANA Installation Guide with SAP HANA Unified InstallerInstalling SAP HANA Overview

P U B L I C© 2012 SAP AG. All rights reserved. 11

Page 12: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

2 Running SAP HANA Unified Installer

The SAP HANA unified installer is a tool to install the SAP HANA appliance software in a single, unified and predefined way. It is targeted to be used by the SAP HANA hardware partners within their factory process.

Related LinksPerforming a Distributed System Installation (Optional) [page 18]Preparation [page 12]Running the Installer [page 22]Post-Installation [page 44]

2.1 Preparation

You have to perform the preparation steps described in the following sections to be able to run SAP HANA unified installer:

Related LinksRequired File Systems and Directories [page 12]Installation Parameters [page 14]Users Created During the Installation [page 16]Preparing the Installer Configuration File [page 16]

2.1.1 Required File Systems and DirectoriesThe installer requires a running operating system (OS) with file system partitions created as listed in the table below. All directories and files of the SAP system to be installed are created and mounted inside this file system.

If you have created and mounted these partitions in the appropriate partition before you start the installation, the installer recognizes /hanamnt and /usr/sap during the installation and automatically creates the directories and files of the SAP system there.

The directories for data- and log-volumes are not created automatically by the installer. You must create them manually before you start the installation.

If you have not created these partitions before you start the installation, the installer creates them by default in the root directory (/ ) of the main partition along with the directories and files of the SAP system.

Table 1: Required File Systems

File System Description Recommended Disk Space

/ The root partition 10 GB

12P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

Page 13: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

File System Description Recommended Disk Space

/<hanamnt>/shared/ The file system for the SAP mount directory for global files and profiles.

The default name for the SAP mount directory is <hanamnt>/shared, however you can also specify another name. This directory needs to be accessible by each of the servers in the HANA cluster.

The <hanamnt>/shared volume needs not to exceed 5GB, but the <hanamnt>/shared/<SID> folder requires RAM equal to the default system RAM (1*RAM).

The directory <hanamnt>/shared must be physically shared. The path to the SAP mount directory is a mandatory parameter to be filled in the installer configuration file. For more information, see Installation Parameters [page 14] and Preparing the Installer Configuration File [page 16].

5 GB

/usr/sap The file system for local SAP system instance directories 50 GB

/hanamnt/data/<SID> Data partition must be able to write at least 800 MB/s.

The directory for data-volumes of the SAP HANA database.

The path to the data directory depends on the configuration of the SAP HANA host.

Note: This directory must exist before you start the installation.

The data path needs to have three times size of system RAM.

/hanamnt/log/<SID> Data partition must have a bandwidth of at least 100,000 I/O ops.

The directory for log-volumes of the SAP HANA database.

The path to the log directory depends on the configuration of the SAP HANA host.

Note: This directory must exist before you start the installation.

The log path needs to have RAM equal to the default system RAM.

Note: The configuration path for data and log backup must be defined system-wide and not host specific.

It is strongly recommended to execute initial system back up for later recovery of the initial system state. You can do this by mounting an external backup device/share into the file system of the SAP HANA server.

Related LinksInstallation Parameters [page 14]Preparing the Installer Configuration File [page 16]

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

P U B L I C© 2012 SAP AG. All rights reserved. 13

Page 14: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

2.1.2 Installation ParametersThe installer requires the following parameters:

● Parameters to be inserted in the configuration file

● Parameters to be entered on the command line

Table 2: Parameters to be inserted in the configuration file

Parameter ID Description

sid The SAP system ID (SAPSID) is the identifier for the SAP HANA system.

● The ID must be unique throughout your organization and consistent throughout your SAP system installation landscape.

● If you want to install an additional application server instance, make sure that no gateway instance with the same SAPSID exists in your SAP system landscape.

● The ID must consist of exactly three alphanumeric characters. Only uppercase letters are allowed. The first character must be a letter (not a digit).

● The following IDs are reserved and cannot be used: ADD ALL AMD AND ANY ARE ASC AUX AVG BIT CDC COM CON DBA END EPS FOR GET GID IBM INT KEY LOG LPT MAP MAX MIN MON NIX NOT NUL OFF OLD OMS OUT PAD PRN RAW REF ROW SAP SET SGA SHG SID SQL SUM SYS TMP TOP UID USE USR VAR.

instanceNumber The instance number of the SAP HANA system

An instance is an administrative unit that comprises the server software components. It is started and stopped as a unit.

The instance number is a technical identifier for internal processes, and consists of a two-digit number between 00 and 97.

hanamntPath The path to the SAP mount directory

The SAP mount directory can be used as a shared directory between multiple hosts.

The installer sets hanamntPath to /<hanamnt>/shared by default. Ensure that the required file system is available on the installation host. For more information, see Required File Systems and Directories [page 12].

If you want to install your SAP HANA system as a system distributed over several hosts, you have to set the hanamntPath to the path of the mount points on all hosts on which you want to install SAP HANA instances. For more information, see Performing a Distributed System Installation (Optional) [page 18].

The installer will automatically create corresponding symbols from local /usr/sap folder. The folder is also created during installation.

14P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

Page 15: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Parameter ID Description

dataPath The path to the data directory of the SAP HANA system

We recommend that you name this directory /hanamnt/data/<SID>, while <SID> needs to be created manually in advance.

The path to the data directory depends on the configuration of the SAP HANA host. It is a mandatory parameter to be filled in the installer configuration file. For more information, see Installation Parameters [page 14] and Preparing the Installer Configuration File [page 16].

Note: This directory must exist before you start the installation (see also Required File Systems and Directories [page 12]).

logPath The path to the log directory of the SAP HANA system

We recommend that you name this directory /hanamnt/log/<SID>.

The path to the log directory depends on the configuration of the SAP HANA host. It is a mandatory parameter to be filled in the installer configuration file. For more information, see Installation Parameters [page 14] and Preparing the Installer Configuration File [page 16].

Note: This directory must exist before you start the installation (see also Required File Systems and Directories [page 12]).

hdbHost The fully qualified host name of the SAP HANA system

Make sure that a fully qualified host name is assigned to the local machine, that is, the SAP HANA host.

For more information about the restrictions that apply for host names in SAP systems, see SAP Note 611361 - Hostnames of SAP servers.

externalHost Inserts the fully qualified host name that will be used for external access to the SAP HANA system. The fully qualified host name must be assigned to the local machine. For more information about the restrictions that apply for host names in SAP systems, see again SAP Note 611361 above.

timezone Inserts a valid time zone for the <sid>adm user. The default zone is set to UTC. For a list of valid time zones execute hanaconfig.sh -- print_timezones

Table 3: Parameters to be entered on the command line

Parameter Description

master password Common password for all users that are created during the installation (see also Users Created During the Installation [page 16])

The master password must meet the following requirements:

● It must consist of at least eight characters● It must contain at least one lowercase character, one uppercase character, and

one number.

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

P U B L I C© 2012 SAP AG. All rights reserved. 15

Page 16: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Parameter Description

The master password is verified by the installer. It is prompted on the command line while you are running the installer.

Related LinksPerforming a Distributed System Installation (Optional) [page 18]Required File Systems and Directories [page 12]Users Created During the Installation [page 16]

2.1.3 Users Created During the InstallationThe following users are automatically created during the installation. All these users are assigned the master password:

User Description

<sid>adm The system administrator, <sid>adm is the operating system user required for administrative tasks such as starting and stopping the system.

The user ID and password of the <sid>adm user are defined during the system installation. The user ID and group ID of this operating system user must be unique and identical on each host of a distributed system.

sapadm The SAP Host Agent administrator

If there is no SAP Host Agent available on the installation host, it is created during the installation along with user sapadm.

If the host agent is already available on the installation host, the installer neither modifies the host agent, nor its sapadm user, nor the password of the sapadm user.

User Description

SYSTEM The database superuser

Initially, the SYSTEM user has all system permissions. Additional permissions can be granted to this user or revoked. However, only those permissions can be revoked that were granted in addition to to the initial permissions.

2.1.4 Preparing the Installer Configuration FilePrerequisites

Make sure you have done the following before you start preparing the installer configuration file:

● You have set up the required file systems and directories. For more information, see Required File Systems and Directories [page 12]

● You have specified installation parameters. For more information, see Installation Parameters [page 14].

1. Copy the file setuphana.slmodel.template, which is available in the HANA_IM_LINUX__X86_64 folder on the installation medium, to a local directory. Note that the target file must only have the extension .slmodel:

16P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

Page 17: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Example:

cp /HANA_DVD/DATA_UNITS/HANA_IM_LINUX__X86_64/setuphana.slmodel.template /tmp/setuphana.slmodel

The optional parameters are in comments by default. For example,<!-- <distributedSystem> -->. In order to use them you have to remove the comments.Regarding the values, the haGroup value can be any string that will be the name of a group of primary and secondary hosts, covering the high availability scenario. The storagePartition parameter can take any positive integer values, depending on the number of partitions you would like to have.There is also a second file with even simplified format that you can use. The name of the files is setuphana.slmodel.template.v2.In case you want to add additional host you can use the example below:

<?xml version="1.0" encoding="ISO-8859-1"?><systemParameters> <dataPath>/hanamnt/data</dataPath> <logPath>/hanamnt/log</logPath> <sapmntPath>/hanamnt</sapmntPath><instanceNumber>69</instanceNumber><sid>HAN</sid><hdbHost>hostname1</hdbHost> <timezone>UTC</timezone>

<distributedSystem> <additionalHostsRootUser>lroot</additionalHostsRootUser> <hosts> <host hostname="hostname2" hostType="worker" haGroup="11" storagePartition="3"/> </hosts> </distributedSystem>

</systemParameters>

2. Edit the setuphana.slmodel file and insert the required mandatory installation parameters. You can also use the optional parameters by removing the comment tags before and after the parameter in the file. For example, <!-- distributedSystem -->

○ You can find the list of the mandatory parameters below. You can also also refer to Required File Systems and Directories [page 12].

○ dataPath

○ logPath

○ sapmntPath (/hanamnt)

○ instanceNumber

○ sid

○ hdbHost

○ timezone○ The optional parameters are:

○ externalHost

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

P U B L I C© 2012 SAP AG. All rights reserved. 17

Page 18: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

○ distributedSystem

You have prepared the setuphana.slmodel.v2 file. You can also see the descriptions in the file , marked by

comment tags, to get more details.

Related LinksPerforming a Distributed System Installation (Optional) [page 18]Required File Systems and Directories [page 12]Installation Parameters [page 14]

2.1.5 Performing a Distributed System Installation (Optional)You want to install your SAP HANA system as a distributed installation, that is, a system distributed over several hosts. Make sure you read the following information for reference, before you proceed.

System is the name for one or more nodes of a SAP HANA database on one or more hosts that use the same server software installation:

● If there is only one node, it is called a single-host system.

● If there are multiple connected nodes, it is called a distributed system.

Every system has a unique SAP system ID, <<SID>>.

Caution: Choose your SAP system ID carefully because changing it later as described in Renaming a SAP HANA Database System requires extra effort.

Make sure that your SAP system ID:

● Is unique throughout your organization. Do not use an existing <<SID>> when installing a new SAP

system.

● Consists of exactly three alphanumeric characters

● Contains only uppercase letters

● Has a letter for the first character

● Does not include any of the following, which are reserved IDs:

ADD ALL AMD AND ANY ARE ASC AUX AVG BIT CDC COM CON DBA END EPS FOR GET GID IBM INT KEY LOG LPT MAP MAX MIN MON NIX NOT NUL OFF OLD OMS OUT PAD PRN RAW REF ROW SAP SET SGA SHG SID SQL SUM SYS TMP TOP UID USE USR VAR

The server software is based on a flexible architecture that enables a distributed installation. This means that load can be balanced between different hosts. If you want to create a distributed system, make sure that you set it up in a safe environment.

The server software has to be installed in a file system where all hosts that are part of the system can be mounted.

The following graphic shows the file system for a distributed installation:

18P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

Page 19: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

The following table shows a typical configuration for a distributed system:

Host Name Server

Configured Role

Name Server

Actual Role

Index Server

Configured Role

Index Server

Actual Role

Initial host Master 1 Master Worker Master

1st host added Master 2 Slave Worker Slave

2nd host added Master 3 Slave Worker Slave

3rd host added Slave Slave Worker Slave

4th host added Slave Slave Worker Slave

5th host added Slave Slave Worker Slave

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

P U B L I C© 2012 SAP AG. All rights reserved. 19

Page 20: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Host Name Server

Configured Role

Name Server

Actual Role

Index Server

Configured Role

Index Server

Actual Role

6th host added Slave Slave Worker Slave

7th host added Slave Slave Standby Standby

When setting up a distributed system, you need to make sure that the servers are synchronized to the same time. To achieve this, you can set up a Network Time Protocol (NTP) service.

The following figure shows the architecture of a distributed system:

Instance - an instance is an administrative unit that comprises the server software components. It is started and stopped as a unit.

Instance number - an instance is defined by an instance number. This is a two-digit identifier that is unique on a host. Therefore, an instance number can only be assigned once on a host.

Since all instances of a system have the same instance number, only instances of different systems can be configured on the same host.

Host - host is the server or blade on which you create an individual node of a system.

For more information about the restrictions that apply to host names in SAP systems, see SAP Note 611361 Hostnames of SAP servers.

System Administrator -the system administrator, <sid>adm, is the operating system user that is needed for

administrative tasks such as starting and stopping the system.

The user ID and password of the <sid>adm user are defined when installing the software and creating the system.

The user ID and group ID of this operating system user must be unique and identical on each host of a distributed system.

20P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

Page 21: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

System User - the SYSTEM user is the overall system administrator for the SAP HANA database. You specify the

initial password during installation. The SYSTEM user is the initial bootstrap user for the SAP HANA database that

is created during the installation of the SAP HANA database.

Do not use the SYSTEM user for day-to-day activities. Use this user to create dedicated administrator users and to

assign privileges to the administrator users.

The SYSTEM user is also described in the SAP HANA Security Guide.

SAP officially supports multiple databases ("multi-SID") on one SAP HANA appliance in non-production environments for both single-host and distributed systems.

Caution: SAP does not support running multiple SAP HANA databases on a production SAP HANA system.

For more information, see SAP Note 1681092 "Multiple SAP HANA databases on one appliance".

Procedure

1. Create sapadm user and sapsys user group with one and the same ID on all hosts.

2. On the secondary (additional) hosts, install the SAP Host Agent via the rpm package on the DVD. On the primary host it will be installed by SAP HANA unified installer.

3. Prepare the installer configuration file, complied with your landscape requirements. For more information, see Preparing the Installer Configuration File [page 16] .

Note: You (as administrator) need to configure the file systems hanamnt/shared, hanamnt/data and hanamnt/log, so that they are present and mounted on all hosts, including the primary host. This is a prerequisite to run SAP HANA unified installer. If they are not, you will not be able to continue with the installation.

Note: Also keep in mind that the secure connection confirmation (done via RSA key fingerprint) is automatically accepted for all hosts in the distributed landscape.

4. On the primary host, run the SAP HANA unified installer as described in Running the Installer [page 22].5. Finalize installation by running the SAP HANA On-Site Configuration tool for adapting the existing

configuration, if necessary. For more information, see Using SAP HANA On-Site Configuration Tool [page 26].

6. Execute initial system backup for later recovery of the initial system state. For more information, see Performing Initial Backup of SAP HANA System [page 45].

Related LinksInstallation Parameters [page 14]Preparing the Installer Configuration File [page 16]Running the Installer [page 22]

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

P U B L I C© 2012 SAP AG. All rights reserved. 21

Page 22: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

2.2 Running the Installer

Prerequisites:

● Make sure you have installed the following rpm packages:

○ SAP Host Agent

○ GTK2

○ Java-1_6_0-ibm (java_home path variable must be set)

○ Libicu

○ Mozilla-xulrunner1.9.2

○ Network Time Protocol (NTP time server must be configured)

○ Sudo

○ Syslog-ng

○ Tcsh

○ Libssh2

● You have specified the required installation parameters. For more information, see Installation Parameters [page 14].

● You have prepared the installer configuration file. For more information, see Preparing the Installer Configuration File [page 16].

● You have specified a <WORKING_DIRECTORY> for the installer. For more information, see Required File Systems and Directories [page 12]

Example:

/tmp/hanainst

Make sure that the <WORKING_DIRECTORY> meets the following requirements:

○ It has at least 200 MB of free disk space.

○ It is empty before you start or restart the installer.

1. Log on to the installation host as a user with root authorization.

2. Start the installer from the installation medium. To do this, proceed as follows:

1. Change to the directory HANA_IM_LINUX__X86_64 on the installation medium where the setup.sh script is located.

2. Start the installer from the command line by entering the following command:

./setup.sh <WORKING_DIRECTORY> <MODEL_FILE>

where <WORKING_DIRECTORY> is the path to the directory where the installer is to be unpacked and <MODEL_FILE> is the path to the installer configuration file.

22P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

Page 23: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Example:

./setup.sh /tmp/hanainst /tmp/setuphana.slmodel

3. During the installation process, you are prompted to enter and repeat the master password on the command line.

Result:

The installation progress is displayed on the command line.

If the installation is successful, you see this message at the end of the command line output:Finished successfullyThe SAP HANA system is now up and running.

Related LinksRequired File Systems and Directories [page 12]Installation Parameters [page 14]Preparing the Installer Configuration File [page 16]Installed SAP HANA Components and Directories [page 23]Troubleshooting [page 25]

2.2.1 Installed SAP HANA Components and DirectoriesComponent Directory Description

SAP Host Agent /usr/sap/hostctrl For more information about the host agent and its elements, see SAP Note 1031096 - Installing Package SAPHOSTAGENT

SAP HANA database /hanamnt/shared/<SID> Contains the following sub-directories:

● exe

Contains executable kernel programs● global

Contains globally shared data● profile

Contains the profiles of all instances● HDB <instancenr>

Contains HDB executables

SAP HANA database /usr/sap/<SID> Contains the following sub-directories:

● home

The home directory of the <sid>adm user● SYS

Contains system executables● lm_structure

Contains the landscapeDescription.xml file

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

P U B L I C© 2012 SAP AG. All rights reserved. 23

Page 24: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Component Directory Description

SAP HANA client /usr/sap/<SID>/hbdclient Only the client for the SAP HANA system, not clients on related SAP ERP systems

SAP HANA studio repository

/usr/sap/<SID>/hdbstudio_update

Only the SAP HANA studio repository is installed (not the complete SAP HANA studio). You can use this repository to update your local SAP HANA studio installation.

SUM for SAP HANA /usr/sap/<SID>/SUM The Software Update Manager (SUM) for SAP HANA downloads new Support Package Stacks (SPS) for SAP HANA from the SAP Service Marketplace (SMP) and updates the components on your SAP HANA system.

The automated update is performed with the Software Update Manager (SUM) for SAP HANA , which is installed and configured with a default security configuration with the SAP HANA unified installer.

SAP HANA studio /usr/sap/<SID>/hdbstudio SAP HANA studio installation configured to work with Software Update Manager for SAP HANA.

Related LinksConfiguring the Software Update Manager for SAP HANA [page 47]

2.2.2 UninstallIf required, you can also uninstall the SAP HANA components that have been set up by the installer. You can do this using the uninstall.sh script.

Note: The uninstall.sh script does not remove the SAP Host Agent and the SMD agent. In case you

need to uninstall the SMD agent, do this with the SAP HANA On-Site Configuration tool, before running the uninstall.sh.

Prerequisites

Make sure you have done the following before you start the installer:

● You have specified the required installation parameters. For more information, see Installation Parameters [page 14].

● You have specified a <WORKING_DIRECTORY> for the uninstall. For more information, see Required File Systems and Directories [page 12]

Example:

/tmp/hanainst

Make sure that the <WORKING_DIRECTORY> meets the following requirements:

24P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

Page 25: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

○ It has at least 200 MB of free disk space.

○ It is empty before you start or restart the uninstall.

1. Log on to the host where you want to perform the uninstall as a user with root authorization.

2. Start the uninstall.sh script from the installation medium. To do this, proceed as follows:

1. Change to the directory HANA_IM_LINUX__X86_64 on the installation medium where the uninstall.sh script is located.

2. Start the uninstaller from the command line by entering the following command:

./uninstall.sh <WORKING_DIRECTORY> <SID> <HANA_ROOT_USER>

where <WORKING_DIRECTORY> is the path to the directory to which the installer is to be unpacked, <SID> is the system ID of the installed SAP HANA system, and <HANA_ROOT_USER> is an optional parameter that provides the HANA root user for the additional hosts when uninstalling distributed system.

Example:

./uninstall.sh /tmp/hanainst <SID>

Result:

The uninstall progress is displayed on the command line.

If the uninstall is successful, you see this message at the end of the command line output:Finished successfully

Related LinksInstallation Parameters [page 14]Preparing the Installer Configuration File [page 16]Troubleshooting [page 25]

2.2.3 TroubleshootingPrerequisites: The installation or uninstall did not finish with the messageFinished successfully

Check the installation log file as follows:

1. Change to the <WORKING_DIRECTORY>/log directory, where <WORKING_DIRECTORY> is the path to the directory where the installer has been unpacked.Example:

/tmp/hanainst/log/setup.glf

2. Open the installation log file setup.glf.

3. Try to analyze the error.

Caution: If you need to restart the installation from scratch, make sure that the working directory is empty before your restart the installer.

SAP HANA Installation Guide with SAP HANA Unified InstallerRunning SAP HANA Unified Installer

P U B L I C© 2012 SAP AG. All rights reserved. 25

Page 26: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

3 Using SAP HANA On-Site Configuration Tool

You can use the SAP HANA On-Site Configuration tool to perform additional (post-installation) steps. Such post-installation steps are done after you have finished the initial installation with the SAP HANA unified installer.

The On-Site Configuration tool is started via the hanaconfig.sh program. Before you run the tool, you need to meet these prerequisites:

● You identify an existing SAP HANA system, created by an installation or a file system copy, that is to be configured.

● You are logged in as the root user.

There are three levels of command hierarchy in the hanaconfig.sh program:

● Level 1 - global call options. For more information, see Global Call Options for the On-Site Configuration Tool [page 26].

● Level 2 - these are all tasks listed within the On-Site configuration structure. For example, Adding Additional SAP HANA Systems on a single SAP HANA appliance and Renaming a SAP HANA System.

● Level 3 - specific call options for each task. You can find them in the task description.

3.1 Global Call Options for the On-Site Configuration Tool

Global Option Name Value Mandatory Description

--gui - no Launches the configuration tool in GUI mode

--batch - no Runs the configuration tool in batch mode

--interactive - no Runs the configuration tool in interactive mode mode

--version - no Displays configuration tool version

--help - no Displays configuration tool help

--temp_dir path to a temp directory no Temporary work folder for the configuration tool

26P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

Page 27: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Global Option Name Value Mandatory Description

--print_timezones - no Displays the available time zones

3.2 Add Additional SAP HANA Systems on a Single SAP HANA Appliance

For installing multiple SAP HANA systems in GUI mode, you are prompted to enter the required parameters.

If you specify the host name, make sure that it is fully qualified, such as myhost.sap.com (not just myhost).

1. Connect to the system with an X server client to enable GUI system access.2. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like

the following:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_643. Call the script in GUI mode to perform the rename:

./hanaconfig.sh --gui 4. Choose Additional HANA Systems , and then Next to continue.

5. Choose Add HANA System,and then Next to continue.

6. Specify the required entries by following the instructions of the wizard.

Note: You have the option to specify a dedicated time zone. By default, the time zone is set to UTC (Coordinated Universal Time).

For installing multiple SAP HANA systems in interactive mode, use the command ./hanaconfig.sh addhanasystem. You can use as a general guidance the procedure Configuring Connection to SLD in Interactive Mode [page 39].

For installing multiple SAP HANA systems in batch mode, use the command ./hanaconfig.sh --batch addhanasystem. You can use as a general guidance the procedure Configuring Connection to SLD in Batch Mode [page 39].

Related LinksCall Options for Adding SAP HANA Systems [page 27]

3.2.1 Call Options for Adding SAP HANA Systems

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

P U B L I C© 2012 SAP AG. All rights reserved. 27

Page 28: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Option Name Value Mandatory Default Value Description

--add_system_hanamnt

directory yes - This is the installation path to the hanamnt volume

--add_system_sid SID yes - System ID

--add_system_number

instance number yes - Instance number

--add_system_hostname

hostname yes - Fully qualified host name

--add_system_datapath

directory yes - Path to the data directory

--add_system_logpath

directory yes - Path to the log directory

--add_system_master_password

password yes - Master password

--add_system_memory

<<SID1>=<memory in MB>,<SID2>=<memory in MB>,...>

yes - Specifies how to distribute the available memory between the installed HANA instances.

--add_system_timezone

timezone (see --print_timezones)

no UTC New system administrator time zone

--add_system_contentpath

directory no - Custom content directory

--add_system_external_hostname

external hostname no - Fully qualified host name for external usage

3.3 Remove Additionally Added SAP HANA Systems From a Single SAP HANA Appliance

To remove additionally added SAP HANA systems in GUI mode, you are prompted to enter the required parameters.

28P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

Page 29: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Note:

Keep in mind that the originally installed SAP HANA system cannot be uninstalled from the SAP HANA On-Site Configuration tool. This can be performed only to the additionally installed systems (instances) with the SAP HANA On-Site Configuration tool.

1. Connect to the system with an X server client to enable GUI system access.2. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like

the following:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_643. Call the script in GUI mode to perform the rename:

./hanaconfig.sh --gui 4. Choose Additional HANA Systems, and then Next to continue.

5. Choose Remove HANA System , then select a system from the displayed list, and then Next to continue.

6. Specify the required entries by following the instructions of the wizard.

For uninstalling multiple SAP HANA systems in interactive mode, use the command ./hanaconfig.sh removehanasystem.

For uninstalling multiple SAP HANA systems in batch mode, use the command ./hanaconfig.sh --batch removehanasystem.

Related LinksCall Options for Removing Additionally Added SAP HANA Systems [page 29]

3.3.1 Call Options for Removing Additionally Added SAP HANA Systems

Option Name Value Mandatory Default Value Description

--remove_sid SID yes - System ID

--remove_system_memory

<<SID1>=<memory in MB>,<SID2>=<memory in MB>,...>

no The memory on the uninstalled system remains unallocated.

Specifies how to distribute the available memory between the installed HANA systems (instances).

Example:

The following example will uninstall additional SAP HANA system with SID "FC1" and its memory will be added to the already installed SAP HANA system:

./hanaconfig.sh --batch removehanasystem --uninst_sid FC1 --uninst_memory HAN=25000

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

P U B L I C© 2012 SAP AG. All rights reserved. 29

Page 30: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

3.4 Installing and Configuring Solution Manager Diagnostics (SMD) Agent on a SAP HANA System

You can use the hanaconfig program to install SMD on a SAP HANA system.

Make sure you meet these prerequisites:

● You identify the existing system, created by an installation or a file system copy, that is to be installed with SMD.

● You mount the DVD with the HANA configuration tool, which you can find at the following location on the SAP HANA DVD:

<HANA_DVD>\DATA_UNITS\HANA_IM_LINUX__X86_64● You are logged in as the root user● SMD <sid>adm user password must contain only ASCII symbols and must be at least 8 characters long.

3.4.1 Installing SMD on a SAP HANA System with the GUIMake sure that you meet the prerequisites in Installing and Configuring Solution Manager Diagnostics (SMD) Agent on a SAP HANA System [page 30].

In GUI mode, you are prompted to enter the required parameters.

If you specify the host name, make sure that it is fully qualified, such as myhost.sap.com (not just myhost).

1. Connect to the system with an X server client to enable GUI system access.2. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like

the following:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_643. Call the script in GUI mode to perform the installation:

./hanaconfig.sh --guiThe wizard starts.

4. Choose Setup Diagnostics Agent and then follow the instructions of the wizard.

5. Leave the root shell after the reconfiguration has finished.

The installation of SMD diagnostics agent is now finished.

Related LinksCall Options for Installing SMD [page 31]

3.4.2 Installing SMD on a SAP HANA System in Interactive ModeMake sure that you meet the prerequisites in Installing and Configuring Solution Manager Diagnostics (SMD) Agent on a SAP HANA System [page 30].

In interactive mode, the program queries all essential parameters that are not defined using command line options and if invalid parameters are entered the program interrupts the process.

30P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

Page 31: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

If you specify the host name, make sure that is fully qualified, such as myhost.sap.com (not just myhost).

1. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like the following:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_642. Call the hanaconfig program in interactive mode by entering this command.

./hanaconfig.sh smdsetup3. Specify the required data.

Related LinksCall Options for Installing SMD [page 31]

3.4.3 Installing SMD on a SAP HANA System in Batch ModeMake sure that you meet the prerequisites in Installing and Configuring Solution Manager Diagnostics (SMD) Agent on a SAP HANA System [page 30].

In batch mode, you specify all required values using command line options. If you omit required values or specify invalid values the program interrupts the process.

If you specify the host name, make sure that it is fully qualified, such as myhost.sap.com (not just myhost).

1. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like the following:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_642. Call the hanaconfig program in batch mode by entering a command like the following:

./hanaconfig --batch smdsetup <smdsetup options>

For the list of all available options, you can call the tool help by entering ./hanaconfig --help.

Related LinksCall Options for Installing SMD [page 31]

3.4.4 Call Options for Installing SMDOption Name Value Mandatory Default Value Description

smd_sid system Id no DAA SMD system id

smd_number instance number no 98 SMD instance number

smd_virtual_host virtual host name no - Virtual host name

smd_user_password

password yes - SMD administrator user password

smd_user_id user id no - SMD administrator user id

smd_user_shell shell no - SMD administrator login shell

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

P U B L I C© 2012 SAP AG. All rights reserved. 31

Page 32: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Option Name Value Mandatory Default Value Description

smd_sld_conn_type

sld|no no - SLD system connection type

smd_sld_host host name yes if smd_sld_conn_type=sld

- SLD HTTP hostname

smd_sld_port port number yes if smd_sld_conn_type=sld

- SLD HTTP port

smd_sld_user username yes if smd_sld_conn_type=sld

- SLD data supplier user name

smd_sld_password password yes if smd_sld_conn_type=sld

- SLD data supplier password

sm_conn_type ms : P4 Connection via SCS message server

p4 : Direct P4 Connection via Java EE Dispatcher Node

ms_ssl : P4 SSL Connection via SCS message server

p4_ssl : Direct P4 SSL Connection via Java EE Dispatcher Node

no : No connectivity to Solution Manager

no - Solution Manager connection type

sm_host host name yes if sm_conn_type != no

- The fully-qualified host name of the SM Server

sm_port port yes if sm_conn_type != no

- Depending on the connection type either HTTP SCS Message Port, or the Dispatcher P4 Port

32P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

Page 33: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Option Name Value Mandatory Default Value Description

sm_user username yes if sm_conn_type != no

- Solution Manager administrator user name

sm_password password yes if sm_conn_type != no

- Solution Manager administrator password

sm_route route string no - Route between the Diagnostics Agent and Solution Manager

sm_route_password

password no - SAP router password

3.5 Uninstalling the Solution Manager Diagnostics (SMD) Agent from a SAP HANA System

You can use the hanaconfig.sh program to uninstall the SMD agent from a SAP HANA system.

Make sure you meet these prerequisites:

● You identify the existing system, created by an installation or a file system copy, from which the SMD agent is to be uninstalled.

● You mount the DVD with the HANA On-Site Configuration tool, which you can find at the following location on the SAP HANA DVD:

<HANA_DVD>\DATA_UNITS\HANA_IM_LINUX__X86_64● You are logged in as the root user

3.5.1 Uninstalling SMD Agent in GUI mode Make sure that you meet the prerequisites in Uninstalling the Solution Manager Diagnostics (SMD) Agent from a SAP HANA System [page 33].

1. Connect to the system with an X server client to enable GUI system access.

2. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like the following:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_64

3. Call the script in GUI mode and select the uninstall task:

./hanaconfig.sh --gui

4. Choose Uninstall Diagnostics Agent.

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

P U B L I C© 2012 SAP AG. All rights reserved. 33

Page 34: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Follow the instuctions of the wizard.

Related LinksCall Options for Uninstalling SMD [page 35]

3.5.2 Uninstalling SMD Agent in Interactive Mode Make sure that you meet the prerequisites in Uninstalling the Solution Manager Diagnostics (SMD) Agent from a SAP HANA System [page 33].

In interactive mode, the program queries all essential parameters that are not defined using command line options and if invalid parameters are entered the program interrupts the process.

1. Open a root shell.

2. In a single-host system, go to this directory:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_64

3. Enter this command:

./hanaconfig.sh smduninstall

Note: None of the additional call options is mandatory here, only smduninstall. If there is only one host

installed with a SMD agent, it is automatically found and uninstalled. If there are more hosts, you need to specify from which one the SMD agent should be uninstalled. You can do this by choosing one from the displayed list of hosts.

4. Specify the data requested by the program.

Related LinksCall Options for Uninstalling SMD [page 35]

3.5.3 Uninstalling SMD Agent in Batch Mode Make sure that you meet the prerequisites in Uninstalling the Solution Manager Diagnostics (SMD) Agent from a SAP HANA System [page 33].

To call the smduninstall program in batch mode, specify all required values using command line options.

In batch mode, you specify all required values using command line options. If you omit required values or specify invalid values the program interrupts the process.

Note: If there is only one host installed with a SMD agent, it is automatically found and uninstalled. If there are more hosts, you need to specify from which one the SMD agent should be uninstalled.

1. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like the following:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_642. Call the hanaconfig program in batch mode by entering a command like the following:

./hanaconfig --batch smduninstall <smduninstall options>

34P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

Page 35: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

For the list of all available options, you can call the tool help by entering ./hanaconfig --help.

The SMD agent is removed from the selected host.

Related LinksCall Options for Uninstalling SMD [page 35]

3.5.4 Call Options for Uninstalling SMD Option Name Value Mandatory Default Value Description

smd_sid System Id no detected SMD System Id

smd_number Instance number no detected SMD Instance Number

smd_virtual_host virtual host name no detected Virtual Host Name

3.6 Renaming a SAP HANA System

You can rename a SAP HANA system using the hanaconfig.sh program. When you use the rename functionality (also called task), you can:

● change SID, instance number, hostname● change system administrator password● change database user password● change SUM for SAP HANA SSL keystore password

The tool updates the landscape management (LM) structure folder, and generates new SSL certificates.

Note: If you rename a SAP HANA system, this normally invalidates the permanent SAP license. You therefore need to reinstall the SAP license. For more information about how to install the license key, see the SAP HANA Database Administration Guide at http://help.sap.com/hana.

Before performing the rename, you need to meet these prerequisites:

● You identify an existing SAP HANA system, created by an installation or a file system copy, that is to be renamed.

● You mount the DVD with the SAP HANA On-Site Configuration tool, which you can find at the following location on the SAP HANA DVD:

<HANA_DVD>\DATA_UNITS\HANA_IM_LINUX__X86_64● The target system ID (SID) must not exist.● The target instance number must not exist.● You are logged in as the root user.● <sapsid>adm user password must contain only ASCII symbols and be at least 8 characters long, and must

contain at least one digit, one lowercase character and one uppercase character. Only the following 3 special characters are allowed: $ _ #.

3.6.1 Renaming a SAP HANA System with GUI Make sure that you meet the prerequisites in Renaming a SAP HANA System [page 35].

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

P U B L I C© 2012 SAP AG. All rights reserved. 35

Page 36: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

In GUI mode, you are prompted to enter the required parameters.

If you specify the host name, make sure that it is fully qualified, such as myhost.sap.com (not just myhost).

1. Connect to the system with an X server client to enable GUI system access.2. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like

the following:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_643. Call the script in GUI mode to perform the rename:

./hanaconfig.sh --gui 4. Choose Rename HANA System, and then choose Next to continue.

5. Specify the required entries.

Note: You have the option to specify a dedicated time zone. By default, the time zone is set to UTC (Coordinated Universal Time).

6. Leave the root shell after the rename has finished.

3.6.2 Renaming a SAP HANA System in Interactive Mode Make sure that you meet the prerequisites in Renaming a SAP HANA System [page 35] .

In interactive mode, the program queries all essential parameters that are not defined using command line options as well as parameters that have invalid values.

1. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like the following:cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_64

2. Call the hanaconfig program with the hanarename task by entering this command:./hanaconfig.sh hanarename

3. Specify the required data.

The system is now renamed.

Related LinksCall Options for Renaming a SAP HANA System [page 37]

3.6.3 Renaming a SAP HANA System in Batch Mode Make sure that you meet the prerequisites in Renaming a SAP HANA System [page 35].

In batch mode, you specify all required values using command line options. If you omit required values or specify invalid values, the program displays an error message and terminates.

1. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like the following:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_642. Call the hanaconfig program.

./hanaconfig --batch hanarename <rename options>

36P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

Page 37: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

For the list of all available options, you can call the tool help by entering ./hanaconfig --help.

Related LinksCall Options for Renaming a SAP HANA System [page 37]

3.6.4 Call Options for Renaming a SAP HANA SystemOption Name Value Mandatory Default Value Description

source_sid current SID no detected Current system id

target_sid new SID no - New system id

number instance number no current instance number

New instance number

source_password password yes - Current system administrator password

target_password password yes if the SID is being renamed

New system administrator password

home home directory no if current home follows the pattern /usr/sap/<SID>/home the SID is changed to the value of "--target_sid"

New system administrator home directory

shell shell no current shell New system administrator login shell

userid user id no detects free user id New system administrator user id

timezone time zone name no - New system administrator time zone (see --print_timezones

hostmap hostname=new hostname

no - Rename hosts<current hostname>=<new fully qualified hostname>

remote_root_user remote root user Root user for additional hosts

remote_root_user_password

remote root user password

Password for the remote root user

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

P U B L I C© 2012 SAP AG. All rights reserved. 37

Page 38: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Option Name Value Mandatory Default Value Description

ext_host hostname no - New external hostname

keep_user - no - Keeps current system administrator user

change_keystore_password

- no no Changes the SSL keystore password

keystore_password password yes, if the hostname is being renamed

- Current SSL keystore password

new_keystore_password

password yes, if --change_keystore_password present

- New SSL keystore password

change_system_user_password

- no - Changes the database User SYSTEM password

source_system_user_password

password yes if --change_system_user_password present

- Current database User SYSTEM password

target_system_user_password

password yes if --change_system_user_password present

- New database User SYSTEM password

In case of rename errors, see the following SAP Note 1792151.

3.7 Configuring a SAP HANA System to Connect to System Landscape Directory (SLD) With the provided SLD functionality you can configure the connection parameters for the central SLD system. When a SAP HANA system is connected to SLD, it can report its status and provide details and information for the system itself.

You can use the hanaconfig.sh program to configure a SLD connection.

For more related information, see SAP notes 1673424 and also 1649323.

Make sure you meet these prerequisites:

● You identify the existing system, created by an installation or a file system copy, that is to be configured with SLD.

● You mount the DVD with the HANA configuration tool, which you can find at the following location on the SAP HANA DVD:

38P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

Page 39: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

<HANA_DVD>\DATA_UNITS\HANA_IM_LINUX__X86_64● You are logged in as the root user

3.7.1 Configuring Connection to SLD in GUIIn GUI mode, you are prompted to enter the required parameters.

1. Connect to the system with an X server client to enable GUI system access.

2. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like the following:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_64

3. Call the script in GUI mode:

./hanaconfig.sh –gui

The wizard starts.

4. Choose <Configure SLD Connection>, then <Next> . Follow the instructions of the wizard.

Related LinksCall Options for Connecting to SLD [page 40]

3.7.2 Configuring Connection to SLD in Interactive ModeBefore you continue, make sure that you meet these prerequisites:

• You are logged on to the host where the server software is installed.

• You are logged on as the root user.

In interactive mode, the program queries all essential parameters that are not defined using command line options and if invalid parameters are entered the program interrupts the process.

1. Open a root shell.

2. Go to the following directory:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_64

3. Enter the following command:

./hanconfig.sh sldconfig

4. Specify the data requested by the program.

Related LinksCall Options for Connecting to SLD [page 40]

3.7.3 Configuring Connection to SLD in Batch ModeBefore you continue, make sure that you meet these prerequisites:

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

P U B L I C© 2012 SAP AG. All rights reserved. 39

Page 40: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

• You are logged on to the host where the server software is installed.

• You are logged on as the root user.

In batch mode, you specify all required values using command line options. If you omit required values or specify invalid values the program interrupts the process.

1. Open a root shell.

2. Go to the following directory:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_64

3. Run the hanaconfig program in batch mode using the sldconfig task:

./hanconfig.sh --batch sldconfig <sldconfig options>

For the list of all available options, you can call the tool help, by entering ./hanaconfig --help

4. Specify the data requested by the program.

Related LinksCall Options for Connecting to SLD [page 40]

3.7.4 Call Options for Connecting to SLD Option Name Value Mandatory Description

sld_host Host name yes SLD Host name

sld_port Port number yes SLD Port [80,443,1024..65535]

sld_user User name yes SLD Username (Administrator role)

sld_password Password yes SLD Password

sld_use_https - no Use https instead of http connection

hana_sid sid yes, if there is more than one SAP HANA systems installed

System ID

3.8 Installing Application Function Libraries (AFLs) on a SAP HANA System

For installing AFLs in GUI mode, you are prompted to enter the required parameters.

1. Connect to the system with an X server client to enable GUI system access.2. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like

the following:

40P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

Page 41: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_643. Call the script in GUI mode to perform the rename:

./hanaconfig.sh --gui 4. Choose Install AFL, and then Next to continue.

5. Specify the required entries by following the instructions of the wizard.

For installing AFLs in interactive mode, use the command ./hanaconfig.sh alfinstall.

You can use as a general guidance the procedure Configuring Connection to SLD in Interactive Mode [page 39].

For installing AFLs in batch mode, use the command ./hanaconfig.sh --batch aflinstall.

You can use as a general guidance the procedure Configuring Connection to SLD in Batch Mode [page 39].

Related LinksCall Options for Installing AFLs on SAP HANA System [page 41]

3.8.1 Call Options for Installing AFLs on SAP HANA System

Option Name Value Mandatory Default Value Description

--afl_sid system Id no detected SAP HANA System Id

--afl_path afl path yes Path to AFL archive

--afl_sidadm_pwd password yes SID password of the installed SAP HANA System.

./hanaconfig.sh --batch aflinstall --afl_sid ABC --afl_path /usr/local/AFL.SAR

3.9 Changing SAP HANA System Edition

To change SAP HANA system edition in GUI mode, you are prompted to enter the required parameters. The possible options are ENTERPRISE and PLATFORM.

1. Connect to the system with an X server client to enable GUI system access.2. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like

the following:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_643. Call the script in GUI mode to perform the rename:

./hanaconfig.sh --gui 4. Choose Change HANA Edition, and then Next to continue.

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

P U B L I C© 2012 SAP AG. All rights reserved. 41

Page 42: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

5. Specify the required entries by following the instructions of the wizard.

For changing SAP HANA system edition in interactive mode, use the command ./hanaconfig.sh changehanaedition. You can use as a general guidance the procedure Configuring Connection to SLD in Interactive Mode [page 39].

For changing SAP HANA system edition in batch mode, use the command ./hanaconfig.sh --batch changehanaedition. You can use as a general guidance the procedure Configuring Connection to SLD in Batch Mode [page 39].

Related LinksCall Options for Changing SAP HANA System Edition [page 42]

3.9.1 Call Options for Changing SAP HANA System Edition

Option Name Value Mandatory Default Value Description

--hana_sid system Id no detected SAP HANA System Id

--hana_edition <Platform | Enterprise>

yes SAP HANA Edition Id

3.10 Perform a Distributed SAP HANA Setup

You have the possibility to add (or remove) additional hosts to your SAP HANA system with the On-Site Configuration tool. To do this, follow the procedure below:

1. Connect to the system with an X server client to enable GUI system access.2. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a command like

the following:

cd <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_643. Call the script in GUI mode to perform the rename:

./hanaconfig.sh --gui 4. Choose HANA Distributed Setup, and then Next to continue.

5. Choose Add Additional Host (or Remove Additional Host), and then choose Next to continue.

When adding additional host you need to specify what its role is: worker or standby.

6. Specify the required entries.For adding additional host in interactive mode, use the command ./hanaconfig.sh addhost(or removehost). You can use as a general guidance the procedure Configuring Connection to SLD in Interactive Mode.

42P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

Page 43: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

For adding additional host in batch mode, use the command ./hanaconfig.sh --batch addhost(or removehost) . You can use as a general guidance the procedure Configuring Connection to SLD in Batch Mode.

3.10.1 Call Options for Adding/Removing Hosts

Table 4: Add Host Options

Option Name Value Mandatory Default Value Description

addhost_sid <SID> System ID No Detected System ID of the new host

addhost_hostname <hostname>

Hostname Yes Hostname

addhost_master_password <password>

Password Yes System administrator password

addhost_root_user <root user>

Root user Yes Root user

addhost_root_user_password <root user password>

Root user password Yes Root user password

addhost_role <role> Role Yes Additional host role

addhost_ha_group <high availability group>

High availability group

No Failover group in High Availability scenarios

addhost_storage_partition

Storage partition No Storage partition number

Table 5: Remove Host Options

Option Name Value Mandatory Default Value Description

removehost_sid <SID>

System ID No Detected System ID of the existing host

removehost_hostname <hostname>

Hostname Yes Hostname of the existing host

removehost_root_user <root user>

Root user Yes Root user of the existing host

removehost_root_user_password <root user password>

Root user password Yes Root user password of the existing host

SAP HANA Installation Guide with SAP HANA Unified InstallerUsing SAP HANA On-Site Configuration Tool

P U B L I C© 2012 SAP AG. All rights reserved. 43

Page 44: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

4 Post-Installation

You can perform the post-installation steps of your choice, described in the following sections, after the SAP HANA unified installer has finished:

Related LinksStarting and Stopping the SAP HANA System [page 44]Displaying the Process List [page 46]Logging on to the SAP HANA System Using the SAP HANA Studio [page 47]Ensuring User Security [page 47]Configuring the Software Update Manager for SAP HANA [page 47]Accessing the SAP HANA Studio Repository [page 49]Enabling Automatic Start of the SAP HANA Database [page 49]Applying Updates and Support Packages [page 49]Monitoring the SAP HANA System Landscape [page 50]

4.1 Starting and Stopping the SAP HANA SystemAfter the installation has finished successfully, the SAP HANA system is up and running. So you do not need to start the SAP HANA system.

However, if required, you can start and stop the SAP HANA system from the command line in one of the following ways:

● By using the sapcontrol program:

a) Log on to the SAP HANA system host as a user with root authorization.b) Execute one of the following commands:

○ Start the SAP HANA system by entering the following command: /usr/sap/hostctrl/exe/sapcontrol -nr <Instance_Number> -function Start

○ Stop the SAP HANA system by entering the following command: /usr/sap/hostctrl/exe/sapcontrol -nr <Instance_Number> –function Stop

● By using the HDB program:

a) Log on to the SAP HANA system host as user <sapsid>adm.b) Execute one of the following commands:

○ Start the SAP HANA system by entering the following command: /usr/sap/<SAPSID>/<Instance_Name>/HDB start

Example:

/usr/sap/KB1/HDB26/HDB start○ Stop the SAP HANA system by entering the following command: /usr/sap/<SAPSID>/

<Instance_Name>/HDB stop

44P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerPost-Installation

Page 45: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Example:

/usr/sap/KB1/HDB26/HDB stop

Note: The SAP HANA database does not start automatically by default when the SAP HANA system is started. But you can enable such automated start. For more information, see Enabling Automatic Start of the SAP HANA Database [page 49].

4.2 Performing Initial Backup of SAP HANA System

We strongly recommend you to perform initial backup of your system, once you have finished the installation.

For more information, see the section Backing Up Systems in the SAP HANA Database Administration Guide.

4.3 Enabling Persistence Encryption

To ensure that the SAP HANA database can always be restored to its most recent committed state, all data is periodically copied to disk. Privacy of data on disk can be ensured by enabling persistence encryption.

Data is stored in persistent disk volumes that are organized in pages. If persistence encryption is enabled, all pages that reside in the data area on disk are encrypted using the AES-256-CBC algorithm. Pages are transparently decrypted as part of the load process. When pages reside in memory they are therefore not encrypted and there is no performance overhead for in-memory page accesses. When changes to data are persisted to disk, the relevant pages are automatically encrypted as part of the write operation.

Note: You must be logged on to the SAP HANA host as the operating system user, <sid>adm.

1. Generate a root encryption key using the hdbnsutil program.

Caution: Do not generate the root encryption key after you have enabled persistence encryption, since this would render the SAP HANA database unusable.

The command is as follows:

#hdbnsutil -generateRootKeys --type=ALL2. Enable persistence encryption by executing the following SQL command:

ALTER SYSTEM PERSISTENCE ENCRYPTION ON

Encryption is now active. We recommend that you periodically change the encryption key used to encrypt pages in the data area in line with your organization's security policy.Related LinksSAP HANA Security GuideSAP HANA Administration Guide

SAP HANA Installation Guide with SAP HANA Unified InstallerPost-Installation

P U B L I C© 2012 SAP AG. All rights reserved. 45

Page 46: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

4.4 Displaying the Process List

Prerequisites

You are logged on to the SAP HANA host as user root .

Procedure

You can display SAP HANA system processes by executing the following commands from the command line:

/usr/sap/hostctrl/exe/sapcontrol -nr <instancenr> -function GetProcessList

You can also display the SAP HANA system processes using the SAP Microsoft Management Console (SAP MMC) from a Windows PC.

Displaying the Process List

myhost.sap.com:/mnt/HANA_DVD/DATA_UNITS/HANA_IM_LINUX__X86_64 # /usr/sap/hostctrl/exe/sapcontrol -nr 39 -function GetProcessList

18.07.2011 13:13:34

GetProcessList

OK

name, description, dispstatus, textstatus, starttime, elapsedtime, pid

hdbdaemon, HDB Daemon, GREEN, Running, 2011 07 18 11:02:30, 2:11:04, 1598

hdbnameserver, HDB Nameserver, GREEN, Running, 2011 07 18 11:02:32, 2:11:02, 1627

hdbpreprocessor, HDB Preprocessor, GREEN, Running, 2011 07 18 11:02:39, 2:10:55, 1671

hdbindexserver, HDB Indexserver, GREEN, Running, 2011 07 18 11:02:42, 2:10:52, 1688

hdbstatisticsserver, HDB Statisticsserver, GREEN, Running, 2011 07 18 11:02:44, 2:10:50, 1696

wdflbmd0417:/mnt/HANA_DVD/DATA_UNITS/HANA_IM_LINUX__X86_64 #

46P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerPost-Installation

Page 47: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

4.5 Logging on to the SAP HANA System Using the SAP HANA Studio

Prerequisites

● The installation has finished successfully.

● You have installed and started the SAP HANA studio on your local PC as described in the SAP HANA Database - Studio Installation and Update Guide.

Procedure

1. Open the Administration Console perspective .2. Right-click on the Navigator view and select Add System.3. Specify the required parameters, such as host name, instance number, and SAP system ID (SAPSID).4. Choose Authentication by database user and enter SYSTEM for User Name .

Result

You see your SAP HANA system in the Navigator view.

Related LinksEnsuring User Security [page 47]

4.6 Ensuring User Security

After the installation has finished, the master password is assigned to all users that were created by the installer. Make sure that you replace the master password with passwords that comply with your security guidelines. For more information, see the SAP HANA Security Guide.

Related LinksLogging on to the SAP HANA System Using the SAP HANA Studio [page 47]Users Created During the Installation [page 16]

4.7 Configuring the Software Update Manager for SAP HANA

In addition to the SUM default configuration, you have to provide the server certificate for the SAP HANA Update UI.

You have to do this for each SAP HANA studio installation where the SAP HANA Update UI is to be used.

SAP HANA Installation Guide with SAP HANA Unified InstallerPost-Installation

P U B L I C© 2012 SAP AG. All rights reserved. 47

Page 48: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

Note: From SPS 04 version (or newer), the certificates are automatically imported, and you do not need to import them. If your SAP HANA studio is SPS 03 or older, do the following procedure:

1. Copy the server certificate sumforhana.cer from /usr/sap/<SID>/SUM/config/sumforhana.cer to the host where the SAP HANA studio is installed.

2. Run the following command using administrator's privileges from the directory where you have copied sumforhana.cer:keytool -importcert -keystore "<JRE_DIR>\lib\security\cacerts" -alias sumforhana_$<hostname>_$<SAPSID> -file sumforhana.cer

Note:

<JRE_DIR> is the path to the Java runtime used by the SAP HANA studio. To find this path, choose Help About SAP HANA Studio Installation Details Configuration and check the value of the java.home property.

If the SAP HANA studio is installed on a UNIX/LINUX system, use forward slashes / in the command above.

You are asked for the key store password. Note that this is different from the password for the server key store. The default password for the cacerts key store is changeit, but if it has been changed you have to find out what it is and provide it here.

3. Restart the SAP HANA studio.

If the default security configuration is not suitable for your organization, see the SAP HANA Automated Update Guide for detailed configuration information. For security considerations, see the SAP HANA Security Guide.

Contents of the SUM config directory after the installation has finished

wdflbmd7674:/usr/sap/S51/SUM/config # ll

total 32

drwxr-xr-x 2 s51adm sapsys 4096 Sep 2 00:30

drwxr-xr-x 23 s51adm sapsys 4096 Sep 2 00:30 .

-r-------- 1 s51adm sapsys 33 Sep 2 00:30 catalina.properties

-rw-r--r-- 1 s51adm sapsys 1238 Sep 2 00:30 keystore.jks

-rw-r--r-- 1 s51adm sapsys 449 Sep 2 00:30 sumforhana.cer

-rw-r--r-- 1 root root 4111 Aug 18 19:21 tomcat-server.xml

48P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerPost-Installation

Page 49: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

4.8 Accessing the SAP HANA Studio Repository

The Software Update Manager (SUM) for SAP HANA server also hosts the p2 update site for the SAP HANA studio.

1. Make sure that the SUM for SAP HANA server is up and running.If required, start the SUM for SAP HANA as described in the SAP HANA Automated Update Guide.

2. Access the SAP HANA Studio p2 update site using the following URL:https://<hostname>:8080/studio_repository

Related LinksConfiguring the Software Update Manager for SAP HANA [page 47]

4.9 Enabling Automatic Start of the SAP HANA Database

By default the SAP HANA database is configured so that it is not started automatically when the SAP HANA host is rebooted.

If required, you can change this configuration by modifying the profile of the SAP HANA database as follows:

1. Log on to the SAP HANA host as a user with root authorization.

2. Change to the system profile directory /usr/sap/<SAPSID>/SYS/profile.

3. Edit the profile <SID>_HDB<Instance_No>_<host_name>.

4. Change the parameter setting Autostart = 0 to Autostart = 1 .5. Save the profile <SID>_HDB<Instance_No>_<host_name>.

The SAP HANA database is started automatically when the SAP HANA host is rebooted.

4.10 Applying Updates and Support Packages

Prerequisite:

You have configured the SUM for SAP HANA as described in Configuring the Software Update Manager for SAP HANA [page 47]

Procedure:

Use the Lifecycle Management perspective in the SAP HANA studio to update your system. For more information, see the SAP HANA Automated Update Guide.

SAP HANA Installation Guide with SAP HANA Unified InstallerPost-Installation

P U B L I C© 2012 SAP AG. All rights reserved. 49

Page 50: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

4.11 Monitoring the SAP HANA System Landscape

Install and configure the required monitoring tools:

● SAP HANA studio for monitoring the SAP HANA database - see SAP HANA Administration Guide● SAP NetWeaver monitoring tools● Monitoring tools of other SAP HANA components (for example SAP BusinessObjects monitoring tools)

Note: For more information, see SAP HANA Technical Operations Manual, section Monitoring the SAP HANA System Landscape.

50P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerPost-Installation

Page 51: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

5 Installing Trigger-Based Replication

For information about SAP HANA installation and upgrade for the trigger-based replication, see the SAP HANA Installation Guide - Trigger-Based Replication.

Note: For trigger-based replication, no additional components will be installed on the SAP HANA system.

Related LinksSAP HANA Installation Guide - Trigger-Based Replication

SAP HANA Installation Guide with SAP HANA Unified InstallerInstalling Trigger-Based Replication

P U B L I C© 2012 SAP AG. All rights reserved. 51

Page 52: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

6 Installing the SAP HANA Direct Extractor Connection (DXC)

For information about SAP HANA installation and configuration for the extractor-based data acquisition, see SAP HANA Direct Extractor Connection Implementation Guide.

Related LinksSAP HANA Direct Extractor Connection Implementation Guide

52P U B L I C© 2012 SAP AG. All rights reserved.

SAP HANA Installation Guide with SAP HANA Unified InstallerInstalling the SAP HANA Direct Extractor Connection (DXC)

Page 53: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

7 Installing ETL-Based Replication

You can add existing SAP BusinessObjects products to the SAP HANA landscape. The information below provides a list of the available documentation to integrate SAP Data Services to your SAP HANA landscape.

In addition to these SAP HANA components, the customer can add existing SAP BusinessObjects products to the SAP HANA landscape to use SAP BusinessObjects end user clients like SAP BusinessObjects Explorer or SAP BusinessObjects Xcelsius on top to analyze the data.

If you are not using BusinessObjects Enterprise with SAP Data Services, you need information platform services installed together with SAP Data Services.

Related LinksInformation Platform Services Installation Guide for UNIXInformation Platform Services Installation Guide for WindowsData Services Installation Guide for UNIXData Services Installation Guide for WindowsData Services Upgrade Guide

SAP HANA Installation Guide with SAP HANA Unified InstallerInstalling ETL-Based Replication

P U B L I C© 2012 SAP AG. All rights reserved. 53

Page 54: SAP HANA Installation Guide With SAP HANA Unified Installer(SPS 05)

www.sap.com/contactsap

© 2012 SAP AG. 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.Microsoft, Windows, Excel, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.IBM, DB2, DB2 Universal Database, System ads, System i5, System p, System p5, System x, System z, System z10, System z9, z10, z9, iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS, S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise Server, PowerVM, Power Architecture, POWER6+, POWER6, POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes, BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX, Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are trademarks or registered trademarks of IBM Corporation.Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe Systems Incorporated in the United States and/or other countries.Oracle is a registered trademark of Oracle Corporation.UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group.Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems, Inc.HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C®, World Wide Web Consortium, Massachusetts Institute of Technology.Java is a registered trademark of Sun Microsystems, Inc.JavaScript is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape.SAP, R/3, xApps, xApp, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP Business ByDesign, 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 in several other countries all over the world. 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.