HANA smart data streaming is included as an installed component in the HANA Developer Edition for both Amazon Web Service (“AWS”) and Microsoft Azure (“Azure”) hosts. The HANA Developer Edition is a single node HANA system with multiple HANA components pre-installed to help new users get up and running quickly and let the user focus on learning the capabilities of HANA and it’s options without getting bogged down in installation tasks.
In order to start using smart data streaming, there are a few steps that you need to complete.
Create a HANA Developer Edition Instance
Detailed instructions for creating a virtual machine instance of the HANA Developer Edition can be found here: SAP HANA Developer Edition in the Cloud | Tutorial | SAP
You will require an existing account for eithere Amazon Web Services or Microsoft Azure as your HANA Developer Edition instance will be hosted on one of those cloud infrastructure providers.
Install Eclipse and the HANA Plug-Ins
The standard development and administration environment for working with a HANA system is HANA Studio. This is an Eclipse based environment with multiple plug-ins specfic to working with HANA. You will need to install Eclipse on the local PC or laptop that you will be using to connect to HANA. Detailed instructions on installing Eclipse and the core HANA plug-ins are available at: SAP Development Tools for Eclipse
Install the Smart Data Streaming Plug-Ins
HANA smart data streaming requires an additional plug-in that provides both the SAP HANA Streaming Development and SAP HANA Streaming Run-Test perspectives. This plug-in is not currently available in the tools.hana.ondemand.com repository, but rather is included as a .sar file on the HANA Dev Edition instance. The plug-in installation file can be found in the /hana/shared/HDB/streaming directory.
Detailed instructions on installing the plugin can be found in this document here on the Smart Data Streaming Developer Center: Installing the Smart data streaming plugin for HANA Studio Within those instructions, you can skip over the Pre-requisites and Download sections and go straight to the Install section. In step 2 of the Install section where you are instructed to start HANA Studio, you will instead be starting the Eclipse system that you installed earlier.
Configure Your Hosts File
Ideally smart data streaming hosts are added to a HANA system using a fully qualified domain name (“FQDN”). However that isn’t always possible. In the case of the HANA Developer Edition, the HANA host is created with a virtual host name of “vhcalhdbdb”. This is done to facilitate the cloning or publishing process used to create multiple instances of the HANA Dev Edition VM from a single template. Your specific instance of the HANA Dev Edition will run in a VM on either AWS or Azure that is unique to you.
Since your HANA instance will be using the virtual host name of “vhcalhdbdb”, you will need to create an entry in the network “etc\hosts” file on the PC or laptop where you are running Eclipse with the HANA plug-ins. This entry will be used to assign the IP address of your VM to the aliases “vhcalhdbdb”.
On Windows, the hosts file is typically found in the C:\Windows\System32\drivers\etc directory. The entry that you need to create will look like this:
# HANA Dev Edition
18.104.22.168 vhcalhdbdb vhcalhdbdb.wdf.sap.corp
Note that you do need “Run as Administrator” permissions in order to edit the hosts file on Windows.
Once you have completed the above configuration steps, you will be ready to start using HANA smart data streaming. The Using the Freezer Monitoring Tutorial for SAP HANA Smart Data Streaming is a great starting point for new users that will walk you through all of the steps from creating a streaming project and connecting to the streaming server to compiling, running and testing the project. Many of our other tutorials available here on the SCN have been written to extend your learning based on using the Freezer Monitoring tutorial as a starting point.
Note on Project Configuration when working with Cloud Servers
Each individual streaming requires 3 TCP ports to be available in order to run. By default these ports are allocated dynamically when the project is started. This behavior works well in on-premise environments where all ports are normally open within the local internal network. In contrast, when working with external cloud based servers, a standard best practice is to only open the minimum set of ports required for the application.
The HANA Dev Edition instance is configured with ports 65532, 65533 and 65534 already open for use by a streaming project. This blog post provides instructions on how to edit the default project configuration to have your streaming project use specific ports when starting up, rather than the dynamically allocating ports which is the default behaviour. Specifying the Command Port to be used by a Smart Data Streaming Project
If you wish to run more than one streaming project at time, then you will need to open 3 additional ports per project and configure each project to use a unique set of ports.