hana_sps4_inst_en.pdf

SAP HANA Installation Guide with SAP HANA Unified Installer■ SAP HANA Appliance Software SPS 04

2012-04-30

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

Copyright

herein as well as their respective logos are trademarks or registered trademarks of SAP AG inGermany and other countries.Business Objects and the Business Objects logo, BusinessObjects,Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects productsand services mentioned herein as well as their respective logos are trademarks or registeredtrademarks of Business Objects Software Ltd. Business Objects is an SAP company.Sybase andAdaptive Server, iAnywhere, Sybase 365, SQL Anywhere, and other Sybase products and servicesmentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase,Inc. Sybase is an SAP company. Crossgate, m@gic EDDY, B2B 360°, B2B 360° Services areregistered trademarks of Crossgate AG in Germany and other countries. Crossgate is an SAPcompany. All other product and service names mentioned are the trademarks of their respectivecompanies. Data contained in this document serves informational purposes only. National productspecifications may vary.These materials are subject to change without notice. These materials areprovided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only,without representation or warranty of any kind, and SAP Group shall not be liable for errors oromissions with respect to the materials. The only warranties for SAP Group products and servicesare those that are set forth in the express warranty statements accompanying such products andservices, if any. Nothing herein should be construed as constituting an additional warranty.

2012-04-30

Contents

Installing SAP HANA Overview...............................................................................................5Chapter 1

Software Components.............................................................................................................51.1Software Download..................................................................................................................81.2Important SAP Notes...............................................................................................................81.3Hardware and Software Requirements.....................................................................................91.4SAP HANA Guides................................................................................................................111.5Technical System Landscape.................................................................................................111.6

Running SAP HANA Unified Installer....................................................................................13Chapter 2

Preparation............................................................................................................................132.1Required File Systems and Directories...................................................................................132.1.1Installation Parameters...........................................................................................................162.1.2Users Created During the Installation.....................................................................................192.1.3Required Installation Media....................................................................................................202.1.4Preparing the Installer Configuration File................................................................................212.1.5Performing a Distributed System Installation (Optional)..........................................................222.1.6Running the Installer...............................................................................................................232.2Installed SAP HANA Components and Directories.................................................................252.2.1Uninstall.................................................................................................................................282.2.2Troubleshooting.....................................................................................................................302.2.3Post-Installation......................................................................................................................302.3Starting and Stopping the SAP HANA System.......................................................................312.3.1Performing Initial Back Up of SAP HANA System..................................................................312.3.2Displaying the Process List....................................................................................................322.3.3Logging on to the SAP HANA System Using the SAP HANA Computing Studio...................322.3.4Ensuring User Security...........................................................................................................332.3.5Configuring the Software Update Manager for SAP HANA....................................................332.3.6Using SAP HANA On-Site Configuration Tool........................................................................342.3.7Accessing the SAP HANA Studio p2 Repository...................................................................492.3.8Enabling Automatic Start of the SAP HANA Database...........................................................492.3.9Applying Updates and Support Packages...............................................................................502.3.10Monitoring the SAP HANA System Landscape......................................................................502.3.11

2012-04-303

Installing Trigger-Based Replication.....................................................................................51Chapter 3

Installing the SAP HANA Direct Extractor Connection (DXC)..............................................53Chapter 4

Installing ETL-Based Replication...........................................................................................55Chapter 5

Log-Based Replication..........................................................................................................57Chapter 6

2012-04-304

Contents

Installing SAP HANA Overview

This SAP HANA installation guide describes how to install SAP HANA with the SAP HANA unifiedinstaller. Before starting the installation of SAP HANA, make sure that you have read the SAP HANAMaster 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

• SAP HANA appliance software enterprise extended edition

2012-04-305


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

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

The SAP HANA appliance software platform edition is intended for customers who want to useETL-based replication and already have a license for SAPBusinessObjects Data Services. It is comprisedof 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)

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

• SAP HANA studio

• SAP HANA client



2012-04-306





• SAP HANA Direct Extractor Connection (DXC)

• SAP LT Replication AddOn

• SAP LT Replication Server

• SAP BusinessObjects Data Services 4.0

TheSAPHANA appliance software enterprise extended edition is intended for customers who wantto use the full potential of all available replication scenarios including log-based replication. It is comprisedof the following components:• SAP HANA database

• SAP HANA studio

• SAP HANA client






• SAP HANA Direct Extractor Connection (DXC)

• SAP LT Replication AddOn

• SAP LT Replication Server

• SAP BusinessObjects Data Services 4.0

• Sybase Adaptive Server Enterprise (ASE) 15.5

• Sybase Replication Server 15 (incl. ECDA)

• Sybase Replication Server Agent 15

• SAP HANA load controller

Note:

• The Software Update Manager (SUM) for SAP HANA is installed by the SAP HANA unified installertogether with other SAP HANA components. For a list of components, see SAP HANA InstallationGuide, section "Installed SAP HANA Components and Directories". The Software Update Manager(SUM) for SAP HANA is part of the Software Logistics Toolset (SL Toolset).

• SAP HANA information composer is aWeb-based environment that allows business users to uploaddata to the SAP HANA database and to manipulate that data by creating information views. TheSAP HANA information composer is installed separately from the SAP HANA system. For moreinformation, see the SAP HANA Information Composer – Installation and Configuration Guide.

2012-04-307


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


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

1.2 Software Download

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

1.3 Important SAP Notes

You must read the following SAP Notes before you start the installation. These SAP Notes contain thelatest 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 SAPService Marketplace at https://service.sap.com/notes.

TitleSAP Note Number

SAP HANA: Central Note1514967

SAP HANA Appliance Software SPS 04 Release Note1703675

SAP HANA Database: Central Note1523337

Swap-space recommendation for Linux1597355

Support for multiple SAP HANA databases on a single SAP HANA appliance1681092

Support for multiple applications on SAP HANA1661202

Supported clients for SAP HANA1577128

2012-04-308


https://service.sap.com/notes

https://service.sap.com/sap/support/notes/1514967







TitleSAP Note Number

SAP HANA: Sizing SAP HANA Database1514966

SAP BW on HANA: Sizing SAP HANA Database1637145

Check the current SAP Notes for the various parts of SAP HANA by searching for any of the followingCSS/CSN components:

SAP HANA Platform Edition• BC-HAN SAP HANA appliance software• BC-DB-HDB SAP HANA database• BC-DB-HDB-ENG SAP HANA database engine• BC-DB-HDB-PER SAP HANA database persistence• BC-DB-HDB-SYS SAP HANA database interface/DBMS• BC-DB-HDB-DBA SAP HANA database administration (DBA cockpit)• BC-DB-HDB-MDX MDX Engine (Microsoft Excel client)• BC-HAN-MOD SAP HANA studio / modeler• BC-HAN-3DM Information Composer• BC-HAN-SRC Search• BC-CCM-HAG SAP Host Agent

SAP HANA Lifecycle Management• BC-HAN-INS, BC-INS-NGP SAP HANA unified installer (lmtp)• BC-DB-HDB-INS SAP HANA database installation• BC-HAN-UPD Software Update Manager (SUM) for SAP HANA• BC-DB-HDB-UPG SAP HANA database upgrade

SAP HANA Enterprise Edition• BC-HAN-LOA SAP HANA load controller (log-based replication)• BC-HAN-LTR SAP Landscape Transformation (trigger-based replication)• BC-DB-HDB-DEC SAP HANA Direct Extractor Connection (DXC) to SAP HANA• BC-HAN-REP Sybase replication server (log-based replication)• EIM-DS Data Services (ETL-based replication)

CSS/CSN 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.

1.4 Hardware and Software Requirements

2012-04-309




Note:You can find a complete list of all SAP HANA components and the respective SAP HANA hardwareand software requirements in the Product Availability Matrix (PAM) on SAP Service Marketplace athttps://service.sap.com/pam.

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 SP1 – for information about installing SLES 11 SP1 in anSAP environment see SAP Note 1310037.

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

• GTK2

• XULRunner 1.9.2 (minimum version)

If you are using a version lower than XULRunner 1.9.2 add the following line to the hdbstudio.inion the SAP HANA box:

-Dorg.eclipse.swt.browser.XULRunnerPath=<xulrunner path>/<xulrunnerversion>

• libicu

• Java JRE 1.6 (necessary for the SAP HANA studio on the SAP HANA system)

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 inthe correct chronological order.

Hardware Requirements

Hardware Check

During the update and the installation of the SAP HANA database (part of installation by the unifiedinstaller), 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 10GBit/s between the SAPHANA landscapeand the source system for efficient data replication.

2012-04-3010


https://service.sap.com/pam



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 theresources listed below:

Quick LinkLocationTopic

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

• SAP HANA Master Guide• SAP HANA Installation Guide with SAP HANA

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

SAP HANA Knowl-edge Center on SAPService Marketplace

SAPHANA landscape,deployment, and instal-lation

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

• SAP HANA Technical Operations Manual• SAP HANA Security Guide

SAP HANA Knowl-edge Center on theSAP Help Portal

SAPHANA administra-tion and security

1.6 Technical System Landscape

The figure below shows an overview of the technical system landscape for the SAP HANA appliancesoftware and its related components, such as the SAP HANA studio and other applications, one ofwhich is the SAPHANA information composer. Note that the figure below shows a sample configurationwith three SAP HANA database servers. The figure also shows some optional components that maybe purchased separately.

2012-04-3011


https://service.sap.com/pam

https://service.sap.com/hana






http://help.sap.com/hana_appliance

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

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

2012-04-3012


Running SAP HANA Unified Installer

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

Related Topics• Performing a Distributed System Installation (Optional)• Preparation• Running the Installer• Post-Installation

2.1 Preparation

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

Related Topics• Required File Systems and Directories• Installation Parameters• Users Created During the Installation• Required Installation Media• Preparing the Installer Configuration File

2.1.1 Required File Systems and Directories

The installer requires a running operating system (OS) with file system partitions created as listed inthe table below. All directories and files of the SAP system to be installed are created and mountedinside this file system.

2012-04-3013


If you have created and mounted these partitions in the appropriate partition before you start theinstallation, the installer recognizes /sapmnt and /usr/sap during the installation and automaticallycreates 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 createthem manually before you start the installation.

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

Table 2-1: Required File Systems

RecommendedDisk SpaceDescriptionFile System

10 GBThe root partition/

5 GB

The file system for the SAPmount directory for globalfiles and profiles.

The default name for the SAP mount directory ishanamnt, however you can also specify anothername. This directory needs to be accessible by eachof the servers in the HANA cluster.

The <hanamnt> path needs not to exceed 5GB, butthe hanamnt/<SID> folder requires RAM equal to thedefault system RAM (1*RAM).

It must be physically shared. The path to the SAPmount directory is a mandatory parameter to be filledin the installer configuration file. For more information,see Installation Parameters and Preparing the In-staller Configuration File.

/<hanamnt>

50 GBThe file system for local SAP system instance direc-tories/usr/sap

2012-04-3014


RecommendedDisk SpaceDescriptionFile System

Data partition mustbe able to write atleast 800 MB/s

The directory for data-volumes of the SAP HANAdatabase.

The path to the data directory depends on the config-uration of the SAP HANA host.

The data path needs to have three times more RAMthan the default system RAM.

Note:This directory must exist before you start the installa-tion.

/<path>/data

Data partition musthave a bandwidthof at least 100,000I/O ops

The directory for log-volumes of the SAP HANAdatabase.

The path to the log directory depends on the configu-ration of the SAP HANA host.

The log path needs to have RAM equal to the defaultsystem RAM.

Note:This directory must exist before you start the installa-tion.

/<path>/log

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

For more information about the swap space, see SAP Note 1597355 Swap Space Recommendationfor Linux.

It is strongly recommended to mount an external backup device/share into the file system of the SAPHANA server. For more information about how to back up your system, see the section Backing UpSystems in the SAP HANA Database Administration Guide.

The following graphic shows the file system for a SAP HANA system and the corresponding sizerecommendations:

2012-04-3015




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

Related Topics• Installation Parameters• Preparing the Installer Configuration File

2.1.2 Installation Parameters

The installer requires the following parameters:• Parameters to be inserted in the configuration file• Parameters to be entered on the command line

2012-04-3016


Table 2-2: Parameters to be inserted in the configuration file

DescriptionParameter ID

The SAP system ID (SAPSID) is the identifier for the SAP HANAsystem.• The ID must be unique throughout your organization and consis-

tent 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 existsin your SAP system landscape.

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

• The following IDs are reserved and cannot be used: ADD ALLAMD AND ANY ARE ASC AUX AVG BIT CDC COM CON DBAENDEPS FORGETGID IBM INT KEY LOG LPTMAPMAXMINMON NIX NOT NUL OFF OLD OMS OUT PAD PRN RAW REFROW SAP SET SGA SHG SID SQL SUM SYS TMP TOP UIDUSE USR VAR.

sid

The instance number of the SAP HANA system

An instance is an administrative unit that comprises the server soft-ware 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.

instancenr

The path to the SAP mount directory

The SAPmount directory can be used as a shared directory betweenmultiple hosts.

The installer sets sapmntPath to /sapmnt by default. Ensure thatthe required file system is available on the installation host. For moreinformation, see Required File Systems and Directories.

If you want to install your SAPHANA system as a system distributedover several hosts, you have to set the sapmntPath to the path ofthe mount points on all hosts on which you want to install SAP HANAinstances. For more information, see Performing a Distributed Sys-tem Installation (Optional).

The installer will automatically create corresponding symbols fromlocal /usr/sap folder, also created during installation.

sapmntPath

2012-04-3017


DescriptionParameter ID

The path to the data directory of the SAP HANA system

We recommend that you name this directory /data.

The path to the data directory depends on the configuration of theSAP HANA host. It is a mandatory parameter to be filled in the in-staller configuration file. For more information, see Installation Pa-rameters and Preparing the Installer Configuration File.

Note:This directory must exist before you start the installation (see alsoRequired File Systems and Directories).

dataPath

The path to the log directory of the SAP HANA system

We recommend that you name this directory /log.

The path to the log directory depends on the configuration of theSAP HANA host. It is a mandatory parameter to be filled in the in-staller configuration file. For more information, see Installation Pa-rameters and Preparing the Installer Configuration File.

Note:This directory must exist before you start the installation (see alsoRequired File Systems and Directories).

logPath

The fully qualified host name of the SAP HANA system

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

For more information about the restrictions that apply to host namesin SAP systems, see SAPNote 611361 - Hostnames of SAP servers.

hdbHost

2012-04-3018


http://service.sap.com/sap/support/notes/611361

Table 2-3: Parameters to be entered on the command line

DescriptionParameter

Common password for all users that are created during the installation (seealso Users Created During the Installation)

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.

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

master password

Related Topics• Performing a Distributed System Installation (Optional)• Required File Systems and Directories• Users Created During the Installation

2.1.3 Users Created During the Installation

The following users are automatically created during the installation. All these users are assigned themaster password:

DescriptionUser

The system administrator, <sapsid>adm is the operating system user requiredfor administrative tasks such as starting and stopping the system.

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

<sapsid>adm

The SAP Host Agent administrator

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

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

sapadm

2012-04-3019


DescriptionUser

The database superuser

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

SYSTEM

2.1.4 Required Installation Media

The following installation medium is required. Make sure that the software contained in the relevantfolders is available on the installation host:

FoldersMedium

HANA_IM_LINUX__X86_64

Contains the installation master/SAP HANA unified installer

SAP HANA PLAT-FORM EDITION

HDB_SERVER_LINUX_X86_64

Contains the SAP HANA database software

HDB_CLIENT_LINUX_X86_64

Contains the SAP HANA database client software

HDB_STUDIO_LINUX_X86_64

Contains the SAP HANA studio repository software

SAP_HOST_AGENT_LINUX_X64

Contains the SAP Host Agent software

SUM4HANA

Contains the SUM for SAP HANA deployment archive

Related Topics• Installation Parameters

2012-04-3020


2.1.5 Preparing the Installer Configuration File

PrerequisitesMake 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• You have specified installation parameters. For more information, see Installation Parameters.• You have made the required installation media available. For more information, see Required

Installation Media.

Procedure1. Copy the file setuphana.slmodel.template, which is available in the HANA_IM_LIN

UX__X86_64 folder on the installation medium, to a local directory. Note that the target file mustonly have the extension .slmodel:

Example:

cp /mnt/HANA_DVD/DATA_UNITS/HANA_IM_LINUX_X86_64/setuphana.slmodel.template /tmp/setuphana.slmodel

2. Edit the setuphana.slmodel file and insert the required installation parameters by filling in allempty fields marked with ${...}:• Insert the path to the data directory for the SAP HANA system :

<StringParameter name="dataPath" value="${DATAPATH}"/>

Example: <StringParameter name="dataPath" value="/data"/>

Note:You must create this directory manually before your start the installation. For more information,see Required File Systems and Directories.

• Insert the path to the log directory for the SAP HANA system :

<StringParameter name="logPath" value="${LOGPATH}"/>

Example: <StringParameter name="logPath" value="/log"/>

Note:You must create this directory manually before your start the installation. For more information,see Required File Systems and Directories.

• Insert the path to the SAP mount directory for the SAP HANA system:

<StringParameter name="sapmntPath" value="/sapmnt"/>

sapmntPath is set to /sapmnt by default. However, you can also specify another directory asSAP mount directory, according to your requirements.

2012-04-3021


Note:Make sure you do not set this parameter to /usr/sap, if you want to install a distributed system.For more information, see Performing a Distributed System Installation (Optional).

• Insert a valid instance number for the SAP HANA system:

<StringParameter name="instancenr" value="${INSTANCENUMBER}"/>

Example: <StringParameter name="instancenr" value="02"/>• Insert a valid SAP system ID (SAPSID):

<StringParameter name="sid" value="${SID}"/>

Example: <StringParameter name="sid" value="HAN"/>• Insert the fully qualified host name of the SAP HANA system:

<StringParameter name="hdbHost" value="${HDBHOST}"/>

Example: <StringParameter name="hdbHost"value="wdflbmd0327.wdf.sap.corp"/>

You have prepared the setuphana.slmodel file.

Related Topics• Performing a Distributed System Installation (Optional)• Required File Systems and Directories• Required Installation Media• Installation Parameters

2.1.6 Performing a Distributed System Installation (Optional)

You want to install your SAP HANA system as a distributed installation, that is, a system distributedover several hosts.

Procedure

Note:To perform a distributed installation you need to do initial installation steps (from 1 to 7 in the procedurebelow), and also steps that are part of the on-site configuration of the system (from 8 to 13 in theprocedure below).

1. Familiarize yourself with the concept of a distributed system by reading Distributed System andInstallation Planning in the SAP HANA Database - Server Installation and Update Guide .

2. Determine and create mount points on all hosts on which you want to install SAP HANA instances,as described in Pre-Installation Steps in the SAP HANA Database - Server Installation and UpdateGuide .

2012-04-3022


https://service.sap.com/~sapidb/011000358700000604572011.pdf



3. When you prepare the installer configuration file, ensure that the sapmntPath parameter is set tothe path of the mount points from the previous step. For more information, see Preparing the InstallerConfiguration File .

4. On the primary host, run the SAP HANA unified installer as described in Running the Installer.5. Add the required hdb hosts as described in Adding a Host to the System in the SAP HANADatabase

- Server Installation and Update Guide .6. On the secondary (additional) hosts, install the SAP Host Agent via the rpm package on the DVD.

On the primary host it is installed by default by SAP HANA unified installer.7. On the secondary hosts, install the SAP HANA client. On the primary host this is done by the SAP

HANA unified installer.8. Finalize installation by running the SAP HANA On-Site Configuration tool for adapting the existing

configuration, if necessary. For more information, see Using SAP HANAOn-Site Configuration Tool.9. Install SMD agent on the primary host, if necessary. For more information, see Installing and

Configuring Solution Manager Diagnostics (SMD) Agent on a SAP HANA System.10. Provide connectivity data for SAP Solution Manager or System Landscape Directory (SLD) . For

more information, see Configuring a SAP HANA System to Connect to System Landscape Directory(SLD) .

11. On the secondary hosts, install SMD agent following manual procedure. Provide only connectivitydata to SMD agent and host agent. SAP HANA database SLD data supplier needs to be configuredonly once.

12. Change SAPHANA edition from SAP HANA platform to SAP HANA enterprise via lm-structureinstallation, if applicable.This also applies for a single appliance installation.

13. Execute initial system backup for later recovery of the initial system state. This also applies for asingle appliance installation.

Related Topics• Installation Parameters• Preparing the Installer Configuration File• Running the Installer

2.2 Running the Installer

Prerequisites

Make sure you have done the following before you start the installer:• You have made the installation media available. For more information, see Required Installation

Media.

• You have specified the required installation parameters. For more information, see InstallationParameters.

2012-04-3023




• You have prepared the installer configuration file. For more information, see Preparing the InstallerConfiguration File.

• You have specified a <WORKING_DIRECTORY> for the installer. For more information, see RequiredFile Systems and Directories

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.

Procedure1. Log on to the installation host as a user with root authorization.2. Start the installer in one of the following ways:

• To run the installer from the installation medium, proceed as follows:a. Change to the directory HANA_IM_LINUX__X86_64 on the installation medium where the

setup.sh script is located.b. 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 beunpacked and <MODEL_FILE> is the path to the installer configuration file.

Example:

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

• To run the installer from the downloaded installer ZIP file, proceed as follows:a. Change to the directory to which you have unpacked the installer ZIP file.b. Start the installer from the command line by entering the following command:

./setup.sh -d <MEDIUM_LOCATION> <WORKING_DIRECTORY> <MODEL_FILE>

where <MEDIUM_LOCATION> is the path to the installation medium, <WORKING_DIRECTORY>is the path to the directory to which the installer is to be unpacked, and <MODEL_FILE> isthe path to the installer configuration file.

Example:

./setup.sh -d /mnt/HANA_DVD /tmp/hanainst /tmp/setuphana.slmodel

3. During the installation process, you are prompted to enter and repeat the master password on thecommand 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 successfully

2012-04-3024


The SAP HANA system is now up and running.

Related Topics• Required Installation Media• Required File Systems and Directories• Installation Parameters• Preparing the Installer Configuration File• Installed SAP HANA Components and Directories• Troubleshooting

2.2.1 Installed SAP HANA Components and Directories

DescriptionDirectoryComponent

For more information about the host agent andits elements, see SAP Note 1031096 - InstallingPackage SAPHOSTAGENT

/usr/sap/hostctrlSAP Host Agent

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

/usr/sapmnt/<SID>SAP HANAdatabase

Contains the following sub-directories:• home

The home directory of the <sid>adm user

• SYS

Contains system executables

• lm_structure

Contains thelandscapeDescription.xmlfile

/usr/sap/<SAPSID>SAP HANAdatabase

2012-04-3025




sunlog6

Texte surligné

DescriptionDirectoryComponent

Only the client for the SAP HANA system, notclients on related SAP ERP systems/usr/sap/hbdclientSAP HANA client

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

/usr/sap/hdbstudio_update

SAP HANA studiorepository

The Software Update Manager (SUM) for SAPHANA downloads new Support Package Stacks(SPS) for SAP HANA from the SAP ServiceMarketplace (SMP) and updates the componentson your SAP HANA system.

The automated update is performed with theSoftware UpdateManager (SUM) for SAPHANA, which is installed and configured with a defaultsecurity configuration with the SAPHANA unifiedinstaller. For more information, see SUM for SAPHANA Default Configuration .

/usr/sap/<SAPSID>/SUMSUM for SAPHANA

SAPHANAStudio installation configured to workwith Software Update Manager for SAP HANA.For more information, see SUM for SAP HANADefault Configuration.

/usr/sap/hdbstudioSAP HANA Studio

Related Topics• Configuring the Software Update Manager for SAP HANA

2.2.1.1 SUM for SAP HANA Default Configuration

SUM for SAP HANA is installed and configured with a default security configuration that is ready-to-run.You can use it to minimize configuration effort.

The following graphics outline the default security configuration that the installer provides:

2012-04-3026


The communication between the SAP HANA studio, SUM for SAP HANA server, and the host agentis done via HTTPS. This communication requires configuration performed by the installer.

Starting on the right of the figure, a keystore named /usr/sap/hostctrl/exe/sec/SAPSSLS.psewith a public/private key pair is generated and password protected for the host agent. The SAP HostAgent can read the private key via a special file /usr/sap/hostctrl/exe/sec/cred_v2, whichcontains the keystore password in an encrypted form. The cred_v2 is only readable for user sapadm. The password is generated randomly.

If there is already a keystore for the SAP Host Agent, it is not deleted or modified. An attempt is madeto export the certificate so that it can be used by the SUM for SAP HANA server. A password is notrequired if the cred_v2 exists. If there is no cred_v2 file for user sapadm the installation aborts.

The public certificate is imported into the keystore of the JVM that is used to run the SUM for SAPHANA server. This keystore is located at /usr/sap/${SID}/SUM/jvm/jre/lib/security/cacerts. This keystore has a default password changeit.

The SUM for SAP HANA keystore contains the public/private key pair for the communication with theSAP HANA studio. The keystore password is generated randomly and stored as clear text in the file/usr/sap/${SID}/SUM/config/catalina.properties file. This is the same password that isused to protect the SAP Host Agent keystore. Make sure that you do not lose it.

This file is required for the web server to be able to access the private key. The public certificate for theSUM for SAP HANA is exported from the SUM for SAP HANA keystore and stored in the file/usr/sap/${SID}/SUM/config/sumforhana.cer. The alias name is sumforhana_${hostname}_${SID}. This public certificate must be imported into the keystore of the SAP HANA studio.

You still need to finalize the SUM for SAP HANA configuration as described in Configuring the SoftwareUpdate Manager for SAP HANA.

2012-04-3027


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

Related Topics•• Configuring the Software Update Manager for SAP HANA

2.2.2 Uninstall

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

Prerequisites

Make sure you have done the following before you start the installer:• You have made the installation media available. For more information, see Required Installation

Media.

• You have specified the required installation parameters. For more information, see InstallationParameters.

• You have prepared the installer configuration file. For more information, see Preparing the InstallerConfiguration File.

• You have specified a <WORKING_DIRECTORY> for the uninstall. For more information, see RequiredFile Systems and Directories

Example:

/tmp/hanainst

Make sure that the <WORKING_DIRECTORY> meets the following requirements:• It has at least 200 MB of free disk space.

2012-04-3028



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

Procedure1. Log on to the host where you want to perform the uninstall as a user with root authorization.2. Start the uninstall.sh script in one of the following ways:

• To run uninstall.sh from the installation medium, proceed as follows:a. Change to the directory HANA_IM_LINUX__X86_64 on the installation medium where the

uninstall.sh script is located.b. Start the installer from the command line by entering the following command:

./uninstall.sh <WORKING_DIRECTORY> <MODEL_FILE>

where <WORKING_DIRECTORY> is the path to the directory to which the installer is to beunpacked and <MODEL_FILE> is the path to the installer configuration file.

Example:

./uninstall.sh /tmp/hanainst /tmp/setuphana.slmodel

• To run the installer from the downloaded installer ZIP file, proceed as follows:a. Change to the directory to which you have unpacked the installer ZIP file.b. Start the installer from the command line by entering the following command:

./uninstall.sh -d <MEDIUM_LOCATION> <WORKING_DIRECTORY> <MODEL_FILE>

where <MEDIUM_LOCATION> is the path to the installation medium, <WORKING_DIRECTORY>is the path to the directory where the installer is to be unpacked, and <MODEL_FILE> is thepath to the installer configuration file.

Example:

./uninstall.sh -d /mnt/HANA_DVD /tmp/hanainst /tmp/setuphana.slmodel

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 Topics• Required Installation Media• Installation Parameters• Preparing the Installer Configuration File• Troubleshooting

2012-04-3029


2.2.3 Troubleshooting

Prerequisites

The installation or uninstall did not finish with the messageFinished successfully

Procedure

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/install.glf

2. Open the installation log file install.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 beforeyour restart the installer.

2.3 Post-Installation

You have to perform the post-installation steps described in the following sections after the SAP HANAunified installer has finished:

Related Topics• Starting and Stopping the SAP HANA System• Displaying the Process List• Logging on to the SAP HANA System Using the SAP HANA Computing Studio• Ensuring User Security• Configuring the Software Update Manager for SAP HANA• Accessing the SAP HANA Studio p2 Repository• Enabling Automatic Start of the SAP HANA Database• Applying Updates and Support Packages• Monitoring the SAP HANA System Landscape

2012-04-3030


2.3.1 Starting and Stopping the SAP HANA System

After the installation has finished successfully, the SAP HANA system is up and running. So you do notneed to start the SAP HANA system.

However, if required, you can start and stop the SAP HANA system from the command line in one ofthe 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

Example:

/usr/sap/KB1/HDB26/HDB stop

Note:The SAPHANA database does not start automatically by default when the SAPHANA systemis started. But you can enable such automated start. For more information, see EnablingAutomatic Start of the SAP HANA Database.

2.3.2 Performing Initial Back Up of SAP HANA System

We strongly recommend you to perform initial back up of your system, once you have finished theinstallation.

2012-04-3031


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

2.3.3 Displaying the Process List

Prerequisites

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

Procedure

You can display SAPHANA system processes by executing the following commands from the commandline:

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

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

Example: Displaying the Process List

wdflbmd0417:/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 #

2.3.4 Logging on to the SAP HANA System Using the SAP HANA Computing Studio

Prerequisites• The installation has finished successfully.

2012-04-3032




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

Procedure1. 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 Topics• Ensuring User Security

2.3.5 Ensuring User Security

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

Related Topics• Logging on to the SAP HANA System Using the SAP HANA Computing Studio• Users Created During the Installation

2.3.6 Configuring the Software Update Manager for SAP HANA

In addition to the SUM default configuration described in SUM for SAP HANA 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 beused.

Proceed as follows:1. Copy the server certificate sumforhana.cer from /usr/sap/<SID>/SUM/config/sum

forhana.cer to the host where the SAP HANA studio is installed.2. Run the following command from the directory where you have copied sumforhana.cer:

2012-04-3033





keytool -importcert -keystore "<JRE_DIR>\lib\security\cacerts" -aliassumforhana_$<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, chooseHelp > About SAP HANA Studio > Installation Details > Configuration and check the valueof the java.home property.

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

You are asked for the key store password. Note that this is different from the password for the serverkey store. The default password for the cacerts key store is changeit, but if it has been changedyou 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 AutomatedUpdate Guide for detailed configuration information. For security considerations, see the SAP HANASecurity Guide.

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

Related Topics• SUM for SAP HANA Default Configuration

2.3.7 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 HANAunified installer. With the SAP HANA On-Site Configuration tool you can perform tasks like renameyour SAP HANA System, install (uninstall) SMD agent on your SAP HANA system, and configure yourSAP HANA system to connect to SLD.

2012-04-3034






The On-Site Configuration tool is started via the hanaconfig program. Before you run the tool, youneed 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 program:• Level 1 - global call options. For more information, see Global Call Options for the Hanaconfig

Program .• Level 2 - tasks, listed below:

• Rename a SAP HANA system

For more information about how to rename your SAPHANA system, see Renaming a SAPHANASystem .

• Install and configure SMD agent

For more information about how to install SMD agent, see Installing and Configuring SolutionManager Diagnostics (SMD) Agent on a SAP HANA System.

• Uninstall SMD agent

For more information about how to uninstll SMD agent, see Uninstalling the Solution ManagerDiagnostics (SMD) Agent from a SAP HANA System .

• Configure SLD connection

For more information about how to connect to SLD, see Configuring a SAP HANA System toConnect to System Landscape Directory (SLD) .

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

2.3.7.1 Global Call Options for the Hanaconfig Program

DescriptionMandatoryValueGlobal Option Name

Launches the configura-tion tool in GUI modeno---gui

Runs the configurationtool in batch modeno---batch

Displays configurationtool versionno---version

Displays configurationtool helpno---help

2012-04-3035


DescriptionMandatoryValueGlobal Option Name

Temporary work folderfor the configi toolnopath to a temp directory--temp_dir

2.3.7.2 Renaming a SAP HANA System

You can rename a SAP HANA system using the hanaconfig program. When you use the renamefunctionality (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 SAPHANA system, this normally invalidates the permanent SAP license. You thereforeneed to reinstall the SAP license. For more information about how to install the license key, see theSAP 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. Onlythe following 3 special characters are allowed: $ _ #.

To rename the instances of a distributed system, you need to perform the rename on each host of thedistributed system.

2.3.7.2.1 Renaming a SAP HANA System with GUI

Make sure that you meet the prerequisites in Renaming a SAP HANA System .

2012-04-3036


http://help.sap.com/hana

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

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 /mnt/<HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_64

3. 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.6. Leave the root shell after the rename has finished.

2.3.7.2.2 Renaming a SAP HANA System in Interactive Mode


In interactive mode, the program queries all essential parameters that are not defined using commandline 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 /mnt/<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 Topics• Call Options for Renaming a SAP HANA System with the Hanaconfig Program

2.3.7.2.3 Renaming a SAP HANA System in Batch Mode


In batch mode, you specify all required values using command line options. If you omit required valuesor 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



2012-04-3037


2. Call the hanaconfig program../hanaconfig --batch hanarename <rename options>

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

Related Topics• Call Options for Renaming a SAP HANA System with the Hanaconfig Program

2.3.7.2.4 Call Options for Renaming a SAP HANA System with the Hanaconfig Program

DescriptionDefault ValueMandatoryValueOption Name

Current SystemId. Use it in casethere is more thanoneHANA systemon the machine orsystem detectionfails

detectednocurrent SIDsource_sid

Change theDatabase userSystemPassword

-no-change_system_user_password

Password ofDatabase UserSystem (SourceSystem)

-

yes if --change_sys-tem_user_pass-word present

passwordsource_system_user_password

Password ofDatabase UserSysyem (TargetSystem)

-

yes if --change_sys-tem_user_pass-word present

passwordtarget_system_user_password

Target System Idcurrent SIDnonew SIDtarget_sid

Target InstanceNumber

current instancenumbernoinstance numbernumber

AdministratorPassword (SourceSystem )

-yespasswordsource_password

AdministratorPassword (TargetSystem)

if the SID is beingrenamedyespasswordtarget_password

2012-04-3038



System Adminis-trator HomeDirec-tory

if current homefollows the pattern/usr/sap/<SID>/homethe SID ischanged to thevalue of "--tar-get_sid"

nodirectoryhome

System Adminis-trator User Id

detects free useridnouder iduserid

Rename hosts<current host-name>=<fullyqualified targethostname>

-nohostname=newhostnamehostmap

Keep the SourceSystem Adminis-trator User

-no-keep_user

SSL KeystorePassword forSUM4HANAcertifi-cates

-yes, if the host-name is being re-named

passwordkeystore_password

Change the SUMSSL keystorepassword

nono-change_keystore_password

New SUM SSLkeystore pass-word

-

yes, if --change_key-store_passwordpresent

passwordnew_keystore_password

System Adminis-trator Login Shellcurrent shellnoshellshell

2.3.7.3 Installing and Configuring Solution Manager Diagnostics (SMD) Agent ona SAP HANA System

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

2012-04-3039


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:


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

2.3.7.3.1 Installing SMD on a SAP HANA System with the GUI

Make sure that you meet the prerequisites in Installing and Configuring Solution Manager Diagnostics(SMD) Agent on a SAP HANA System.


If you specify the host name, make sure that it is fully qualified, such as myhost.sap.com (not justmyhost).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


cd /mnt/ <HANA_DVD>/DATA_UNITS/HANA_IM_LINUX__X86_64

3. Call the script in GUI mode to perform the installation:./hanaconfig.sh --gui

The 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 Topics• Call Options for Installing SMD with Hanaconfig Program

2.3.7.3.2 Installing SMD on a SAP HANA System in Interactive Mode


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

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

2012-04-3040


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


2. Call the hanaconfig program in interactive mode by entering this command../hanaconfig.sh smdsetup

3. Specify the required data.


2.3.7.3.3 Installing SMD on a SAP HANA System in Batch Mode


In batch mode, you specify all required values using command line options. If you omit required valuesor 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 justmyhost).1. Open a root shell and go to the directory where you mounted the SAP HANA DVD, by entering a



2. Call the hanaconfig program in batch mode by entering a command like the following:./hanaconfig --batch smdsetup <smdsetup options>



2.3.7.3.4 Call Options for Installing SMD with Hanaconfig Program


SMD System IdDAAnosystem Idsmd_sid

SMD InstanceNumber98noinstance numbersmd_number

Virtual Host Name-novirtual host namesmd_virtual_host

2012-04-3041



SMD Administra-tor User Password-yespasswordsmd_user_pass

word

SMD Administra-tor User Id-nouser idsmd_user_id

SMD Administra-tor Home Directo-ry

-nohome dirsmd_user_home

Group Id For 'sap-sys' Group-nogroup idsapsys_id

SLD system con-nection type-nosld|nosmd_sld_conn_type

SLD ManagingHost-yes if

smd_sld_conn_type=sldhost namesmd_sld_host

HTTP port of theSLD system-yes if

smd_sld_conn_type=sldport numbersmd_sld_port

User that will beused to connect toSLD

-yes ifsmd_sld_conn_type=sldusernamesmd_sld_user

Password for theSLD User-yes if

smd_sld_conn_type=sldpasswordsmd_sld_password

2012-04-3042



Solution Managerconnection type-no

ms : P4 Connec-tion via SCSmes-sage server

p4 : Direct P4Connection viaJavaEEDispatch-er Node

ms_ssl : P4 SSLConnection viaSCS messageserver

p4_ssl : Direct P4SSL Connectionvia Java EE Dis-patcher Node

no : No connectiv-ity to SolutionManager

sm_conn_type

The fully-qualifiedhost name of theSM Server

-yes ifsm_conn_type !=no

host namesm_host

Depending on theconnection typeyou have to speci-fy either the HTTPSCS MessagePort, or the Dis-patcher P4 Port,or the DispatcherP4 SSL Port ofthe Java stack inyour SAP SolutionManager system


portsm_port

User that will beused to connect tothe ManagingSystem


usernamesm_user

2012-04-3043



Password for theManaging SystemUser


passwordsm_password

Route string de-scribing the sta-tions of a connec-tion required be-tween the Diag-nostics Agent andSolution Manager

-noroute stringsm_route

SAP router pass-word-nopasswordsm_route_pass

word

2.3.7.4 Uninstalling the Solution Manager Diagnostics (SMD) Agent from a SAPHANA System

You can use the hanaconfig 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:


• You are logged in as the root user

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

In GUI mode, you are prompted to enter the required parameters. If you specify the host name, makesure 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.

2012-04-3044




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

./hanaconfig.sh --gui

4. Choose Uninstall Diagnostics Agent.

Follow the instuctions of the wizard.

Related Topics• Call Options for Uninstalling SMD with the Hanaconfig Program

2.3.7.4.2 Uninstalling SMD Agent in Interactive Mode



1. Open a root shell.

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


3. Enter this command:

./hanaconfig.sh smduninstall

Note:None of the additional call options is mandatory here, only smduninstall. If there is only one hostinstalled with a SMD agent, it is automatically found and uninstalled. If there are more hosts, you needto specify from which one the SMD agent should be uninstalled. You can do this by choosing one fromthe displayed list of hosts.

4. Specify the data requested by the program.


2.3.7.4.3 Uninstalling SMD Agent in Batch Mode


2012-04-3045


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


Note:If there is only one host installed with a SMD agent, it is automatically found and uninstalled. If thereare more hosts, you need to specify from which one the SMD agent should be uninstalled. You can dothis by choosing one from the displayed list of hosts.



2. Call the hanaconfig program in batch mode by entering a command like the following:./hanaconfig --batch smduninstall <smduninstall options>


The SMD agent is removed from the selected host.


2.3.7.4.4 Call Options for Uninstalling SMD with the Hanaconfig Program


SMD System IddetectednoSystem Idsmd_sid

SMD InstanceNumberdetectednoInstance numbersmd_number

Virtual Host Namedetectednovirtual host namesmd_virtual_host

2.3.7.5 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 SLDsystem. With that the SAP HANA SLD agent can report its status and provide details and informationfor the SAP HANA system itself.

2012-04-3046


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

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:


• You are logged in as the root user

2.3.7.5.1 Configuring Connection to SLD in GUI


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.



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 Topics• Call Options for Connecting to SLD with Hanaconfig Program

2.3.7.5.2 Configuring Connection to SLD in Interactive Mode

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



2. Go to the following directory:

2012-04-3047



3. Enter the following command:

./hanconfig.sh --sldconfig



2.3.7.5.3 Configuring Connection to SLD in Batch Mode

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



2. Go to the following directory:


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



2.3.7.5.4 Call Options for Connecting to SLD with Hanaconfig Program

DescriptionMandatoryValueOption Name

SLD Host nameyesHost namesld_host

SLD Port[80,443,1024..65535]yesPort numbersld_port

2012-04-3048


DescriptionMandatoryValueOption Name

SLDUsername (Admin-istrator role)yesUser namesld_user

SLD PasswordyesPasswordsld_password

Use https instead ofhttp connectionno-sld_use_https

2.3.8 Accessing the SAP HANA Studio p2 Repository

The Software Update Manager (SUM) for SAP HANA server also hosts the p2 update site for the SAPHANA 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>:8443/studio_repository

Related Topics• Configuring the Software Update Manager for SAP HANA

2.3.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 SAPHANA host is rebooted.

If required, you can change this configuration by modifying the profile of the SAP HANA database asfollows: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 <SAPSID>_HDB<Instance_No>_<host_name>.4. Change the parameter setting Autostart = 0 to Autostart = 1 .5. Save the profile <SAPSID>_HDB<Instance_No>_<host_name>.

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

2012-04-3049



2.3.10 Applying Updates and Support Packages

Prerequisite:

You have configured the SUM for SAP HANA as described in Configuring the Software Update Managerfor SAP HANA

Procedure:

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

2.3.11 Monitoring the SAP HANA System Landscape

Install and configure the required monitoring tools:• SAPHANA studio for monitoring the SAPHANA database - see SAPHANADatabase Administration

Guide

• SAP NetWeaver monitoring tools (for example, SMD Agent)

• Monitoring tools of other SAP HANA components (for example SAP BusinessObjects monitoringtools)

Note:For more information, see SAPHANA Technical Operations Manual, section Monitoring the SAPHANASystem Lanscape.

2012-04-3050





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

Installing Trigger-Based Replication

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

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

2012-04-3051



2012-04-3052


Installing the SAP HANA Direct Extractor Connection(DXC)

For information about SAP HANA installation and configuration for the log-based replication, see theSAP HANA Installation and Configuration Guide ETL-based Data Acquisition by SAP HANA DirectExtractor Connection.

2012-04-3053

Installing the SAP HANA Direct Extractor Connection (DXC)



2012-04-3054

Installing the SAP HANA Direct Extractor Connection (DXC)

Installing ETL-Based Replication

In the log-based replication scenario, the ERP system is the data provider for SAP HANA, and this datacan be analyzed by means of MS EXCEL as end user client on top.

In addition to these SAP HANA components, the customer can add existing SAP BusinessObjectsproducts to the SAP HANA landscape. The information below provides a list of the availabledocumentation to integrate SAP BusinessObjects Data Services to your SAP HANA landscape.

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

If you are not using BusinessObjects Enterprise with SAP BusinessObjects Data Services, you needinformation platform services installed together with SAP BusinessObjects Data Services. You can findthe necessary installation and upgrade information in the following guides:• Information Platform Services Installation Guide for UNIX• Information Platform Services Installation Guide for Windows• Data Services Installation Guide for UNIX• Data Services Installation Guide for Windows• Data Services Upgrade Guide

2012-04-3055







2012-04-3056


Log-Based Replication

For information about SAP HANA installation and configuration for the log-based replication, see theSAP HANA Installation and Configuration Guide - Log-Based Replication.

2012-04-3057



2012-04-3058


hana_sps4_inst_en.pdf

Documents

Transcript of hana_sps4_inst_en.pdf