Streaming Installation Guide
Streaming Installation Guide
Streaming Installation Guide
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.
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.
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.
Related Information
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.
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.
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
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.
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).
An SAP HANA system can be configured as a single-host or multiple-host system using the SAP HANA
database lifecycle manager.
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
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.
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.
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:
System instance /usr/sap This is the path to the local SAP system instance directories.
Sub-directories:
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).
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.
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.
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:
SAP recommends that you set up an NTP server for the SAP HANA system landscape.
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.
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
Designate one host as the file server. The file server hosts the shared file system.
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
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
/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_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.
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
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.
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 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.
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.
Depending on your installation scenario, follow the installation procedure for either:
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
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:
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.
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/
Table 2:
Package Syntax
Extraction Method
Custom Directory Struc Common path, where <full_path> is the common path to both installation packages:
ture
./hdblcmgui --component_root=<full_path>
./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.
Role streaming
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
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.
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.
Table 6:
Property Description
Role streaming
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.
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:
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.
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.
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
Table 7:
Package Extraction Syntax
Method
Custom Directory Struc Common path, where <full_path> is the common path to both installation packages:
ture
./hdblcm --component_root=<full_path>
./hdblcm --
component_dirs=<full_path_HANA>,<full_path_option>
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.
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.
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.
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.
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.
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.
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.
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.
Data_streaming Directory Already Exists When Installing SAP HANA Smart Data Streaming [page 61]
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.
./hdblcm --component_dirs=<full_path_option>
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.
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.
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.
7. Specify:
Table 12:
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.
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]
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.
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.
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.
Related Information
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.
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
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.
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
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
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
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.
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.
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.
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.
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
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.
If you are installing into an existing SAP HANA studio installation, install the smart data streaming plugin for
the SAP HANA studio manually.
Prerequisites
For more information see SAP HANA Studio Installation and Update Guide.
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.
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
Verify that your installation of SAP HANA smart data streaming was successful by making sure the smart data
streaming version number displays correctly.
Procedure
streamingclusteradmin -version
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:
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.
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.
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
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.
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
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
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
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
Prerequisites
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.
Next Steps
Prerequisites
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.
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>
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
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.
Normally, the streaming service starts on its own. However, you can use specific tools to start or stop 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.
Prerequisites
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
Prerequisites
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
You can stop the streaming service and prevent a restart through the auto-restart mechanism.
Context
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.
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.
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.
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.
./hdblcmgui
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.
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.
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
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
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:
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
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
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:
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.
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:
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
/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.
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
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).