Sunteți pe pagina 1din 66

PUBLIC

SAP HANA Platform SPS 10


Document Version: 1.0 2015-06-24

SAP HANA Smart Data Streaming:


Installation Guide
Content

1 SAP HANA Smart Data Streaming Installation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4


1.1 SAP HANA Smart Data Streaming Software Download. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2 SAP HANA Smart Data Streaming Licenses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 When To Use This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3 SAP HANA System Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8


3.1 SAP HANA System Concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.2 SAP HANA System Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.3 Recommended File System Layout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10

4 SAP HANA Smart Data Streaming Installation Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13


4.1 SAP HANA Smart Data Streaming Hardware and Software Requirements. . . . . . . . . . . . . . . . . . . . 13
4.2 Preparing to Install SAP HANA Smart Data Streaming. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Shared File System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Extract Packages to the Default Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Extract Packages to a Custom Directory Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Starting the Installer When Using a Custom Directory Structure. . . . . . . . . . . . . . . . . . . . . . . . . 17

5 Installing SAP HANA Smart Data Streaming. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18


5.1 Installing the Streaming Server Package using LCM Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Installing with the Graphical Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Installing with the Command Line Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
5.2 Adding a Smart Data Streaming Host using LCM Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Add a Smart Data Streaming Host Using hdblcmgui. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Add a Smart Data Streaming Host Using hdblcm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Remove a Smart Data Streaming Host. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
5.3 Enabling the Streaming Client Package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
Register an ODBC Driver to Connect to Smart Data Streaming on Windows. . . . . . . . . . . . . . . . 37
5.4 Installing the Streaming Studio Plugin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Installing Smart Data Streaming using the SAP HANA Studio Installer. . . . . . . . . . . . . . . . . . . . 39
Installing Smart Data Streaming Manually in the SAP HANA Studio. . . . . . . . . . . . . . . . . . . . . . 39

6 SAP HANA Smart Data Streaming Installed Elements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

7 Verify the Streaming Version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

8 Verify That the Streaming Service is Running. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

9 Post Installation Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


2 2015 SAP SE or an SAP affiliate company. All rights reserved. Content
10 Updating SAP HANA Smart Data Streaming. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
10.1 Pre Update Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
10.2 Update SAP HANA and Smart Data Streaming Using hdblcmgui. . . . . . . . . . . . . . . . . . . . . . . . . . . 46
10.3 Update SAP HANA and Smart Data Streaming Using hdblcm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
10.4 Update SAP HANA Smart Data Streaming Using hdblcmgui. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
10.5 Update SAP HANA Smart Data Streaming Using hdblcm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
10.6 Post Update Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

11 Stop or Start the Streaming Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53


11.1 Auto-Restart the Streaming Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Stop-Restart Using SAP HANA cockpit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Stop-Restart Using SAP HANA studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
11.2 Stop the Streaming Service Manually. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
11.3 Start the Streaming Service Manually. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55

12 Uninstalling SAP HANA Smart Data Streaming. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56


12.1 Uninstall SAP HANA Smart Data Streaming Using hdblcmgui. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
12.2 Uninstall SAP HANA Smart Data Streaming Using hdblcm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

13 Installing the Streaming Lite Specialized Component. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

14 Troubleshooting Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61


14.1 Data_streaming Directory Already Exists During Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
14.2 Uninstallation of SAP HANA Database Fails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
14.3 Installing the Streaming Host on the SAP HANA Master Host Fails. . . . . . . . . . . . . . . . . . . . . . . . . 62

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Content 2015 SAP SE or an SAP affiliate company. All rights reserved. 3
1 SAP HANA Smart Data Streaming
Installation Overview

SAP HANA smart data streaming is installed as an option within an SAP HANA installation.

With smart data streaming, you can analyze events as they are streamed, enabling immediate response to
new information. SAP HANA smart data streaming provides the ability to process streams of incoming events
in real-time, as fast as they arrive. Raw data can be filtered and normalized before capturing the desired data
in the SAP HANA database. Complex event processing logic can be applied to monitor the incoming data,
generating alerts and notifications or initiating an immediate automatic response when specific conditions
are detected. Adapters and programming interfaces are available to connect streaming projects to data
sources and destinations.

Both the SAP HANA server and the SAP HANA client are required to use smart data streaming (unless you
have another system that already has the ability to connect to a smart data streaming server, in which case
the SAP HANA client is not required). The SAP HANA server and the smart data streaming server must be
installed on separate dedicated hosts in a production environment.

SAP HANA and SAP HANA smart data streaming are delivered on separate installation media.

SAP HANA smart data streaming has three installation packages:

The streaming server package, which contains the smart data streaming server and all of the tools to
administer the server, including adapters and the streaming command line tools. When you install this
package, you should also add a smart data streaming host for each streaming node.
The streaming client package, which contains the provided adapters for connecting to other data sources,
the SDK, and the streaming command line tools.
The streaming studio plugin package, which contains the smart data streaming plugin to the SAP HANA
studio that allows for visual development of streaming projects.

Follow this guide to install the streaming server package. Depending on your installation scenario, this involves
installing SAP HANA server, SAP HANA client and smart data streaming, or installing smart data streaming on
an existing system. After installing the streaming server package, add one smart data streaming host per
streaming node. You can then install the streaming client package and streaming studio package.

1.1 SAP HANA Smart Data Streaming Software Download

The SAP HANA smart data streaming installation and update packages are available as individual packages on
the SAP Software Download Center (https://support.sap.com/software.html).

Installation of SAP HANA smart data streaming requires SAP HANA SPS09 or later. Application of support
packages or revisions of SAP HANA require an equivalent update to SAP HANA smart data streaming. The
lifecycle manager checks to ensure you have the correct version of SAP HANA for your current version of SAP
HANA smart data streaming.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


4 2015 SAP SE or an SAP affiliate company. All rights reserved. SAP HANA Smart Data Streaming Installation Overview
Installation media for an SAP HANA SPS:
SAP Software Download Center Installations and Upgrades A-Z Index Installations and
Upgrades - H SAP In-Memory (SAP HANA) HANA Platform Edition SAP HANA PLATFORM
EDITION SAP HANA PLATFORM EDIT. 1.0 Installation
Support Packages and Patches for SAP HANA:
SAP Software Download Center Support Packages and Patches A-Z Index Support Packages
and Patches - H SAP HANA PLATFORM EDITION SAP HANA PLATFORM EDIT. 1.0
Installation media for SAP HANA smart data streaming:
SAP Software Download Center Installations and Upgrades A-Z Index Installations and
Upgrades - H SAP In-Memory (SAP HANA) HANA Platform Edition SAP HANA SMART DATA
STREAMING SAP HANA SMART DATA STREAM 1.0 Comprised Software Component Versions
Support Packages and Patches for SAP HANA smart data streaming:
SAP Software Download Center Support Packages and Patches A-Z Index Support Packages
and Patches - H SAP HANA SMART DATA STREAMING SAP HANA SMART DATA STREAM 1.0
Comprised Software Component Versions

Related Information

SAP Software Download Center

1.2 SAP HANA Smart Data Streaming Licenses

SAP HANA smart data streaming requires its own license, separate from the SAP HANA license.

You need only one SAP HANA smart data streaming license per installation of smart data streaming,
regardless of the number of streaming hosts within the single SAP HANA system. However, the total CPU core
count of all streaming hosts must not exceed the number of cores licensed.

You can download all licenses from SAP Service Marketplace.

Consistent with SAP HANA, a new installation of SAP HANA smart data streaming includes a temporary
license which allows streaming to run without a permanent license for a period of 90 days, after which time a
permanent license is required. If an installed permanent license expires, a temporary license is issued, valid for
28 days. If a temporary license expires without a permanent license being installed, SAP HANA smart data
streaming ceases to function until you install a valid permanent license.

For more information on license types, checking the current license key, and installing or deleting a permanent
license, see System Administration>Managing SAP HANA Licenses in the SAP HANA Administration Guide.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


SAP HANA Smart Data Streaming Installation Overview 2015 SAP SE or an SAP affiliate company. All rights reserved. 5
Related Information

SAP HANA Administration Guide

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


6 2015 SAP SE or an SAP affiliate company. All rights reserved. SAP HANA Smart Data Streaming Installation Overview
2 When To Use This Guide

You can install SAP HANA smart data streaming during installation of a new SAP HANA system or you can add
it to an existing SAP HANA system, SPS 09 or later.

The concepts and tasks presented in this guide focus on the installation and update of SAP HANA smart data
streaming. Since this may include the installation of a new SAP HANA system, some related information is
included, but is limited in scope to a basic configuration scenario of one SAP HANA host and one SAP HANA
smart data streaming host.

Before attempting a new installation of SAP HANA with SAP HANA smart data streaming, review the SAP
HANA Master Guide and SAP HANA Installation and Update Guide to ensure a complete understanding of the
installation requirements of an SAP HANA system, and the design of a core HANA system. After you complete
the installation, see the SAP HANA core documentation to configure your new system.

For complex SAP HANA installations involving multiple SAP HANA hosts with SAP HANA smart data
streaming, use the SAP HANA Server Installation and Update Guide to install and configure the SAP HANA
system, then use the SAP HANA Smart Data Streaming: Installation Guide to add SAP HANA smart data
streaming to the existing system.

Installation of SAP HANA smart data streaming requires an SAP HANA system SPS 09 or later. For SAP HANA
systems earlier than SPS 09, use the SAP HANA Server Installation and Update Guide to update your system
to SPS09 or later, and then use the SAP HANA Smart Data Streaming: Installation Guide to add SAP HANA
smart data streaming.

You can update SAP HANA and smart data streaming at the same time or individually. Before updating an SAP
HANA system, review the SAP HANA Server Installation and Upgrade Guide to ensure a complete
understanding of the SAP HANA core system update requirements.

You can install and update multiple SAP HANA options during a single installation. Installation and update
requirements and steps may vary by SAP HANA option. Refer to the option-specific installation guide for
details before installing or updating multiple options at once.

Related Information

SAP HANA Server Installation and Update Guide


SAP HANA Master Guide

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


When To Use This Guide 2015 SAP SE or an SAP affiliate company. All rights reserved. 7
3 SAP HANA System Overview

An installed SAP HANA system is required to install SAP HANA smart data streaming.

The concepts and tasks presented in this guide focus on installing SAP HANA smart data streaming. If you are
installing the SAP HANA server and client with SAP HANA smart data streaming as a new system, there are
key SAP HANA system concepts you should be familiar with before proceeding.

3.1 SAP HANA System Concepts

An SAP HANA system is composed of three main components: the host, the system, and the instance.

Host
A host is the operating environment in which the SAP HANA database runs. The host provides all the
resources and services (CPU, memory, network, and operating system) that the SAP HANA database
requires. The host provides links to the installation directory, data directory, and log directory, or the storage
itself. The storage for an installation does not have to be on the host. For multiple-host systems, a shared
storage or a storage that is accessible on-demand from all hosts is required.

For more information about the restrictions that apply to host names in SAP systems, see SAP Note 611361 in
Related Information.

Instance (HDB)
An SAP HANA instance (HDB) is the smallest operational unit on a host. It is the set of SAP HANA system
components that are installed on one host. A single-host system contains one instance on the one host. A
multiple-host system contains several instances distributed across the multiple hosts (one per host). Every
system has an instance number, which is a two-digit identifier. Each instance in a multiple-host system must
have the same instance number.

System
A system is one or more instances with the same number. The term "system" is interchangeable with the term
"SAP HANA database". If a system has more than one instance, they must be dispersed over several hosts as
a multiple-host system. Every system has a unique SAP system ID (SID).

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


8 2015 SAP SE or an SAP affiliate company. All rights reserved. SAP HANA System Overview
Related Information

SAP Note 611361 - Hostnames of SAP Servers

3.2 SAP HANA System Types

An SAP HANA system can be configured as a single-host or multiple-host system using the SAP HANA
database lifecycle manager.

The SAP HANA system type definitions are as follows:

Single-host system - One SAP HANA instance on one host.


Multiple-host (distributed) system - Multiple SAP HANA instances distributed over multiple hosts, with
one instance per host.

A single-host system is the simplest system installation type. It is possible to run an SAP HANA system
entirely on one host and then scale the system up as needed. The SAP HANA database lifecycle manager can
be used to install an SAP HANA single-host system in one of the program interfaces, and with a combination of
parameter specification methods.

The following graphic shows the file system for a single-host installation:

A multiple-host system is a system with more than one host, which can be configured as active worker hosts
or idle standby hosts. The SAP HANA database lifecycle manager can be used to install an SAP HANA
multiple-host system in one of the program interfaces, and with a combination of parameter specification

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


SAP HANA System Overview 2015 SAP SE or an SAP affiliate company. All rights reserved. 9
methods. To add hosts to an existing system, use the SAP HANA resident HDBLCM. For more information
about installing a multiple-host system, see the Related Information.

The following graphic shows the file system for a multiple-host system with three hosts:

The server software is based on a flexible architecture that enables a distributed installation. This means that
load can be balanced between different hosts. The server software has to be installed in a shared file system.
This file system has to be mounted by all hosts that are part of the system.

3.3 Recommended File System Layout

The SAP HANA database lifecycle manager (HDBLCM) requires certain file systems in order to successfully
install an SAP HANA system.

The file systems can be defined manually before installation and then specified during installation, or the
default file systems can be used. It is important that the file systems listed below are available and have the
recommended disk space before starting the SAP HANA database lifecycle manager.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


10 2015 SAP SE or an SAP affiliate company. All rights reserved. SAP HANA System Overview
Table 1: Default File Systems
File System Default Path Recommendations

Root /

Installation path /hana/shared/ The mount directory is used for shared files between all hosts in an SAP
(sapmnt) HANA system. This directory needs to be accessible to each of the servers
in the SAP HANA cluster.

Sub-directories:

/hana/shared/<SID> - Contains executable kernel programs


(exe), globally shared data (global), instance profiles (profile),
HDB executables (HDB<number>), and uninstallation script and
instruntime (hdblcm)
/hana/shared/<SID>/hdbclient - The SAP HANA client instal
lation path.
/hana/shared/<SID>/hdbstudio - The SAP HANA studio in
stallation path.
/hana/shared/<SID>/hdbstudio_update - The studio repo
sitory installation path. The studio repository is used to update the lo
cal SAP HANA studio installation.

System instance /usr/sap This is the path to the local SAP system instance directories.

Sub-directories:

/usr/sap/hostctrl - The SAP host agent directory.


/usr/sap/<SID> - Contains system executables (SYS) and the
home directory (home) of the <sid>adm user.

Data volume /hana/data/ The default path to the data directory depends on the system ID of the SAP
<SID> HANA host.

Log volume /hana/log/ The default path to the log directory depends on the system ID of the SAP
<SID> HANA host.

Smart Data Stream /hana/ The default path to the smart data streaming data directory depends on the
ing data volume data_streaming system ID of the SAP HANA host.
/<SID>*

*This file may use a shared file system like Network File System (NFS).

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


SAP HANA System Overview 2015 SAP SE or an SAP affiliate company. All rights reserved. 11
It is strongly recommended to use the SAP HANA file system layout shown in the figure below:

Note
An SAP HANA system in a production environment must not share any infrastructure with another SAP
HANA system.

Hosts running more than one SAP HANA system (sometimes referred to as multiple-SID installations) can
only be used for non-production purposes such as development, quality assurance, or testing.

For production systems with high availability, it is possible to share some temporarily unused resources
from the standby hosts. As soon as the standby resources are needed, they must become exclusively
available for the production system and no longer shared. For more details, refer to the high availability
information in the SAP HANA Administration Guide.

The file systems /hana/data/<SID> and /hana/log/<SID> may use shared file systems like NFS, or block
storage using the SAP HANA storage connector API with non-shared file systems.

The installation path (/hana/shared) is visible on all hosts. By default, the installation path is also used for
backup. However, backup directories should be manually configured, and must belong to a shared file system.
For more details, refer to the backup information in the SAP HANA Administration Guide.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


12 2015 SAP SE or an SAP affiliate company. All rights reserved. SAP HANA System Overview
4 SAP HANA Smart Data Streaming
Installation Planning

Before installing SAP HANA smart data streaming, become familiar with the basic system architecture in order
to optimize the installation and avoid unnecessary reconfiguration.

Both the SAP HANA server and the SAP HANA client are required in order to use smart data streaming (unless
you have another system that can connect to a smart data streaming server, in which case the SAP HANA
client is not required). An SAP HANA system with SAP HANA smart data streaming consists of at least one
SAP HANA host and one SAP HANA smart data streaming host.

SAP HANA smart data streaming and SAP HANA require separate dedicated hosts in a production
environment. SAP HANA smart data streaming can be installed on more than one host, with each host running
a single streaming node. All hosts in the SAP HANA system, including the SAP HANA smart data streaming
host(s), must have access to the HANA shared directory before installation begins.

Only one SAP HANA smart data streaming license is required per installation of smart data streaming,
regardless of the number of streaming hosts within the single SAP HANA system. However, the total CPU core
count of all streaming hosts must not exceed the number of cores licensed.

Currently, smart data streaming cannot be installed on an SAP HANA system that has been configured for
multitenant database containers.

4.1 SAP HANA Smart Data Streaming Hardware and


Software Requirements

The SAP HANA host and the host on which you install the smart data streaming server package must use the
same operating system.

The smart data streaming server must run on one of the following operating systems:

SUSE Linux Enterprise Server (SLES) 11.3 SPS3 or higher


Red Hat Enterprise Linux (RHEL) 6.5 or higher

SAP recommends that you set up an NTP server for the SAP HANA system landscape.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


SAP HANA Smart Data Streaming Installation Planning 2015 SAP SE or an SAP affiliate company. All rights reserved. 13
Note
Not having an NTP sever has system implications. For example, trace files from distributed hosts cannot be
displayed in the correct chronological order.

The smart data streaming client can be installed on a host running Linux, or Windows.

The smart data streaming studio plugin can be installed on a host running Linux, Windows, or MacOS.

Before you install the smart data streaming studio package, download and install the following Microsoft
Visual C++ 2010 Service Pack 1 Redistributable Package MFC Security Update (10.0.40219.325) or later:

http://www.microsoft.com/en-us/download/details.aspx?id=26999

After installing the redistributable package, run Microsoft Update to apply the latest security patches to
Microsoft Visual C++ 2010 Runtime. If you plan on running the smart data streaming Add-In for Microsoft
Excel, install the update for x86. If you are using the .NET 3.5 SDKs, install the following version of the Visual C
++ 2005 Service Pack 1 Redistributable Package (or newer):

http://www.microsoft.com/en-us/download/details.aspx?id=26347

There are no specific hardware requirements for smart data streaming. The specifications of smart data
streaming hosts do not need to match that of the SAP HANA host.

4.2 Preparing to Install SAP HANA Smart Data Streaming

Extract all installation packages before starting the installation.

Ensure that you meet all HANA distributed system requirements. See SAP HANA System Concepts in the SAP
HANA Server Installation and Update Guide.

You can extract the installation packages to the default directory structure (recommended), or to a custom
structure. The directory structure you use determines the command required to start the SAP HANA installer.
Regardless of the directory structure used, the location of each extracted package must be accessible to both
the SAP HANA and SAP HANA smart data streaming hosts.

Related Information

SAP HANA Server Installation and Update Guide

4.2.1 Shared File System Requirements

A shared file system is required to install SAP HANA.

Designate one host as the file server. The file server hosts the shared file system.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


14 2015 SAP SE or an SAP affiliate company. All rights reserved. SAP HANA Smart Data Streaming Installation Planning
Designate all other hosts that need to access the file system as file server clients. The clients access the
shared file system on the file server.

If you are adding SAP HANA smart data streaming to an existing SAP HANA system, add the SAP HANA smart
data streaming host to the shared file system as a file server client.

For an SAP HANA system with SAP HANA smart data streaming, root level read, write, execute (rwx) shared
access to /hana and all subdirectories is required.

There are many ways to set up a shared network file system (NFS). Consult your operating system manual or
a system administrator for assistance.

Related Information

SAP HANA Server Installation and Update Guide


SAP Note 2099253 - Creating a Network File System (NFS) for an SAP HANA Installation

4.2.2 Extract Packages to the Default Structure

Download each package to the same folder and use the default directory structure during extraction.

Context

When you use the default structure, the SAP HANA installer automatically detects the downloaded packages,
and makes them available for installation. This eliminates the need to specify individual package locations
when you start the SAP HANA installer.

On the SAP Software Downloads Center, installation packages are available for download from Installations
and Upgrades or Support Packages and Patches. While the content of each package is the same in each
location, Installations and Upgrades provides the packages in a .zip format, and Support Packages and
Patches provides the packages in a .SAR format.

Procedure

1. In a shared location, create an initial folder; for example, /SAP_downloads/.


2. Download each installation package to this folder. Do not create a subfolder for each package.
Once downloaded, the folder should look similar to:

/SAP_downloads
/SAP_HANA_DATABASE_Linux_on_x86_64.SAR
/SAP_HANA_CLIENT_Linux_on_x86_64.SAR
/SAP_HANA_STREAMING_Linux_on_x86_64.SAR

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


SAP HANA Smart Data Streaming Installation Planning 2015 SAP SE or an SAP affiliate company. All rights reserved. 15
or

/SAP_downloads
/SAP_HANA_DATABASE_Linux_on_x86_64.tgz
/SAP_HANA_CLIENT_Linux_on_x86_64.tgz
/SAP_HANA_STREAMING_Linux_on_x86_64.tgz

3. Change to the download folder created in step 1, and extract the files to the current location. Use a third-
party tool to extract the .zip files. Use the SAP sapcar utility to extract the .SAR files.

sapcar xvf <SAR_file>

The extraction process places each package in a predefined subfolder. Do not change the name of these
subfolders, as the installer looks specifically for this structure. Once extracted, the folder structure should
look similar to:

/SAP_downloads
/SAP_HANA_DATABASE
/SAP_HANA_DATABASE_Linux_on_x86_64.SAR
/SAP_HANA_CLIENT
/SAP_HANA_CLIENT_Linux_on_x86_64.SAR
/SAP_HANA_STREAMING
/SAP_HANA_STREAMING_Linux_on_x86_64.SAR

or

/SAP_downloads
/SAP_HANA_DATABASE
/SAP_HANA_DATABASE_Linux_on_x86_64.tgz
/SAP_HANA_CLIENT
/SAP_HANA_CLIENT_Linux_on_x86_64.tgz
/SAP_HANA_STREAMING
/SAP_HANA_STREAMING_Linux_on_x86_64.tgz

4.2.3 Extract Packages to a Custom Directory Structure

Each download package need not reside on the same host. You can override the default package folder name
during extraction.

Context

When you use a custom directory structure, you must specify the location of each package when you start the
installer, for it to detect the package. See Starting the Installer When Using a Custom Directory Structure
[page 17].

On the SAP Software Downloads Center, installation packages are available for download from Installations
and Upgrades or Support Packages and Patches. While the content of each package is the same in each
location, Installations and Upgrades provides the packages in a .zip format, and Support Packages and
Patches provides the packages in a .SAR format.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


16 2015 SAP SE or an SAP affiliate company. All rights reserved. SAP HANA Smart Data Streaming Installation Planning
Procedure

1. On a share location, create a folder, and download an installation package to it.


2. Change to the download folder, and extract the files. Use a third-party tool to extract the .zip files. Use
the SAP sapcar utility to extract the .SAR files.

sapcar xvf <SAR_file>

3. At the prompt, enter a folder name or accept the default.


4. Repeat these steps to extract each downloaded package.

4.2.4 Starting the Installer When Using a Custom Directory


Structure

When you start the SAP HANA installer, you must specify the location of the extracted download packages
(SAR files).

When using a custom directory structure, you can extract each installation package to a common or a
separate structure. If extracted to a separate structure, use the component_dirs parameter to specify the
location of each package. If extracted to a common structure, use the component_root parameter to specify
the common path.

For example, to extract the SAP HANA server package to /downloads/HANA/SAP_HANA_DATABASE, the SAP
HANA client package to /downloads/HANA/SAP_HANA_CLIENT, and the SAP HANA smart data streaming
server package to /downloads/SAP_HANA_STREAMING, use the component_root parameter:

--component_root=/downloads

To extract the SAP HANA database package to /SAP_HANA/server, the SAP HANA client package to /
SAP_HANA/client, and the SAP HANA smart data streaming server package to /SAP_HANA_STREAMING,
use the component_dirs parameters:

--component_dirs=/SAP_HANA/server,SAP_HANA/client,/SAP_HANA_STREAMING

If you specify neither the component_dirs nor component_root parameters, the installer looks only in the
installer directory for the available components for installation.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


SAP HANA Smart Data Streaming Installation Planning 2015 SAP SE or an SAP affiliate company. All rights reserved. 17
5 Installing SAP HANA Smart Data
Streaming

SAP HANA smart data streaming is installed in three processes: installing the streaming server package (at
which time it is recommended that you also add the streaming host), downloading and extracting the
streaming client package (including the SDK), and installing the smart data streaming studio plugin for SAP
HANA studio.

Using the lifecycle management tools, you can install, update, or uninstall SAP HANA components and plugins
independently of each other. It is possible to perform installation and update tasks in interactive mode or
batch mode.

Either install the SAP HANA server and client packages first, or at the same time as the SAP HANA smart data
streaming server package. You cannot install SAP HANA smart data streaming without the SAP HANA server
and client. From SAP Software Download Center, download the SAP HANA smart data streaming installer
packages and extract them to the same directory as the SAP HANA installer. This way, the SAP HANA installer
can detect SAP HANA smart data streaming.

Note
The installer folder must be accessible for all users.

During installation, you are prompted to create a password. This password gives the streaming technical user
(SYS_STREAMING) administration functions such as granting and revoking privileges, as well as access to the
cluster configuration stored in the SAP HANA database.

5.1 Installing the Streaming Server Package using LCM


Tools

The SAP HANA platform lifecycle management tool set includes command line and graphical interface tools,
which you can use to install, update, or configure your SAP HANA system.

The SAP HANA platform lifecycle management tools are used by means of program interface type, program
interaction mode, and parameter entry mode. This guide only discusses graphical and command line
interfaces that use interactive mode. See Using the LCM Tools in the SAP HANA Installation and Update Guide
for details on using batch mode or parameter entry mode for installation.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


18 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing SAP HANA Smart Data Streaming
Note
Use either hdblcmgui or hdblcm to install the streaming server package.

Depending on your installation scenario, follow the installation procedure for either:

SAP HANA and smart data streaming, or;


Smart Data Streaming on an existing system.

After installing the streaming server package, use either the hdblcm or the hdblcmgui tool to add a smart
data streaming host (one for each streaming node). Then, install the streaming client package and the
streaming studio package, as desired.

Related Information

SAP HANA Server Installation and Update Guide (PDF)


SAP HANA Server Installation and Update Guide (HTML)

5.1.1 Installing with the Graphical Interface

If you use the hdblcmgui graphical interface to install the streaming server package, there is no need to also
use the hdblcm command line interface.

Depending on your installation scenario, follow the installation procedure for either:

SAP HANA and smart data streaming, or;


Smart Data Streaming on an existing system.

After installing the streaming server package, use either the hdblcm or the hdblcmgui tool to add a smart
data streaming host (one for each streaming node). Then, install the streaming client package and the
streaming studio package, as desired.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Installing SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 19
5.1.1.1 Install SAP HANA and Smart Data Streaming Using
hdblcmgui

Install SAP HANA and SAP HANA smart data streaming as a new system using hdblcmgui.

Prerequisites

You are logged in as the root user on the master SAP HANA host. Both the SAP HANA and smart data
streaming hosts have the same root user name and password.
The SAP HANA SPS 10 or later client and server and SAP HANA smart data streaming installation
packages are downloaded. All packages are of an equivalent support or revision level.
The SAP HANA client and server hosts and SAP HANA smart data streaming hosts have access to the
HANA shared resources.
The data_streaming directory does not already exist. See Data_streaming Already Exists When Installing
SAP HANA Smart Data Streaming under Troubleshooting Installation.
X Window System is running.

Context

Note
These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the installation.
Avoid specifying an installation path that contains symbolic links since it may prevent you from
renaming the SID at a later point.
Configuring SAP HANA and smart data streaming to run on the same host is not supported in a
production environment.

The <SID>adm user is created on each host of the SAP HANA landscape as part of the SAP HANA core
installation. The sapadm user is automatically created by the SAP Host Agent installer, which is called by the
HANA installer. When you add a host to the system, both users are automatically created on the added host.
The <SID>adm user must be the same on all hosts. Similarly, the password for the sapadm user must be the
same on all hosts.

Procedure

1. Change to the directory containing the SAP HANA installer. The suggested layout for the installer path is:

/downloads/
SAP_HANA_DATABASE/
server/
SAP_HANA_CLIENT/

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


20 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing SAP HANA Smart Data Streaming
client/
SAP_HANA_STREAMING/
streaming

2. Start the SAP HANA platform lifecycle management tool:

Table 2:
Package Syntax

Extraction Method

Default Directory Struc ./hdblcmgui


ture

Custom Directory Struc Common path, where <full_path> is the common path to both installation packages:
ture
./hdblcmgui --component_root=<full_path>

Separate paths, where:


<full_path_HANA> refers to the path to the SAP HANA installation package, and;
<full_path_option> refers to the smart data streaming installation package

./hdblcmgui --
component_dirs=<full_path_HANA>,<full_path_option>

3. On the Select Software Locations page, if the SAP HANA database and SAP HANA smart data streaming
components appear on the list, click Next; otherwise:
a. Click Add Component Location.
b. Type the path to the missing installation package and click OK. Repeat this step to add any additional
missing packages.
4. On the Select Activity page, select Install new system.
5. On the Select Components page, select SAP HANA smart data streaming.
6. On the Choose System Type page, do one of:

Table 3:
Option Action

Install the SAP HANA system with SAP HANA smart data Select Single-Host System. Skip to step 8 [page 22].
streaming.
Note
You can add smart data streaming hosts to the SAP
HANA system later if preferred.

Install the SAP HANA system with SAP HANA smart data Select Multiple-Host System.
streaming, and add the SAP HANA smart data streaming
host.

7. For a Multi-Host System:


a. Enter the root user password.
b. If prompted, enter the SAP host agent password.
c. Click the Add Host button and specify:

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Installing SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 21
Table 4:
Property Description

Hostname Fully qualified domain name of the streaming host.

Role streaming

d. Leave all other defaults as displayed and click OK.

8. On the Define System Properties page, enter an SAP HANA system ID. Select single_container for
Database Mode. Accept all other defaults.
9. On the Define Storage Properties and Define Certificate Properties pages, accept all defaults.
10. On the Define System Administrator page, enter a system administrator password; accept all other
defaults.
11. On the Define Database User page, enter a database user password.
12. If prompted, on the Define SAP Host Agent user, enter a host agent password.
13. On the Define Smart Data Streaming Properties page, enter the password for the Streaming Cluster
Manager (the password for the SYS_STREAMING user that is created during the installation of smart data
streaming). Accept all other defaults.
14. On the Review and Confirm page, review the installation parameters. Modify any properties, as needed.
Click Install to begin.

Next Steps

If you selected the Single-Host System option, the next step is to add the SAP HANA smart data streaming
host to the SAP HANA system.

Related Information

Add a Smart Data Streaming Host Using hdblcmgui [page 31]


Verify That the Streaming Service is Running [page 33]
Data_streaming Directory Already Exists When Installing SAP HANA Smart Data Streaming [page 61]

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


22 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing SAP HANA Smart Data Streaming
5.1.1.2 Install Smart Data Streaming on an Existing SAP
HANA System Using hdblcmgui

Install SAP HANA smart data streaming on an existing SAP HANA system using hdblcmgui.

Prerequisites

You are logged in as the root user on the master SAP HANA host. Both the SAP HANA and smart data
streaming hosts have the same root user name and password.
The existing SAP HANA system is SPS 10 or later.
The SAP HANA smart data streaming installation package is downloaded, and is of an equivalent support
or revision level as the SAP HANA core system.
The SAP HANA client and server hosts and SAP HANA smart data streaming hosts have access to the
HANA shared resources.
The data_streaming directory does not already exist. See Data_streaming Already Exists When Installing
SAP HANA Smart Data Streaming under Troubleshooting Installation.
X Window System is running.

Context

Note
These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the installation.

The <SID>adm user is created on each host of the SAP HANA landscape as part of the SAP HANA core
installation. The sapadm user is automatically created by the SAP Host Agent installer, which is called by the
HANA installer. When you add a host to the system, both users are automatically created on the added host.
The <SID>adm user must be the same on all hosts. Similarly, the password for the sapadm user must be the
same on all hosts.

Procedure

1. On the SAP HANA host, change to the resident hdblcm directory within the system ID folder. For
example, /hana/shared/AB1/hdblcm, where /hana/shared/ is the shared directory for the system
and AB1 is the system ID.
2. Start the SAP HANA platform lifecycle management tool:

./hdblcmgui --component_dirs=<full_path_option>

where <full_path_option> refers to the location of the smart data streaming installation package.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Installing SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 23
3. On the Select Activity page, select Install or Update Additional Components.
4. On the Select Software Locations page, if the SAP HANA smart data streaming component appears on the
list, click Next; otherwise:
a. Click Add Component Location.
b. Type the path to the smart data streaming installation package and click OK.
5. On the Select Components page, select Install SAP HANA smart data streaming.
6. On the Enter Additional Hosts Properties page, do one of:

Table 5:
Option Action

Install SAP HANA smart data streaming software only Click Next. Skip to step 8 [page 24].

Note
You can add smart data streaming hosts to the SAP
HANA system later if preferred.

Install SAP HANA smart data streaming software and add 1. Specify the root user password, and if prompted, the
SAP HANA smart data streaming hosts. SAP host agent password.
2. Select Add Host.

7. When adding a host:


a. Specify:

Table 6:
Property Description

Hostname Fully qualified domain name of the streaming host.

Role streaming

b. Leave all other defaults as displayed and click OK.

8. On the Define Upgrade Properties page, enter the system administrator and database user passwords.
9. On the Enter Inter-Service Communication Properties page, accept the default of global.
10. On the Define Smart Data Streaming Properties page, enter the password for the Streaming Cluster
Manager (the password for the SYS_STREAMING user that is created during the installation of smart data
streaming). Accept all other defaults.
11. On the Review & Confirm page, review the installation parameters. Modify as needed. Click Update to
begin.

Next Steps

If you did not add additional hosts during installation, the next step is to add the SAP HANA smart data
streaming host to the SAP HANA system.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


24 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing SAP HANA Smart Data Streaming
Related Information

Add a Smart Data Streaming Host Using hdblcm [page 33]


Verify That the Streaming Service is Running [page 43]
Data_streaming Directory Already Exists When Installing SAP HANA Smart Data Streaming [page 61]

5.1.2 Installing with the Command Line Interface

If you use the hdblcm command line interface to install the streaming server package, there is no need to also
use the hdblcmgui graphical interface.

Depending on your installation scenario, follow the installation procedure for either:

SAP HANA and smart data streaming, or;


Smart Data Streaming on an existing system.

After installing the streaming server package, use either the hdblcm or the hdblcmgui tool to add a smart
data streaming host (one for each streaming node). Then, install the streaming client package and the
streaming studio package, as desired.

5.1.2.1 Install SAP HANA and Smart Data Streaming Using


hdblcm

Install SAP HANA and SAP HANA smart data streaming as a new system using hdblcm.

Prerequisites

You are logged in as the root user on the master SAP HANA host. Both the SAP HANA and smart data
streaming hosts have the same root user name and password.
The SAP HANA SPS 10 or later client and server and SAP HANA smart data streaming installation
packages are downloaded. All packages are of an equivalent support or revision level.
The SAP HANA client and server hosts and SAP HANA smart data streaming hosts have access to the
HANA shared resources.
The data_streaming directory does not already exist. See Data_streaming Already Exists When Installing
SAP HANA Smart Data Streaming under Troubleshooting Installation.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Installing SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 25
Context

Note
These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the installation.
Avoid specifying an installation path that contains symbolic links since it may prevent you from
renaming the SID at a later point.

The <SID>adm user is created on each host of the SAP HANA landscape as part of the SAP HANA core
installation. The sapadm user is automatically created by the SAP Host Agent installer, which is called by the
HANA installer. When you add a host to the system, both users are automatically created on the added host.
The <SID>adm user must be the same on all hosts. Similarly, the password for the sapadm user must be the
same on all hosts.

Procedure

1. Navigate to the directory containing the SAP HANA installer. The suggested layout for the installer path is:

/downloads/
SAP_HANA_DATABASE/
server/
SAP_HANA_CLIENT/
client/
SAP_HANA_STREAMING/
streaming

2. Start the SAP HANA platform lifecycle management tool:

Table 7:
Package Extraction Syntax
Method

Default Directory Struc ./hdblcm


ture

Custom Directory Struc Common path, where <full_path> is the common path to both installation packages:
ture
./hdblcm --component_root=<full_path>

Separate paths, where:


<full_path_HANA> refers to the path to the SAP HANA installation package, and;
<full_path_option> refers to the smart data streaming installation package

./hdblcm --
component_dirs=<full_path_HANA>,<full_path_option>

3. At the Choose system prompt, select Install new system.


4. At the Select additional components for installation prompt, select All. This installs both SAP HANA and
smart data streaming.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


26 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing SAP HANA Smart Data Streaming
Note
If the SAP HANA and SAP HANA smart data streaming do not appear on the list, and you are using the
default directory structure, review the directory structure. If using a custom directory structure, review
the component_dirs or component_root parameters. Press Ctrl+C to cancel the installation, then
restart the installer using the corrected parameters.

5. Specify the SAP HANA system properties:

Table 8: SAP HANA Properties


Field Name Description

Installation Path Specifies the path to the SAP mount directory, which can be used as a
shared directory between multiple hosts. Do not install to /usr/sap.

Local Host Name Specifies the host name of the machine.

Add additional hosts to the system? Allows the addition of worker and standby hosts to the SAP HANA instal
lation.

Note
You can add smart data streaming hosts to the SAP HANA system
later if preferred.

Host names to add Specifies the fully qualified machine names of the smart
data streaming host.

Root User Name Specifies the root user for the SAP HANA system.

Root User Password If prompted, specifies the password of the root user.

Select roles for host Select streaming.

SAP HANA System ID Specifies a system ID. The SAP system ID (SID) is the identifier for the
SAP HANA system.

Instance Number Specifies the instance number of the SAP HANA system. A valid in
stance number is between 00 - 98. 99 is reserved.

Database Mode Specifies whether the system is installed in single-container mode (de
fault) or multiple-container mode. A single-container system contains
one database but the system and the database are perceived as a single
unit. A multiple-container system contains one system database and any
number of tenant databases. The system database is created during the
installation process. A system administrator must create the required
tenant databases after installation. For general information about multi
ple-container systems, see Related Information.

System Usage Specifies the usage type of the system to be installed. This setting is
stored in the global.ini file, and can be used to identify the intended
usage of the system.

Location of Data Volumes Specifies the path to the data directory of the SAP HANA system.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Installing SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 27
Field Name Description

Location of Log Volumes Specifies the path to the log directory of the SAP HANA system.

Restrict maximum memory allocation? Specifies whether maximum memory allocation is restricted for a new
system.

Specifies the maximum memory allocation for a new system in MB.

Certificate Host Name Specifies the hostname used for generation of self-signed SSL certifi
cates for the SAP host agent.

System Administrator Home Directory Specifies the home directory of the system administrator. This parame
ter is relevant only if the operating system administrator (<sid>adm)
does not exist prior to installation.

System Administrator Login Shell Specifies the home directory of the system administrator. This parame
ter is relevant only if the operating system administrator (<sid>adm)
does not exist prior to installation.

System Administrator User ID Specifies the user ID of the system administrator. This parameter is rele
vant only if the operating system administrator (<sid>adm) does not
exist prior to installation.

System Administrator Timezone Specifies the timezone of the system administrator.

Database User (SYSTEM) Password Specifies the password of the database.

ID of User Group (sapsys) Specifies the SAP system (sapsys) group ID. This parameter is relevant
only if a sapsys group does not already exist on the host. If a sapsys
group already exists, passing the groupid parameter does not alter
the existing group.

Restart instance after machine reboot? Restarts instance after machine reboot.

Table 9: SAP HANA Smart Data Streaming Properties


Field Name Description

Streaming Cluster Manager Specifies the password for the SYS_STREAMING user which is created during
password the installation of smart data streaming.

Location of Streaming Logstores Specifies the location of the smart data streaming logstores and runtime in
and Runtime Information formation.

6. At the confirmation prompt, type y to begin.

Next Steps

If you did not add additional hosts during installation, the next step is to add the SAP HANA smart data
streaming host to the SAP HANA system.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


28 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing SAP HANA Smart Data Streaming
Related Information

Data_streaming Directory Already Exists When Installing SAP HANA Smart Data Streaming [page 61]

5.1.2.2 Install Smart Data Streaming on an Existing SAP


HANA System Using hdblcm

Install SAP HANA smart data streaming on an existing SAP HANA system using hdblcm.

Prerequisites

You are logged in as the root user on the master SAP HANA host. Both the SAP HANA and smart data
streaming hosts have the same root user name and password.
The existing SAP HANA system is SPS 10 or later.
The SAP HANA smart data streaming installation package is downloaded, and is of an equivalent support
or revision level as the SAP HANA core system.
The SAP HANA client and server hosts and SAP HANA smart data streaming hosts have access to the
HANA shared resources.
The data_streaming directory does not already exist. See Data_streaming Already Exists When Installing
SAP HANA Smart Data Streaming under Troubleshooting Installation.

Context

Note
These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the installation.

The <SID>adm user is created on each host of the SAP HANA landscape as part of the SAP HANA core
installation. The sapadm user is automatically created by the SAP Host Agent installer, which is called by the
HANA installer. When you add a host to the system, both users are automatically created on the added host.
The <SID>adm user must be the same on all hosts. Similarly, the password for the sapadm user must be the
same on all hosts.

Procedure

1. On the SAP HANA host, change to the resident hdblcm directory within the system ID folder. For
example, /hana/shared/AB1/hdblcm, where /hana/shared/ is the shared directory for the system
and AB1 is the system ID.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Installing SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 29
2. Start the SAP HANA platform lifecycle management tool:

./hdblcm --component_dirs=<full_path_option>

where <full_path_option> refers to the smart data streaming installation package.


3. At the Choose an action to perform prompt, select Install or Update Additional Components.
4. At the Choose components to be installed or updated prompt, select Install SAP HANA smart data
streaming.

Note
If SAP HANA smart data streaming does not appear on the list, review the component_dirs parameter.
Press Ctrl+C to cancel the installation, then restart the installer using the corrected component_dirs
parameter.

5. At the prompt to add additional host, do one of:

Table 10:
Option Action

Install SAP HANA smart data streaming only. Type N. Skip to step 7 [page 30].

Note
You can add smart data streaming hosts to the SAP
HANA system later if preferred.

Install SAP HANA smart data streaming and add the SAP Type Y.
HANA smart data streaming host.

6. If you selected Y, specify:

Table 11:
Field Name Field Name

Host names to add Specifies the fully qualified machine names of the smart
data streaming host.

Root User Name Specifies the root user for the SAP HANA system.

Root User Password If prompted, specifies the password of the root user.

Select roles for host Select streaming.

7. Specify:

Table 12:
Field Name Description

System Administrator Password Specifies the password of the system administrator


( <SID>adm).

Database User (SYSTEM) Password Specifies the password of the database.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


30 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing SAP HANA Smart Data Streaming
Field Name Description

Listen Interface Specifies the listening interface used by the SAP HANA
smart data streaming host. Select global.

Streaming Cluster Manager password Specifies the password for the SYS_STREAMING user
which is created during the installation of smart data
streaming.

Location of Streaming Logstores and Runtime Specifies the location of the smart data streaming log
Information stores and runtime information.

8. At the confirmation prompt, type y to begin.

Next Steps

If you did not add additional hosts during installation, the next step is to add the SAP HANA smart data
streaming host to the SAP HANA system.

Related Information

Data_streaming Directory Already Exists When Installing SAP HANA Smart Data Streaming [page 61]

5.2 Adding a Smart Data Streaming Host using LCM Tools

After installing smart data streaming with SAP HANA, or on an existing SAP HANA System, add a smart data
streaming host (one per streaming node).

Use either hdblcmgui or hdblcm to add the smart data streaming host. These procedures pertain only to
smart data streaming. Refer to the option-specific installation guide if including other SAP HANA options in the
installation.

5.2.1 Add a Smart Data Streaming Host Using hdblcmgui

Add a smart data streaming host to the SAP HANA system using hdblcmgui.

Prerequisites

You are logged in as the root user on the master SAP HANA host. Both the SAP HANA and smart data
streaming hosts have the same root user name and password.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Installing SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 31
The SAP HANA and smart data streaming hosts have access to the HANA shared resources.
X Window System is running.

Context

Note
These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the installation.
Configuring SAP HANA and smart data streaming to run on the same host is not supported in a
production environment.

The <SID>adm user is created on each host of the SAP HANA landscape as part of the SAP HANA core
installation. The sapadm user is automatically created by the SAP Host Agent installer, which is called by the
HANA installer. When you add a host to the system, both users are automatically created on the added host.
The <SID>adm user must be the same on all hosts. Similarly, the password for the sapadm user must be the
same on all hosts.

Procedure

1. On the SAP HANA host, change to the resident hdblcm directory within the system ID folder. For
example, /hana/shared/AB1/hdblcm, where /hana/shared/ is the shared directory for the system
and AB1 is the system ID.
2. Start the SAP HANA platform lifecycle management tool:

./hdblcmgui --addhosts=<smart_data_streaming_host>:role=streaming

3. On the Select Activity page, verify that the correct system ID to receive the host is displayed, then select
Add Additional Hosts to the SAP HANA System.
4. On the Enter Additional Hosts Properties page, specify the root user, SAP host agent user, and system
administrator passwords.
5. Click the Add Host button and specify:

Table 13:
Property Description

Hostname Fully qualified domain name for the smart data streaming
streaming host.

Role Select streaming.

6. Leave all other defaults as displayed and click OK.


7. On the Define Certificate Properties pages, accept all defaults.
8. On the Enter Inter-Service Communication Properties page, accept the default of global.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


32 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing SAP HANA Smart Data Streaming
9. On the Review & Confirm page, review the installation parameters. Modify any properties, as needed. Click
Add Hosts to begin.

Related Information

Verify That the Streaming Service is Running [page 33]


Data_streaming Directory Already Exists When Installing SAP HANA Smart Data Streaming [page 61]

5.2.2 Add a Smart Data Streaming Host Using hdblcm

Add a SAP HANA smart data streaming host to the SAP HANA system using hdblcm.

Prerequisites

You are logged in as the root user on the master SAP HANA host. Both the SAP HANA and smart data
streaming hosts have the same root user name and password.
The SAP HANA and smart data streaming hosts have access to the HANA shared resources.

Context

Note
These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the installation.
Configuring SAP HANA and smart data streaming to run on the same host is not supported in a
production environment.

Follow this procedure to add a smart data streaming host. If you choose, you can instead add the streaming
host by running /hana/shared/<SID>/hdblcm/hdblcm locally.

The <SID>adm user is created on each host of the SAP HANA landscape as part of the SAP HANA core
installation. The sapadm user is automatically created by the SAP Host Agent installer, which is called by the
HANA installer. When you add a host to the system, both users are automatically created on the added host.
The <SID>adm user must be the same on all hosts. Similarly, the password for the sapadm user must be the
same on all hosts.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Installing SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 33
Procedure

1. On the SAP HANA host, change to the resident hdblcm directory within the system ID folder. For
example, /hana/shared/AB1/hdblcm, where /hana/shared/ is the shared directory for the system
and AB1 is the system ID.
2. Start the SAP HANA platform lifecycle management tool:

./hdblcm --addhosts=<streaming_host>:role=streaming

Note
The host name must be a fully qualified domain name for the smart data streaming host.

3. At the prompt to choose an action, select Add Additional Hosts to the SAP HANA System.
4. Enter the root user name, or accept the default value.
5. If you are prompted for the Listener Interface, select global.
6. Enter the system administrator password, then accept the Certificate Host name.
7. At the confirmation prompt, type y to begin.

Related Information

Verify That the Streaming Service is Running [page 33]


Data_streaming Directory Already Exists When Installing SAP HANA Smart Data Streaming [page 61]

5.2.3 Remove a Smart Data Streaming Host

If you need to remove a smart data streaming host, you can use either hdblcm or hdblcmgui.

These procedures pertain only to smart data streaming. To remove an SAP HANA host, refer to the SAP HANA
Installation Guide for prerequisite tasks before continuing.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


34 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing SAP HANA Smart Data Streaming
5.2.3.1 Remove a Smart Data Streaming Host Using
hdblcmgui

Remove a smart data streaming host from the SAP HANA system using hdblcmgui.

Prerequisites

You are logged in as the root user on the master SAP HANA host. Both the SAP HANA and smart data
streaming hosts have the same root user name and password.
X Window System is running.

Context

Note
These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the installation.

Procedure

1. On the SAP HANA host, change to the resident hdblcm directory within the system ID folder. For
example, /hana/shared/AB1/hdblcm, where /hana/shared/ is the shared directory for the system
and AB1 is the system ID.
2. Start the SAP HANA platform lifecycle management tool:

./hdblcmgui

3. On the Select Activity page, verify that the correct system ID to remove the host from is displayed and
select Remove Hosts from the SAP HANA System.
4. On the Select Hosts page, select the host to remove. Accept the defaults to remove the user and home
directory of the system administrator from the host.
5. On the Enter Hosts Password page, type the root user password.
6. On the Review & Confirm page, review the installation parameters. Modify any properties, as needed. Click
Remove Hosts to begin.

Related Information

SAP HANA Server Installation and Update Guide

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Installing SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 35
5.2.3.2 Remove a Smart Data Streaming Host Using
hdblcm

Remove a SAP HANA smart data streaming host from the SAP HANA system using hdblcm.

Prerequisites

You are logged in as the root user on the master SAP HANA host. Both the SAP HANA and smart data
streaming hosts have the same root user name and password.

Context

Note
These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the installation.

Procedure

1. On the SAP HANA host, change to the resident hdblcm directory within the system ID folder. For
example, /hana/shared/AB1/hdblcm, where /hana/shared/ is the shared directory for the system
and AB1 is the system ID.
2. Start the SAP HANA platform lifecycle management tool:

./hdblcm

3. At the prompt to select an action, select Remove Hosts from the SAP HANA System.
4. Select the host name to remove.
5. Enter the root user name, or accept the default value.
6. Accept the defaults on all other prompts.
7. At the confirmation prompt to remove the specified host, type y.

Related Information

SAP HANA Server Installation and Update Guide

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


36 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing SAP HANA Smart Data Streaming
5.3 Enabling the Streaming Client Package

After you add the smart data streaming server and streaming host(s), you can download and extract the
streaming client package. The streaming client is necessary if you are creating an external tool (using the
SDK), monitoring the smart data streaming server, administering the server, and adding or stopping
streaming projects through command line tools.

Prerequisites

Install SAP HANA.

Procedure

1. Create a directory on your local disk for preparing the streaming client installer package.

Note
The directory path name cannot contain any spaces. When you double-click on the self-extracting
installer package, the file automatically extracts in the directory you are in. If that directory contains a
space anywhere in its path, the file does not extract correctly.

2. Download the streaming client package, and extract it to the local directory you created.
3. Set the STREAMING_HOME environment variable to the local directory.

5.3.1 Register an ODBC Driver to Connect to Smart Data


Streaming on Windows

If you install the smart data streaming client package on Windows, or want to connect to smart data streaming
via ODBC from a machine where smart data streaming is not installed, register the ODBC driver.

Context

Any Windows application that connects to smart data streaming through ODBC must run on a machine where
this ODBC driver is installed.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Installing SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 37
Procedure

1. If smart data streaming is not installed on the machine, copy the %STREAMING_HOME%/odbc (Windows) or
$STREAMING_HOME/odbc (Linux) folder to a local directory.
2. Identify the script to use, depending on the version of Windows on your system:

If your system uses a 64-bit version of Windows, use streaming_odbc_win64.reg to install both
the 32-bit and 64-bit ODBC drivers.
If your system uses a 32-bit version of Windows, use streaming_odbc_win32.reg to install the 32-
bit ODBC driver.
3. Change the paths for the Driver and Setup registry values by replacing C:\\SAP\\Streaming with the
absolute path of the local directory where you extracted the smart data streaming client package.
Ensure that any \ in the path are escaped with \\.
4. Run the script by double-clicking it, or by typing start and the script name from the command line.

Note
The driver does not work if you run the wrong script.

5. If you are prompted, allow the Registry Editor to make changes.


6. At the warning dialog, click OK.

7. After the script is run, view the streaming ODBC driver in Control Panel ODBC Data Sources .

Note
On 64-bit editions of Windows, if you launch the ODBC Data Source Administrator from Control
Panel Administrative Tools , this defaults to the 32-bit version of odbcad32.exe located in
%windir%\System32, which can only be used to manage data sources for 32-bit ODBC drivers. To
manage data sources for 64-bit ODBC drivers, run the odbcad32.exe file located in %windir%
\SysWOW64.

5.4 Installing the Streaming Studio Plugin


SAP recommends that you install the smart data streaming studio plugin using the SAP HANA studio installer.
However, you can also install it manually, if necessary.

Prior to installing the smart data streaming studio plugin, download and install the following Microsoft Visual C
++ 2010 Service Pack 1 Redistributable Package MFC Security Update (10.0.40219.325) or later:

http://www.microsoft.com/en-us/download/details.aspx?id=26999

When you have installed the redistributable package, run Microsoft Update to apply the latest security patches
to Microsoft Visual C++ 2010 Runtime. If you plan on running the smart data streaming Add-In for Microsoft
Excel, also install the update for x86. If you are using the .NET 3.5 SDKs, install the following version of the
Visual C++ 2005 Service Pack 1 Redistributable Package (or newer):

http://www.microsoft.com/en-us/download/details.aspx?id=26347

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


38 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing SAP HANA Smart Data Streaming
5.4.1 Installing Smart Data Streaming using the SAP HANA
Studio Installer

After you add the smart data streaming server and streaming host(s), you can install the streaming plugin for
the SAP HANA studio to use visual authoring tools, debugging functionality, and other SAP HANA studio tools
for smart data streaming.

Procedure

1. Create a directory on your local disk to prepare the streaming studio installer package.

Note
The directory path name cannot contain any spaces. When you double-click on the self-extracting
installer package, the file automatically extracts in the directory you are in. If that directory contains a
space anywhere in its path, the file does not extract correctly.

2. Download the SAP HANA studio installer into the local directory.
3. Download the streaming studio installer package, and extract it to the local directory created.
You should have these two directories in your local directory:
SAP_HANA_STUDIO
SAP_HANA_STREAMING
4. In the SAP_HANA_STUDIO directory, run hdbsetup.exe.
5. Choose the installation folder, then select the SAP HANA smart data streaming feature.

5.4.2 Installing Smart Data Streaming Manually in the SAP


HANA Studio

If you are installing into an existing SAP HANA studio installation, install the smart data streaming plugin for
the SAP HANA studio manually.

Prerequisites

SAP HANA studio is installed.

For more information see SAP HANA Studio Installation and Update Guide.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Installing SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 39
Procedure

1. Create a directory on your local disk for preparing the streaming studio installer package.

Note
The directory path name cannot contain any spaces. When you double-click on the self-extracting
installer package, the file automatically extracts in the directory you are in. If that directory contains a
space anywhere in its path, the file does not extract correctly.

2. Download the streaming studio installer package, and extract it to the local directory you created.
3. Start SAP HANA studio.

Note
If SAP HANA studio has been installed in C:\Program Files on a Windows system, or in any Windows
location with elevated User Account Control (UAC), start HANA studio by right-clicking on the HANA
studio icon and selecting Run as Administrator.

4. From the SAP HANA studio main menu, select Help Install New Software .
5. In the Install dialog, click Add.
6. In the Add Repository dialog, click Local, select the SAP_HANA_STREAMING\repository directory, and
click OK.
7. In the Install dialog, click on the check box next to SAP HANA smart data streaming, then click Next.
8. Review the items to be installed, then click Next.
9. Review the license, accept the terms and conditions to continue, then click Finish.
10. For any security warning prompts, click OK.
11. When prompted to restart SAP HANA studio, click Yes.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


40 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing SAP HANA Smart Data Streaming
6 SAP HANA Smart Data Streaming
Installed Elements

Installing SAP HANA smart data streaming results in various elements being added.

Streaming server/cluster
Streaming plugin for the SAP HANA studio
Streaming tools
Streaming SDK
Open ClientTM SDK
Adapter toolkit
Non-licensable internal and external adapters
Web Service Provider
Streaming ODBC driver and ODBC driver manager
Streaming catalog for the SAP HANA cockpit
SAP HANA technical user SYS_STREAMING, with LICENSE ADMIN role

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


SAP HANA Smart Data Streaming Installed Elements 2015 SAP SE or an SAP affiliate company. All rights reserved. 41
7 Verify the Streaming Version

Verify that your installation of SAP HANA smart data streaming was successful by making sure the smart data
streaming version number displays correctly.

Procedure

1. Log on to the SAP HANA master host as the <SID>adm user.


2. Run the command:

streamingclusteradmin -version

The smart data streaming version number should display correctly.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


42 2015 SAP SE or an SAP affiliate company. All rights reserved. Verify the Streaming Version
8 Verify That the Streaming Service is
Running

Adding the SAP HANA smart data streaming host creates and starts the streaming service. You can verify this
by listing all services currently running.

Procedure

1. Log on to the SAP HANA smart data streaming host as the <SID>adm, where <SID> is the SAP HANA SID
in lowercase letters. For example, if the <SID> is "XY1", log in as "xy1adm".
2. Type:

HDB info

A list of services running appears. If hdbstreamingserver appears in a row in the info column, the smart
data streaming service is running. For example:

rh1adm 13151 13107 0.0 737604 34036 \hdbstreamingserver -


hdb:instance=01 -hdb:hostname=...

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Verify That the Streaming Service is Running 2015 SAP SE or an SAP affiliate company. All rights reserved. 43
9 Post Installation Tasks

After installing the smart data streaming server, adding one or more smart data streaming hosts, and
installing the smart data streaming client and studio packages, there are specific tasks you can perform in
order to ensure that specific aspects of smart data streaming are configured appropriately.

For details about these tasks, refer to the section Configuring Smart Data Streaming for the First Time in the
SAP HANA Smart Data Streaming: Configuration and Administration Guide.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


44 2015 SAP SE or an SAP affiliate company. All rights reserved. Post Installation Tasks
10 Updating SAP HANA Smart Data
Streaming

Use the SAP HANA platform lifecycle manager to update smart data streaming.

Application of support packages or revisions of SAP HANA require an equivalent update to SAP HANA smart
data streaming. The lifecycle manager checks to ensure you have the correct version of SAP HANA for your
current version of SAP HANA smart data streaming.

Note
As of SAP HANA Support Package Stack (SPS) 09, updating the SAP HANA system can be performed as
the system administrator user <SID>adm.

Ensure you complete all pre and post update tasks before proceeding.

Find update packages on the SAP Software Download Center (https://support.sap.com/software.html ):

Support Packages and Patches for SAP HANA smart data streaming:
SAP Software Download Center Support Packages and Patches A-Z Index Support Packages
and Patches - H SAP HANA SMART DATA STREAMING SAP HANA SMART DATA STREAM 1.0
Comprised Software Component Versions

10.1 Pre Update Tasks

Stop all SAP HANA smart data streaming services.

On every SAP HANA smart data streaming host being upgraded, log on as the <sid>adm user and issue the
HDB stop command to stop all streaming services.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Updating SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 45
10.2 Update SAP HANA and Smart Data Streaming Using
hdblcmgui

Update both SAP HANA and smart data streaming using hdblcmgui.

Prerequisites

You are logged on to the master SAP HANA host as either root user or <SID>adm.
The required support packages and revisions, of an equivalent support or revision level, are downloaded.
You have completed all pre smart data streaming update tasks.
You have performed a system backup.
You have met all applicable update requirements for updating an SAP HANA database, per the SAP HANA
Server Installation and Update Guide.
X Window System is running.

Context

Note
There is business downtime for your SAP HANA system during the update.

These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the update.

Procedure

1. Change to the directory containing the extracted SAP HANA installer support package or revision. For
example, /SAP_downloads/SAP_HANA_DATABASE if using the default directory structure.
2. Start the SAP HANA platform lifecycle management tool:

Table 14:
Package Extraction Start Syntax
Method

Default Directory Struc ./hdblcmgui


ture

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


46 2015 SAP SE or an SAP affiliate company. All rights reserved. Updating SAP HANA Smart Data Streaming
Package Extraction Start Syntax
Method

Custom Directory Struc Common path:


ture
./hdblcmgui --component_root=<full_path>

where <full_path> refers to the common path to both support packages.

Separate paths:

./hdblcmgui --
component_dirs=<full_path_HANA>,<full_path_option>

where <full_path_HANA> refers to the path to the SAP HANA support package and
<full_path_option> refers to the path to the smart data streaming support package.

3. On the Select Software Locations page, if the SAP HANA smart data streaming components being
updated appear on the list, click Next; otherwise:
a. Click Add Component Location.
b. Type the path to the missing update package and click OK. Repeat this step to add additional missing
packages.
4. On the Select Activity page, select Update existing system. Verify that the correct <SID> is specified.
Change if necessary.
5. On the Select Components page, select Update SAP HANA smart data streaming. Note that the SAP
HANA database and client components are not listed. They are automatically included as part of the
update process.
6. On the Define Upgrade Properties page, accept the database user name and enter the corresponding
password.
7. On the Review & Confirm page, review the installation parameters. Modify as needed. Click Update to
begin.

Next Steps

Perform post update tasks.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Updating SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 47
10.3 Update SAP HANA and Smart Data Streaming Using
hdblcm

Update both SAP HANA and smart data streaming using hdblcm.

Prerequisites

You are logged on to the master SAP HANA host as either root user or <SID>adm.
The required support packages and revisions, of an equivalent support or revision level, are downloaded.
You have completed all pre smart data streaming update tasks.
You have performed a system backup.
You have met all applicable update requirements for updating an SAP HANA database, per the SAP HANA
Server Installation and Update Guide.

Context

Note
There is business downtime for your SAP HANA system during the update.

These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the update.

Procedure

1. Change to the directory containing the extracted SAP HANA installer support package or revision. For
example, /SAP_downloads/SAP_HANA_DATABASE if using the default directory structure.
2. Start the SAP HANA platform lifecycle management tool:

Table 15:
Package Extraction Start Syntax
Method

Default Directory Struc ./hdblcm


ture

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


48 2015 SAP SE or an SAP affiliate company. All rights reserved. Updating SAP HANA Smart Data Streaming
Package Extraction Start Syntax
Method

Custom Directory Struc Common path:


ture
./hdblcm --component_root=<full_path>

where <full_path> refers to the common path to both support packages.

Separate paths:

./hdblcm --
component_dirs=<full_path_HANA>,<full_path_option>

where <full_path_HANA> refers to the path to the SAP HANA support package and
<full_path_option> refers to the path to the smart data streaming support package.

3. At the Choose system to update prompt, select the <SID> (update) for the system to be updated.
4. At the Choose components to be installed or updated prompt, press Enter to accept the default to update
all detected, updatable components, or select the components to update. Note that the SAP HANA
database and client components are not listed. They are automatically included as part of the update
process.

Note
If a component being updated does not appear on the list, and you are using the default directory
structure, review the location of the support package in the default directory structure. If you are using
a custom directory structure, review the path to the support package defined in the component_dirs or
component_root parameters.

5. Press Enter to accept the database user name, then enter the database user password.
6. At the confirmation prompt, type y to begin.

Next Steps

Perform post update tasks.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Updating SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 49
10.4 Update SAP HANA Smart Data Streaming Using
hdblcmgui

Update SAP HANA smart data streaming using hdblcmgui.

Prerequisites

Your SAP HANA system is already upgraded.


You have completed all pre smart data streaming update tasks.
The SAP HANA indexserver is running.
You are logged on to the master SAP HANA host as either root user or <SID>adm.
The required support packages and revisions, of an equivalent support or revision level, are downloaded.
You have performed a system backup.
X Window System is running.

Context

Note
There is business downtime for your SAP HANA system during the update.

These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the update.

Procedure

1. On the SAP HANA host, change to the resident hdblcm directory within the system ID folder. For
example, /hana/shared/AB1/hdblcm, where /hana/shared/ is the shared directory for the system
and AB1 is the system ID.
2. Start the SAP HANA platform lifecycle management tool:

./hdblcmgui --component_dirs=<full_path_option>

where <full_path_option> refers to the path to the smart data streaming support package.
3. On the Select Activity page, select Install or Update Additional Components.
4. On the Select Software Locations page, if the SAP HANA smart data streaming components being
updated appear on the list, click Next; otherwise:
a. Click Add Component Location.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


50 2015 SAP SE or an SAP affiliate company. All rights reserved. Updating SAP HANA Smart Data Streaming
b. Type the path to the missing update package and click OK. Repeat this step to add additional missing
packages.
5. On the Select Components page, select Update SAP HANA smart data streaming.
6. On the Define Upgrade Properties page, accept the database user name and enter the corresponding
password.
7. On the Review & Confirm page, review the installation parameters. Modify as needed. Click Update to
begin.

Next Steps

Perform post update tasks.

10.5 Update SAP HANA Smart Data Streaming Using


hdblcm

Update SAP HANA smart data streaming using hdblcm.

Prerequisites

Your SAP HANA system is already upgraded.


You have completed all pre smart data streaming update tasks.
The SAP HANA indexserver is running.
You are logged on to the master SAP HANA host as either root user or <SID>adm.
The required support packages and revisions, of an equivalent support or revision level, are downloaded.
You have performed a system backup.

Context

Note
There is business downtime for your SAP HANA system during the update.

These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the update.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Updating SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 51
Procedure

1. On the SAP HANA host, change to the resident hdblcm directory within the system ID folder. For
example, /hana/shared/AB1/hdblcm, where /hana/shared/ is the shared directory for the system
and AB1 is the system ID.
2. Start the SAP HANA platform lifecycle management tool:

./hdblcm --component_dirs=<full_path_option>

where <full_path_option> refers to the smart data streaming support package.


3. At the Choose an action to perform prompt, select Install or Update Additional Components.
4. At the Choose components to be installed or updated prompt, select Update SAP HANA Smart Data
Streaming.

Note
If SAP HANA smart data streaming does not appear on the list, review the component_dirs parameter.
Press Ctrl+C to cancel the installation, then restart the installer using the corrected component_dirs
parameter.

5. Press Enter to accept the database user name, then enter the database user password.
6. At the confirmation prompt, type y to begin.

Next Steps

Perform post update tasks.

10.6 Post Update Tasks

Start all SAP HANA smart data streaming services.

On every SAP HANA smart data streaming host just upgraded, log on as the <sid>adm user and issue the HDB
start command to start all streaming services.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


52 2015 SAP SE or an SAP affiliate company. All rights reserved. Updating SAP HANA Smart Data Streaming
11 Stop or Start the Streaming Service

Normally, the streaming service starts on its own. However, you can use specific tools to start or stop the
streaming service.

11.1 Auto-Restart the Streaming Service

Through the SAP HANA cockpit or the SAP HANA studio Administration Console, you can stop the streaming
service, and allow it to restart through the auto-restart mechanism.

Stop-Restart Using SAP HANA cockpit

Prerequisites

You have the sap.hana.admin.roles::Administrator role.

Context

Note
The SAP HANA auto-restart feature supports high availability. If an SAP HANA service is disabled by failure
or intentional intervention, this auto-restart function detects the failure and restarts the stopped service
process.

Procedure

1. In the SAP HANA cockpit, click the Database Status tile.


2. Highlight the hdbstreamingserver service and click Stop Service.
3. Click Yes to confirm. A success message appears.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Stop or Start the Streaming Service 2015 SAP SE or an SAP affiliate company. All rights reserved. 53
Stop-Restart Using SAP HANA studio

Prerequisites

You have the system privilege STREAMING ADMIN or SERVICE ADMIN.


You are logged on to the SAP HANA database in the Administration Console.

Context

Note
The SAP HANA auto-restart feature supports high availability. If an SAP HANA service is disabled by failure
or intentional intervention, this auto-restart function detects the failure and restarts the stopped service
process.

Procedure

1. In the SAP HANA studio Administration console, right click the database in the Systems panel, select
Configuration and Monitoring Open Administration , and select the Landscape tab.
2. Right-click the streaming service and choose the required option:

Option Description

Stop... The service is stopped normally and then typically restarted.

Kill... The service is stopped immediately and then typically restarted.

11.2 Stop the Streaming Service Manually

You can stop the streaming service and prevent a restart through the auto-restart mechanism.

Context

Once stopped, the streaming service can only be restarted manually.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


54 2015 SAP SE or an SAP affiliate company. All rights reserved. Stop or Start the Streaming Service
Procedure

1. First method:
a. Log on to the SAP HANA smart data streaming host as the <sid>adm user, where <sid> is the SAP
HANA SID in lowercase letters. For example, if the SID is "XY1", log in as "xy1adm".
b. Issue the command:

HDB stop

2. Second method:
a. Log on to any host in the landscape as the <sid>adm user.
b. Issue the command:

sapcontrol -nr <inst #> -function InstanceStop <streaming host> <inst #>

Where <inst #> is the SAP HANA instance number and <streaming host> is the name of the
smart data streaming host.

11.3 Start the Streaming Service Manually

If stopped, you can manually start the streaming service.

Procedure

1. First method:
a. Log on to the SAP HANA smart data streaming host as the <sid>adm user, where <sid> is the SAP
HANA SID in lowercase letters. For example, if the SID is "XY1", log in as "xy1adm".
b. Issue the command:

HDB start

2. Second method:
a. Log on to any host in the landscape as the <sid>adm user.
b. Issue the command:

sapcontrol -nr <inst #> -function InstanceStart <streaming host> <inst #>

Where <inst #> is the SAP HANA instance number and <streaming host> is the name of the
smart data streaming host.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Stop or Start the Streaming Service 2015 SAP SE or an SAP affiliate company. All rights reserved. 55
12 Uninstalling SAP HANA Smart Data
Streaming

To uninstall smart data streaming from your SAP HANA system, use either the graphical interface or the
command line interface.

For information about uninstalling the SAP HANA system, refer to the SAP HANA core documentation.

12.1 Uninstall SAP HANA Smart Data Streaming Using


hdblcmgui

Uninstall smart data streaming using hdblcmgui.

Prerequisites

You are logged in as the root user on the master SAP HANA host. Both the SAP HANA and smart data
streaming hosts have the same root user name and password.
X Window System is running.
The SAP HANA smart data streaming host has been removed.

Context

Note
These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the installation.

Procedure

1. On the SAP HANA host, change to the resident hdblcm directory within the system ID folder. For
example, /hana/shared/AB1/hdblcm, where /hana/shared/ is the shared directory for the system
and AB1 is the system ID.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


56 2015 SAP SE or an SAP affiliate company. All rights reserved. Uninstalling SAP HANA Smart Data Streaming
2. Start the SAP HANA platform lifecycle management tool:

./hdblcmgui

3. On the Select Activity page, select Uninstall SAP HANA components.

Tip
Use the System Description information to verify that you are uninstalling SAP HANA components from
the expected system ID.

4. On the Select Components page, select Uninstall separate components, then select Uninstall SAP
HANA smart data streaming.
5. On the Enter Uninstallation Credentials page, enter the database user password.
6. On the Review & Confirm page, review the uninstallation parameters. Modify as needed. Click Uninstall to
begin.

12.2 Uninstall SAP HANA Smart Data Streaming Using


hdblcm

Uninstall SAP HANA smart data streaming from the SAP HANA system using hdblcm.

Prerequisites

You are logged in as the root user on the master SAP HANA host. Both the SAP HANA and smart data
streaming hosts have the same root user name and password.
The SAP HANA smart data streaming host has been removed.

Context

Note
These steps pertain only to the SAP HANA smart data streaming option. Refer to the option-specific
installation guide if including other SAP HANA options in the installation.

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Uninstalling SAP HANA Smart Data Streaming 2015 SAP SE or an SAP affiliate company. All rights reserved. 57
Procedure

1. On the SAP HANA host, change to the resident hdblcm directory within the system ID folder. For
example, /hana/shared/AB1/hdblcm, where /hana/shared/ is the shared directory for the system
and AB1 is the system ID.
2. Start the SAP HANA platform lifecycle management tool:

./hdblcm

3. Select Uninstall SAP HANA components.


4. At the Choose components prompt, select Uninstall SAP HANA smart data streaming.
5. Accept the Database User Name and then enter the password
6. At the confirmation prompt, type y to begin the uninstallation.

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


58 2015 SAP SE or an SAP affiliate company. All rights reserved. Uninstalling SAP HANA Smart Data Streaming
13 Installing the Streaming Lite Specialized
Component

Streaming lite is a to-the-edge component designed to deploy streaming projects on remote gateway devices.
Streaming lite is optional and not required as part of a standard smart data streaming installation. The
streaming lite package is downloadable as a separate component only.

Context

As a separate component, streaming lite can run on the following platforms, independent of the platform on
which you are running SAP HANA smart data streaming:

Table 16:

Platform for Stream Product Build Envi Product Build Com Supported Operating Minimum Require
ing Lite ronment piler System ments

Linux -x86 64 bit RHEL 5.5 gcc 4.6.2 RHEL 5.5 to 5.10 512MB RAM, 1GB
HDD, 1 core CPU

Linux-ARM 32 bit (Ver SUSE SLES11 SP3 gcc (Crosstool- Raspbian 3.12.35 Raspberry-pi device A
NG Li + and above with de
sion ARMv6l or higher) (wheezy)
naro-1.13.1-4.8-20 fault configuration
14.01 - Linaro
GCC 2013.11)
4.8.3 20140106
(pre-release)
Libraries gcc
4.6.3

The streaming lite package is downloadable from SAP Service Marketplace as a tar ball only. You can
download the Linux and/or the ARM versions of the tar ball, provided that you have an SAP HANA smart data
streaming license for any platform.

Procedure

1. Obtain the streaming lite tar ball from SAP Service Marketplace.
2. Extract to an installation directory:
a. Create the lite.tar file.

gunzip lite.tzg
b. Extract and install streaming lite:

tar xf lite.tar

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Installing the Streaming Lite Specialized Component 2015 SAP SE or an SAP affiliate company. All rights reserved. 59
3. Export the STREAMING_HOME environment variable.

export STREAMING_HOME=<installation directory>

Streaming lite is now installed, and is ready to deploy your streaming project.

Next Steps

To verify this, you can start streaming lite by loading the streaming lite sample project:

bin/streamingproject --ccx examples/lite/sensorproject.ccx --command-port 9093

Streaming lite responds with the message:

Platform () ::run -- Server alive & ready for services

For an introduction to streaming lite, see Introduction to Streaming Lite in the SAP HANA Smart Data
Streaming: Master Guide. For more information on deploying the sample project or other streaming projects in
streaming lite, configuring PAM and SSL for streaming lite, and the Streaming Web Output Adapter, see the
Streaming Lite section of the SAP HANA Smart Data Streaming: Utilities Guide.

Related Information

SAP HANA Smart Data Streaming: Master Guide


SAP HANA Smart Data Streaming: Utilities Guide

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


60 2015 SAP SE or an SAP affiliate company. All rights reserved. Installing the Streaming Lite Specialized Component
14 Troubleshooting Installation

Troubleshoot problems that occur when installing SAP HANA smart data streaming

To find out about issues fixed in a specific revision, see the SAP Note for that revision on SAP Service
Marketplace.

Related Information

2130313 - SAP HANA Smart Data Streaming SPS 10 Release Note

14.1 Data_streaming Directory Already Exists During


Installation

Issue: If the data_streaming/<SID> directory, where <SID> is the system ID of the SAP HANA instance into
which you are installing smart data streaming, already exists when installing SAP HANA smart data streaming,
an error message appears and the installation fails.

The existence of the directory before beginning an installation may result in permission errors, or an error
message and installation failure.

Solution:

1. Delete the directory if it is empty.


2. Delete the directory if it contains a single, empty subdirectory. For example, for /hana/
data_streaming/ABC, ABC is empty.
3. If the subdirectory is not empty, ensure that the directory (example, /hana/data_streaming) is owned
by the root user and each subdirectory (example, /hana/data_streaming/ABC, /hana/
data_streaming/DEF) is owned by the <SID>adm of the system ID.

14.2 Uninstallation of SAP HANA Database Fails

Issue: Uninstallation of an SAP HANA database fails due to an inability to remove the host file system. If the
SAP HANA database has SAP HANA options installed, the error message may include references to
insufficient permissions or specific files or directories not being found.

An error message similar to the following appears:

Uninstalling host <hostname> Terminated

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Troubleshooting Installation 2015 SAP SE or an SAP affiliate company. All rights reserved. 61
This behavior occurs if .nfsXX files are detected during the uninstallation process.

Solution:

1. Log on to each worker and standby host in the SAP HANA system as the <SID>adm.
2. To stop the SAP HANA host service, execute:

HDB STOP

3. Repeat these steps on each of the installed worker and standby hosts.
4. Log on to the SAP HANA database host as the root user.
5. Manually remove the .nfsXX files.
To list the .nfsXX files, type:

find /hana/shared/<SID>/streaming -name .nfs\*

where <SID> is the HANA system ID.


Output example:

-rwxr-x--- 1 k9gadm sapsys 4890507 Oct 31 05:14 .nfs000000000724c09200000059


-rwxr-x--- 1 k9gadm sapsys 1679448 Oct 31 20:49 .nfs000000000724c0450000005a

If the .nfsXX files report permission errors while manually removing them, shutdown the NFS server
services before removing.
To stop the NFS server, execute:

/etc/init.d/nfsserver stop

To start the NFS server, execute:

/etc/init.d/nfsserver start.

NOTE: Please consult your operating system documentation or your system administrator for
assistance.
6. Rerun the SAP HANA platform lifecycle management tool to uninstall the SAP HANA database.

14.3 Installing the Streaming Host on the SAP HANA Master


Host Fails

Issue: Adding of the SAP HANA smart data streaming host on the SAP HANA master host, using the SAP
HANA platform lifecycle management tool, fails with a configuration error.

Installation of the SAP HANA smart data streaming host on the master SAP HANA host is only supported in a
non-productive or test environment. The SAP HANA platform lifecycle management tool cannot be used to
add the host for this configuration.

Solution:

Caution
Once you add the SAP HANA smart data streaming host to the SAP HANA master host, it cannot be
removed. Further, the smart data streaming host cannot exist when uninstalling SAP HANA smart data

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


62 2015 SAP SE or an SAP affiliate company. All rights reserved. Troubleshooting Installation
streaming. Therefore, once the smart data streaming host is added to the SAP HANA master host, the only
way to uninstall SAP HANA smart data streaming is to uninstall the SAP HANA system and all its
components.

1. Log on to the SAP HANA master host as root user.


2. Navigate to: /hana/shared/<SID>/global/hdb/install/bin
3. Execute:

./hdbmodify --add_local_roles=streaming --listen_interface=global

SAP HANA Smart Data Streaming: Installation Guide PUBLIC


Troubleshooting Installation 2015 SAP SE or an SAP affiliate company. All rights reserved. 63
Important Disclaimers and Legal Information

Coding Samples
Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system
environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and
completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, unless damages were caused by SAP
intentionally or by SAP's gross negligence.

Accessibility
The information contained in the SAP documentation represents SAP's current view of accessibility criteria as of the date of publication; it is in no way intended to be
a binding guideline on how to ensure accessibility of software products. SAP in particular disclaims any liability in relation to this document. This disclaimer, however,
does not apply in cases of wilful misconduct or gross negligence of SAP. Furthermore, this document does not result in any direct or indirect contractual obligations of
SAP.

Gender-Neutral Language
As far as possible, SAP documentation is gender neutral. Depending on the context, the reader is addressed directly with "you", or a gender-neutral noun (such as
"sales person" or "working days") is used. If when referring to members of both sexes, however, the third-person singular cannot be avoided or a gender-neutral noun
does not exist, SAP reserves the right to use the masculine form of the noun and pronoun. This is to ensure that the documentation remains comprehensible.

Internet Hyperlinks
The SAP documentation may contain hyperlinks to the Internet. These hyperlinks are intended to serve as a hint about where to find related information. SAP does
not warrant the availability and correctness of this related information or the ability of this information to serve a particular purpose. SAP shall not be liable for any
damages caused by the use of related information unless damages have been caused by SAP's gross negligence or willful misconduct. All links are categorized for
transparency (see: http://help.sap.com/disclaimer).

PUBLIC SAP HANA Smart Data Streaming: Installation Guide


64 2015 SAP SE or an SAP affiliate company. All rights reserved. Important Disclaimers and Legal Information
SAP HANA Smart Data Streaming: Installation Guide PUBLIC
Important Disclaimers and Legal Information 2015 SAP SE or an SAP affiliate company. All rights reserved. 65
www.sap.com/contactsap

2015 SAP SE or an SAP affiliate company. All rights reserved.


No part of this publication may be reproduced or transmitted in any
form or for any purpose without the express permission of SAP SE
or an SAP affiliate company. The information contained herein may
be changed without prior notice.
Some software products marketed by SAP SE and its distributors
contain proprietary software components of other software
vendors. National product specifications may vary.
These materials are provided by SAP SE or an SAP affiliate company
for informational purposes only, without representation or warranty
of any kind, and SAP or its affiliated companies shall not be liable for
errors or omissions with respect to the materials. The only
warranties for SAP or SAP affiliate company products and services
are those that are set forth in the express warranty statements
accompanying such products and services, if any. Nothing herein
should be construed as constituting an additional warranty.
SAP and other SAP products and services mentioned herein as well
as their respective logos are trademarks or registered trademarks
of SAP SE (or an SAP affiliate company) in Germany and other
countries. All other product and service names mentioned are the
trademarks of their respective companies.
Please see http://www.sap.com/corporate-en/legal/copyright/
index.epx for additional trademark information and notices.

S-ar putea să vă placă și