Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
3 Configuring Telemetry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.1 Disable and Enable Telemetry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
2 PUBLIC Content
6.5 Configure the SAP SDS Service Broker. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
6.6 Configure Streaming Runtime Tool Permissions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
7 Best Practices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
7.1 Deactivate the SYSTEM User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
7.2 Backups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
10 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
10.1 HDB Daemon Not Running. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
10.2 SAP HANA XS Applications Run Error. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
10.3 Download Manager Shows Error "Failed to concatenate downloaded files". . . . . . . . . . . . . . . . . . . 40
10.4 Update Fails with Error Message. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
Content PUBLIC 3
1 Installing SAP HANA 2.0, express edition
(Binary Installer Method)
The SAP HANA 2.0, express edition Binary Installer is for Linux machines running specific installations that
need to meet storage and memory prerequisites. Choose this installation method if you want a custom setup.
Disclaimer
SAP HANA, express edition is officially supported on SLES. SAP Community members have been successful in
running SAP HANA, express edition on other Linux operating systems that are not formally supported by SAP,
such as Ubuntu, openSUSE and Fedora. SAP is not committing to resolving any issues that may arise from
running SAP HANA, express edition on these platforms.
Check if your machine has the recommended software and hardware to successfully install and run SAP HANA
2.0, express edition.
Software Details
Java Runtime Environment (JRE) 8 or Higher If you are planning to install the SAP HANA 2.0, express
edition Download Manager for Windows or Linux, you need
the 64-bit JRE. If you are planning to install the platform-
independent Download Manager, you can use either the 32-
or 64-bit versions.
Hardware Details
Note
If you are installing on a system with 16 GB of RAM,
increase the amount of swap space to at least 32 GB.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
4 PUBLIC Installing SAP HANA 2.0, express edition (Binary Installer Method)
Hardware Details
Register online and use the Download Manager to download SAP HANA 2.0, express edition installation
packages.
Procedure
Note
If you have an SAP login, click the Login icon at the top of the page to populate the registration form
automatically.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
Installing SAP HANA 2.0, express edition (Binary Installer Method) PUBLIC 5
3. On the Registration Success page, under 1A. ON-PREMISE INSTALLATION, click the download manager
that matches your system: Linux or Windows. If you have a Mac, or another type of machine, click
Platform-independent for a platform-independent download manager.
4. Save the download manager installation file to your laptop and open it. If your system displays a security
warning when you open the file, accept the warning.
Note
If you are inside a corporate firewall, you will be prompted for your proxy settings. Contact your IT
administrator.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
6 PUBLIC Installing SAP HANA 2.0, express edition (Binary Installer Method)
5. In the Download Manager, in the Image pull-down, select Binary Installer.
6. Click Browse and select a directory where your downloads will be saved.
7. Select one or more of the following packages:
Package Details
Server only Downloads hxe.tgz; the SAP HANA 2.0, express edition server with Application Function Li
installer brary. This file is necessary for installing SAP HANA 2.0, express edition.
Applications Downloads the optional package hxexsa.tgz; XSA, Web IDE, and SAP HANA cockpit. Down
load this and hxe.tgz to install those applications.
Clients Downloads a zip file containing four compressed client-tools bundles. Use the client packages to
access developed SAP HANA 2.0, express edition applications from a client PC. See (Optional)
Installing Clients [page 15].
○ hdb_client_linux.tgz - Reduced HANA client for Linux 64-bit. Contains the HANA
client package, drivers, and required licenses.
○ hdb_client_windows.zip - Reduced HANA client for Windows 64-bit. Contains the
HANA client package, drivers, and required licenses.
○ xs.onpremise.runtime.client_linuxx86_64.zip - Command-line tools for
Linux that enable access to (and control of) the SAP HANA XS advanced run-time environ
ment.
○ xs.onpremise.runtime.client_ntamd64.zip - Command-line tools for Win
dows that enable access to (and control of) the SAP HANA XS advanced run-time environ
ment.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
Installing SAP HANA 2.0, express edition (Binary Installer Method) PUBLIC 7
Package Details
Tip
After you develop an application using SAP HANA 2.0, express edition, install Download Man
ager to a client machine and download the Clients package to that client machine. You can
then use the clients to connect to -- and test -- your HANA applications, emulating a cus
tomer.
Text analysis files For languages other than English and German, these files are required for the HANA Text Analy
for additional sis function. (The text analysis files for English and German are already included in the Server
languages only and Applications packages.) Download this and hxe.tgz to install these files. For the text
analysis files installation procedure, see the Installing Additional Components section.
SAP Enterprise Downloads eadesigner.tgz. Extract this in the same directory as hxe.tgz and
Architect hxexsa.tgz to include EA Designer in your installation process.
Designer (XSA
only)
SAP Smart Data Downloads sds.tgz, which contains SAP HANA smart data streaming. Extract this in the same
Streaming option directory as hxe.tgz and hxexsa.tgz to include smart data streaming in your installation
process.
SAP Smart Data Downloads sds_plugin.zip, which contains an Eclipse plugin for creating and deploying
Streaming studio smart data streaming projects. For installation steps, see the Install the Streaming Studio Plugin
plug-in topic.
SAP HANA Downloads shine.tgz. Extract this in the same directory as hxe.tgz and hxexsa.tgz to
Interactive include SHINE in your instllation process.
Education (XSA
only)
Extract the installation files and setup your SAP HANA 2.0, express edition installation.
Context
Note
You may have to disable your firewall for SAP HANA 2.0, express edition to install successfully.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
8 PUBLIC Installing SAP HANA 2.0, express edition (Binary Installer Method)
Procedure
1. Navigate to the directory where you wish to extract the installation files.
2. Extract the contents of hxe.tgz, hxexsa.tgz (if you are installing the Applications package),
eadesigner.tgz (if you are installing SAP EA Designer), sds.tgz (if you are installing smart data
streaming), and shine.tgz (if you are installing SHINE):
Tip
Run the tar command from the command shell as shown, rather than using a GUI-based extraction
tool.
Note
You may have to give these files run permissions. Example:
3. Navigate to the directory where you extracted the files and run ./setup_hxe.sh as the root user:
cd <extracted_path>
sudo ./setup_hxe.sh
Note
The master password you specify during installation is used for the <sid>adm, and sapadm OS users,
the telemetry technical user, and the SYSTEM user. If you are installing the Applications package, this
password is also used for the XSA_ADMIN, XSA_DEV, and XSA_SHINE users. If you are installing smart
data streaming, this password is also used for the SYS_STREAMING and SYS_STREAMING_ADMIN users.
SAP HANA, express edition requires a very strong password that complies with these rules:
○ At least 8 characters
○ At least 1 uppercase letter
○ At least 1 lowercase letter
○ At least 1 number
○ Can contain special characters, but not \ (backslash), " (double quotes), or ` (backtick)
○ Cannot contain dictionary words
○ Cannot contain simplistic or systematic values, like strings in ascending or descending numerical or
alphabetical order
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
Installing SAP HANA 2.0, express edition (Binary Installer Method) PUBLIC 9
2 Getting Started with SAP HANA, express
edition
Procedure
Procedure
http://<hostname>:80<instance-number>
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
10 PUBLIC Getting Started with SAP HANA, express edition
2. As the <sid>adm user, log in to XSA services:
Note
When you run the xs apps command for the first time, it may take 1-2 minutes for the system to return
the list of XSA applications.
4. Check that the application cockpit-admin-web-app shows STARTED with 1/1 instances in the list of
XSA applications.
Note
Normally it only takes a few minutes for XSA services to start. However. depending on your machine, it
can take over 30 minutes for XSA services to begin. If the service doesn't show STARTED and doesn't
show 1/1 instances, keep waiting until the service is enabled.
5. Enter the URL for cockpit-admin-web-app in a browser. The address is the one that displays in your xs
apps command output.
Example: https://my.hostname:51043
6. Log in using the XSA_ADMIN user.
7. If your site uses a proxy for connecting to HTTP and HTTPS servers, select Cockpit Settings Proxy ,
then enable Http(s) Proxy and set the host, port, and non-proxy hosts.
Tip
To find your proxy server information, in a terminal, enter env | grep PROXY.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
Getting Started with SAP HANA, express edition PUBLIC 11
Note
If you are using HANA Cockpit to register a resource, both HANA Cockpit and the SAP HANA, express
edition server must be from the same release. SAP does not recommend using a newer HANA Cockpit
to register an older version of SAP HANA, express edition.
Procedure
3. Check that the application webide shows STARTED with 1/1 instances in the list of XSA applications.
Note
Normally it only takes a few minutes for XSA services to start. However. depending on your machine, it
can take over 30 minutes for XSA services to begin. If the service doesn't show STARTED and doesn't
show 1/1 instances, keep waiting until the service is enabled.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
12 PUBLIC Getting Started with SAP HANA, express edition
2.4 (Optional) Test Your Installation Using the HANA
Eclipse Plugin
Download and install the HANA Eclipse Plugin on a client machine and connect to SAP HANA, express edition.
Procedure
1. Download Eclipse IDE for Java EE Developers from http://www.eclipse.org/neon/ to your local file
system.
2. Follow the Eclipse installer prompts.
3. Launch when prompted, or go to the Eclipse folder (example: C:\Users\<path>\eclipse\jee-neon)
and run the eclipse executable file.
4. Follow the tutorial How to download and install the HANA Eclipse plugin to connect to your SAP HANA,
express edition client machine.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
Getting Started with SAP HANA, express edition PUBLIC 13
3 Configuring Telemetry
When you install SAP HANA 2.0, express edition, telemetry is enabled by default. You can disable telemetry
after installation is complete. Telemetry sends anonymous performance statistics and usage statistics to SAP,
so that SAP can focus development efforts on areas most vital to the SAP HANA, express edition customer
base.
Note
Your privacy is important to SAP. Telemetry collects anonymous usage information while ensuring
complete privacy. No identifying information or private information is collected, and you can opt out of
telemetry at any time.
If you are inside a corporate firewall and use a proxy for connecting to HTTP and HTTPS servers, you need to
identify your proxy settings, log in to Cockpit, and update the Cockpit Settings Proxy page.
Note
If you do not update the Cockpit proxy settings, telemetry will not work properly. For instructions on
specifying your proxy settings in Cockpit, see the Test XSC and XSA (Applications Package Only) [page 10]
topic.
Disable telemetry if you wish to stop sending anonymous telemetry data to SAP.
Procedure
1. Start SAP HANA 2.0, express edition and log in as the <sid>adm user.
2. Run:
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
14 PUBLIC Configuring Telemetry
4 (Optional) Installing Clients
Install the clients if you intend to develop XS applications on a machine that will not have a local SAP HANA
2.0, express edition installation.
The clients let you access SAP HANA 2.0, express edition from your client machine.
You can install the clients on the SAP HANA 2.0, express edition server during server installation, but this how-
to assumes you are installing the clients on a different machine than the machine where SAP HANA 2.0,
express edition is installed.
This how-to refers to the laptop with SAP HANA 2.0, express edition as the server machine, and your local
machine as the client machine.
Install the Download Manager to your client machine and download the client package.
Prerequisites
The Download Manager requires Oracle Java SE Runtime Environment 8 (JRE 8) or higher, 64-bit, on your
client machine.
Context
Procedure
1. Save the Download Manager installation file to your client machine and open it. For instructions on
downloading and running the Download Manager, see Installing SAP HANA 2.0, express edition (Binary
Installer Method) [page 4].
2. In Download Manager, in the Image pull-down, select either Virtual Machine or Binary Installer.
3. Click Browse and select a directory where your client package will be saved.
4. Select only Clients. The clients.zip file downloads to your save directory.
5. Extract clients.zip.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
(Optional) Installing Clients PUBLIC 15
○ For Windows machines, use a compression utility like WinZip or Unzip.
○ For Linux, navigate to the directory in which you wish to extract the client files and use the unzip
command.
cd <preferred_filepath>
sudo unzip <download_filepath>/clients.zip
Results
● hdb_linux.tgz
● hdb_client_windows.zip
● xs.onpremise.runtime.client_linuxx86_64.zip
● xs.onpremise.runtime.client_ntamd64.zip
You can use the XS command line client to perform a wide variety of developer- and administrator-related
tasks.
For example, in the role of a developer, you can use the XS CLI to connect to the XS advanced run time
installed on the server machine, log on as a specific user, and deploy and manage your applications.
Ensure that you have access to an installation of SAP HANA 2.0, express edition with XS advanced installed.
● XS advanced is installed on the SAP HANA 2.0, express edition machine (the server host).
● You have access to the internet from your client machine.
● You have log-on access to the SAP HANA 2.0, express edition database with the privileges to create SAP
HANA users (for example: SYSTEM).
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
16 PUBLIC (Optional) Installing Clients
4.2.2 Install the XS CLI Client
Install the command line client for XS advanced on your client machine.
Context
In this procedure, you learn how to use the XS CLI client to connect to SAP HANA.
Procedure
For example, the SAP HANA instance "90" on the host xsa.acme.com: https://xsa.acme.com:
39030/v2/info.
The response displayed in the Web browser is a JSON string with details that indicate a successful
connection to the XSA controller. This connection test is important as you want to make sure the
connection exists before you attempt it from within the API command.
3. Check that the XS client for XS advanced is installed and available. The XS client tools are required to
connect to the XS advanced run time on SAP HANA and deploy your XS advanced applications. On your
client machine, open a command window and run the following commands:
xs help
xs -v
Note
Linux users should run this command as <sid>adm.
xs api https://<hostname>:3<instance_number>30
Note
This command may fail due to a missing SSL certificate. This note shows you how to set up a certificate
on the client so it can connect to the server. Copy the correct certificate to your client from the SAP
HANA 2.0, express edition server.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
(Optional) Installing Clients PUBLIC 17
Open a command session on the server machine or open a PuTTY session to the server machine. From
the command prompt, login as sudo and navigate to the certificate. The certificate
default.root.crt.pem is typically located here: <installation_path>/<SID>/xs/
controller_data/controller/ssl-pub/router
/hana/shared/HDB/xs/controller_data/controller/ssl-pub/router/
default.root.crt.pem
Copy the certificate to a folder on the server where you can easily access it. Using an FTP client or the
scp command, send a copy of the certificate from your server machine to a safe location on your client
machine.
FTP example:
/<path>/default.root.crt.pem
scp example:
scp <server_machine_user>@<ip_address_server>:<file_destination>/
default.root.crt.pem
<client_machine_user>@<client_machine_user>@<ip_address_client>:<your_desire
d_filepath>/
Exit your FTP and PuTTY sessions and return to your client machine. Try the previous command again,
but use the -cacert command and specify the local certificate you just copied.
5. From the client machine, log on the XS advanced run time. You log on to the SAP HANA instance specified
in the API end point set in a previous step. SAP HANA provides a default user XSA_ADMIN with
administrator permissions; you can use this user ID to test the logon. However, it is recommended to
create a new user with more limited permissions, which you can use to log on for developer tasks.
Note
The password is assigned to the XSA_ADMIN user during SAP HANA 2.0, express edition installation.
6. Test your connection to XSA. Run the following command to view XS applications on the SAP HANA 2.0,
express edition server.
xs apps
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
18 PUBLIC (Optional) Installing Clients
4.3 Installing SAP HANA HDB Client
SAP HANA 2.0, express edition provides the Reduced SAP Client package for connecting applications.
You can install the client on the server machine during server installation, or on a separate machine as
described here.
When you install the SAP HANA client software package, you install the following clients:
● SQLDBC
● ODBC
● JDBC
● Python (PyDBAPI)
● Node.js
● Ruby
Use either a graphical user interface or a command line to install the SAP HANA Client on your Windows
machine.
Context
Procedure
hdb_client_windows\HDB_CLIENT_WINDOWS_X86_64
2.
○ In a file explorer, go to the HDB_CLIENT_WINDOWS_X86_64 folder.
○ Open a command prompt and navigate to HDB_CLIENT_WINDOW_X86_64.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
(Optional) Installing Clients PUBLIC 19
3.
○ In the file explorer, double-click:
○ hdbsetup.exe - GUI installation
○ hdbinst.exe - command line installation
○ From a command prompt, call the program hdbsetup (GUI installation) or hdbinst (command line
installation) by entering one of the following commands
Option Description
Unpack your installation file to install the SAP HANA Client on your Linux machine.
Context
Procedure
1. Navigate to the directory where you wish to unpack the hdb_client_linux.tgz files.
cd <your_destination>
2. Unpack hdb_client_linux.tgz:
cd HDB_CLIENT_LINUX_X86_64
sudo ./hdbinst
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
20 PUBLIC (Optional) Installing Clients
4.3.4 Logging the Installation
The log files are stored at %TEMP%\hdb_client_<time_stamp> for Windows and /var/temp/
hdb_client_<time_stamp> for Linux.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
(Optional) Installing Clients PUBLIC 21
5 Installing Additional Components
Context
If you downloaded and extracted the Applications package (hxexsa.tgz) and SAP Enterprise Architecture
Designer (SAP EA Designer) package (eadesigner.tgz), the installation file for SAP EA Designer is located
at <extracted_path>/HANA_EXPRESS_20/install_eadesigner.sh.
SAP EA Designer lets you capture, analyze, and present your organization's landscapes, strategies,
requirements, processes, data, and other artifacts in a shared environment. Using industry-standard notations
and techniques, organizations can leverage rich metadata and use models and diagrams to drive
understanding and promote shared outcomes in creating innovative systems, information sets, and processes
to support goals and capabilities.
Install SAP EA Designer in your SAP HANA 2.0, express edition system using the installation script.
Procedure
1. Log in as <sid>adm.
sudo su -l <sid>adm
<extracted_path>/HANA_EXPRESS_20/install_eadesigner.sh
3. When the installation is complete, enter the following command to confirm the status of SAP EA Designer:
xs apps
The output will include all the applications of your organization and space. You should see:
○ eadesigner - The SAP EA Designer application
○ eadesigner-service - The SAP EA Designer Node application
○ eadesigner-backend - The SAP EA Designer Java application
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
22 PUBLIC Installing Additional Components
○ eadesigner-db - The SAP EA Designer database creation application. This application will have a
state of stopped when the installation is complete.
4. Note the URL for eadesigner and enter it in your web browser address bar to go to the SAP EA Designer
login screen.
5. Enter the following credentials:
○ User Name - ADMIN
Note
Account names managed by SAP EA Designer are case-sensitive.
○ Password - Enter the password you created when you installed SAP EA Designer.
You are prompted to change the password. You are logged in as administrator of SAP EA Designer.
SAP HANA Interactive Education (SHINE) makes it easy to learn how to build applications on SAP HANA
Extended Application Services Advanced Model.
SHINE is provided as an optional component for SAP HANA, express edition. Download the SHINE installation
file, shine.tgz, from the SAP HANA, express edition Download Manager. This download includes installation
files for installing SHINE on XSC and XSA.
<extracted_path>/HANA_EXPRESS_20/DATA_UNITS/HCO_HANA_SHINE
To install SHINE for XSC, see the SAP HANA Interactive Education (SHINE) guide.
Note
The HANA JDBC port number for SAP HANA, express edition is different than the default port number
30015 mentioned in the SHINE guide. You need to update the port parameter for the resources
CrossSchemaSys and CrossSchemaSysBi in the mtaext file to 3<instance-number>13.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
Installing Additional Components PUBLIC 23
Install SHINE for XSA
<extracted_path>/HANA_EXPRESS_20/DATA_UNITS/XSA_CONTENT_10
<extracted_path>/HANA_EXPRESS_20/install_shine.sh
If you are using SAP HANA 2.0, express edition in a language other than English or German, you can download
the Text analysis files for additional languages package in the Download Manager.
Prerequisites
You downloaded the package Text analysis files for additional languages using Download Manager.
Procedure
1. Log in as <sid>adm.
2. Navigate to /hana/shared/<SID>/global/hdb/custom/config/lexicon.
3. Extract the contents of additional_lang.tgz to this directory:
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
24 PUBLIC Installing Additional Components
6 (Optional) Installing SAP HANA Smart
Data Streaming
Install the SAP HANA client package and SAP HANA smart data streaming on an SAP HANA, express edition
system.
Procedure
1. Use the Download Manager to download the smart data streaming installation package, sds.tgz.
2. Extract the contents of sds.tgz:
Tip
Run the tar command from the command shell as shown, rather than using a GUI-based extraction
tool.
Note
You may have to give these files run permissions. Example:
3. Navigate to the HANA_EXPRESS_20 directory where you extracted the files and run install_sds.sh as
the root user:
cd <extracted_path>/HANA_EXPRESS_20
sudo ./install_sds.sh
Note
The system database user (SYSTEM) password you enter during installation is used for the
SYS_STREAMING and SYS_STREAMING_ADMIN users.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
(Optional) Installing SAP HANA Smart Data Streaming PUBLIC 25
6.1 (Optional) Create a Smart Data Streaming User
Create a new user with permissions to perform all smart data streaming tasks.
Context
By default, the SYSTEM user has permission to perform all tasks in smart data streaming. If you have disabled
the SYSTEM user, or plan to do so, follow these steps to create a new user with the same permissions.
Procedure
sudo su -l <sid>adm
3. If you have the applications package installed, grant the CATALOG READ permission to the user:
$STREAMING_HOME/bin/streamingclusteradmin --uri=esps://<HXE-hostname>:
3<instance-number>16 --username=SYS_STREAMING --password=<password> --
admin_policy --command="grant perm all to user SDS_USER"
If you're running SAP HANA, express edition in a virtual machine or cloud server instance, then depending on
the network configuration, you may need to edit the /etc/hosts file on your local machine so Eclipse can
connect to the smart data streaming server.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
26 PUBLIC (Optional) Installing SAP HANA Smart Data Streaming
6.2.1 Edit /etc/hosts on Windows
If you are running Eclipse on a Windows machine, follow these steps to update the /etc/hosts file.
Procedure
Spacing is important. Make sure your hosts file in Notepad looks like this image.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
(Optional) Installing SAP HANA Smart Data Streaming PUBLIC 27
6.2.2 Edit /etc/hosts on Mac and Linux
If you are running Eclipse on a Mac or Linux machine, follow these steps to update the /etc/hosts file.
Procedure
Install the smart data streaming plugin to develop and test streaming projects in Eclipse.
Prerequisites
You have installed Eclipse and the HANA Eclipse plugin. See the (Optional) Test Your Installation Using the
HANA Eclipse Plugin [page 13] tutorial for steps.
Procedure
1. Use the Download Manager to download the streaming studio plugin, sds_plugin.zip
2. Extract the contents of the sds_plugin.zip file:
unzip <download_path>/sds_plugin.zip
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
28 PUBLIC (Optional) Installing SAP HANA Smart Data Streaming
6. In the Install dialog, check SAP HANA smart data streaming, then click Next.
7. Review the items to be installed, then click Next.
8. Review the license, accept the terms and conditions to continue, then click Finish.
9. For any security warning prompts, click OK.
10. At the prompt to restart Eclipse, select Yes.
11. If you are installing the plugin into Eclipse for Linux, log off of the machine and log back in.
Add a connection to the smart data streaming server and create a HANA service.
Prerequisites
● You have installed the smart data streaming plugin for Eclipse.
● If necessary for your network configuration, you have edited the /etc/hosts file on the machine where you
are using Eclipse. See Edit the /etc/hosts File for more information.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
(Optional) Installing SAP HANA Smart Data Streaming PUBLIC 29
Procedure
1. In Eclipse, select Window Perspective Open Perspective Other , then select the SAP HANA
Streaming Development perspective and click OK.
Note
To automatically connect to the streaming server when starting Eclipse, check Use Secure Storage for
Streaming Credentials.
8. Open Window Preferences and select SAP HANA smart data streaming from the list.
9. Set Default Server URL to the new server and click OK.
10. Switch to the SAP HANA Streaming Development perspective and select the Data Services tab:
12. Right-click on the Server-wide folder and select Add HANA Service.
13. Select newservice1 and, in the Properties view:
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
30 PUBLIC (Optional) Installing SAP HANA Smart Data Streaming
a. Enter the credentials for SYSTEM.
b. Uncheck Use Default HANA Server.
c. Select Multi Tenant.
d. Set Database Name to HXE.
e. Set HANA Hostname to the hostname or IP address for your SAP HANA, express edition installation.
f. Set HANA Instance Number to the instance number for your installation.
14. Right-click on newservice1 and select Rename Service. Name the service hanadb.
15. To confirm that the HANA service is configured properly, right-click on it and select Discover:
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
(Optional) Installing SAP HANA Smart Data Streaming PUBLIC 31
6.5 Configure the SAP SDS Service Broker
If you want to use the WebIDE to develop streaming projects, configure the SAP SDS service broker to enable
the smart data streaming plugin for WebIDE.
Procedure
1. As the <sid>adm user, enter the following command to add diserver to the tenant database:
2. Log in to the XS Advanced Administration and Monitoring Tools as the XSA_ADMIN user.
Note
To find the URL, log in to XSA services and find xsa-admin on the applications list:
Note
By default, the password for the SYS_STREAMING user is the same as the password for the database
user (SYSTEM) you used when installing smart data streaming.
You can now use the smart data streaming plugin in the SAP HANA Web IDE.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
32 PUBLIC (Optional) Installing SAP HANA Smart Data Streaming
6.6 Configure Streaming Runtime Tool Permissions
Update the DEVX_DEVELOPER role to give XSA_DEV access to the streaming runtime tool.
Procedure
1. Log in to the XS Advanced Administration and Monitoring Tools as the XSA_ADMIN user.
Note
To find the URL, log in to XSA services and find xsa-admin on the applications list:
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
(Optional) Installing SAP HANA Smart Data Streaming PUBLIC 33
7 Best Practices
SYSTEM is the database superuser and is not intended for day-to-day activities in production systems. For
better security, you can create other database users with only the privileges that they require for their tasks
(for example, user administration), then deactivate the SYSTEM user.
Procedure
sudo su -l <sid>adm
2. Create a new admin user with the USER ADMIN system privilege:
/usr/sap/<SID>/HDB<instance-number>/exe/hdbsql -i <instance-number> -d
SystemDB -u SYSTEM -p "<SYSTEM-password>" "CREATE USER <admin-username>
PASSWORD <admin-password> NO FORCE_FIRST_PASSWORD_CHANGE;"
/usr/sap/<SID>/HDB<instance-number>/exe/hdbsql -i <instance-number> -d
SystemDB -u SYSTEM -p "<SYSTEM-password>" "GRANT USER ADMIN TO <admin-
username> WITH ADMIN OPTION;"
/usr/sap/<SID>/HDB<instance-number>/exe/hdbsql -i <instance-number> -d
SystemDB -u <admin-username> -p "<admin-password>" "ALTER USER SYSTEM
DEACTIVATE USER NOW;"
7.2 Backups
For information on data backup, recovery, and log file growth, see the SAP HANA Administration Guide.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
34 PUBLIC Best Practices
8 Updating SAP HANA, express edition
Update SAP HANA 2.0, express edition when new patches are released.
Procedure
1. Using the Download Manager, select Binary Installer and download the Server only package (hxe.tgz). If
the installation you are updating has the Applications package, download the Applications package
(hxe.tgz) as well.
2. Login as <sid>adm.
3. Extract the contents of the hxe.tgz, and hxexsa.tgz for Applications if applicable, to the same
directory.
cd <extract_path>/HANA_EXPRESS_20/
5. As the root user, run the upgrade script to update the server:
sudo ./hxe_upgrade.sh
Note
hxe_upgrade.sh detects the Server and Applications packages. The script will upgrade the server and
XSA (if available).
Note
Upgrading is supported only for SAP HANA, express edition 2.0 SP 00 to SAP HANA, express edition
2.0 SP 01.
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
Updating SAP HANA, express edition PUBLIC 35
Results
Note
If you receive the error message Installation of archive file(s) '/usr/sap/HXE_2_SP1/
HANA_EXPRESS_20/DATA_UNITS/HANA_COCKPIT_20/XSACCOCKPIT02_5.zip' failed., see
troubleshooting topic Update Fails with Error Message [page 41].
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
36 PUBLIC Updating SAP HANA, express edition
9 Uninstalling SAP HANA, express edition
Procedure
sudo /hana/shared/<SID>/hdblcm/hdblcm
2. Select uninstall.
3. Choose to uninstall all components.
4. Uninstall the SAP Host Agent:
Procedure
2. Uninstall the SAP EA Designer software component. To uninstall the component plus the HDI container
and repository database, use the following command:
To delete the component but retain the HDI container and repository database, use the following
command:
xs uninstall XSAC_HANA_EA_D
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
Uninstalling SAP HANA, express edition PUBLIC 37
9.3 Uninstalling the SAP HANA Client
Each installation of the SAP HANA Client has its own uninstallation tool.
Procedure
1. Use the hdbuninst command to uninstall the client software from your command prompt.
sudo <unzipped_filepath>/HDB_CLIENT_<version>/hdbuninst
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
38 PUBLIC Uninstalling SAP HANA, express edition
10 Troubleshooting
Issue: You are installing SAP HANA 2.0, express edition on a Linux server using hdblcm. You receive this error:
Cannot start system. Start instance 00 on host 'hxehost.localdomain.com' failed.
FAIL: process hdbdaemon HDB Daemon not running.
Solution:
1. Use zypper to check the util-linux, util-linux-systemd, and uuidd packages to make sure they
are the correct versions:
The results need to show that you have at least the following versions installed:
○ util-linux: util-linux-2.25-22.1
○ util-linux-systemd: 2.25-22.1
○ uuidd: uuidd-2.25-22
2. If you are missing any of the packages, or if the versions are outdated, install them using the zypper
install command.
3. Check that socket activation is enabled and started. In a shell, enter:
Issue: You are trying to run an SAP HANA service on your SAP HANA 2.0, express edition installation and are
receiving an error.
sudo su -l <sid>adm
xs apps
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
Troubleshooting PUBLIC 39
This operation may take 1-2 minutes to return the list of apps. You should see the following:
xs start <app>
It may take a few minutes for the system to get started. Run xs apps again to see if the app has started and
that under instances the app shows 1/1.
Issue: You are downloading packages using the Download Manager. The Status area and Progress Detail area
show the error Failed to concatenate downloaded files.
Solution:
1. Check the log file for details. The log file is in the temp directory:
○ Linux: /tmp/hxedm[yymmdd].log
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
40 PUBLIC Troubleshooting
○ Windows: %TEMP%\hxedm_[yymmdd].log
2. If the log indicates a simple issue such as lack of disk space or file permissions, fix the problem and
download again.
3. If the problem is less obvious, do the following:
○ Go to the Save directory. Delete all downloaded files, including incomplete download files. Download
again
or
○ Change the Save directory. Download again.
Issue: When upgrading SAP HANA, express edition 2.0 SP 00 to SAP HANA, express edition 2.0 SP 01, the
update fails with an error message.
Solution: If you encounter this error, use this workaround procedure to complete the upgrade:
xs install <extract_path>/HANA_EXPRESS_20/DATA_UNITS/HANA_COCKPIT_20/
XSACCOCKPIT02_5.zip
3. Run the following command to update the SAPUI5 SDK 1.44 application.
xs install <extract_path>/HANA_EXPRESS_20/DATA_UNITS/HANA_COCKPIT_20/
XSACUI5FESV344_10.zip
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
Troubleshooting PUBLIC 41
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 willful 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).
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
42 PUBLIC Important Disclaimers and Legal Information
Getting Started with SAP HANA 2.0, express edition (Binary Installer Method)
Important Disclaimers and Legal Information PUBLIC 43
go.sap.com/registration/
contact.html