Installation Guide

Document Version: 1.12.0 2016-010-05

Getting Started with SAP HANA, express edition

(Binary Installer Method)

PUBLIC

Installing SAP HANA, express edition (Binary Installer)

Prerequisites
Proficiency Beginner
Software Your server will need the following:
Java Runtime Environment 8 (If you are planning to install the SAP HANA, express edition Download Manager for Windows or Linux, you need the 64bit JRE. If you are planning to install the platform-independent Download Manager, you can use either the 32- or 64-bit JRE.)
OpenSSL .0.9.8
Linux SUSE for SAP in one of the following versions:
SUSE Linux Enterprise Server for SAP 12 SP1
SUSE Linux Enterprise Server for SAP 12
SUSE Linux Enterprise Server for SAP 11.4
Hardware Your server will need the following:
16 GB RAM
120 GB HDD
2 cores (4 recommended)

Tip: If you are installing a SUSE Linux Enterprise Server for SAP for the first time, register your copy. You may need to install add-on packages later,
and add-ons are only available to registered user. Register and download a 60 day evaluation of SUSE Linux Enterprise for SAP at:
https://www.suse.com/products/sles-for-sap/download.

Download the Installer Files

1. Go directly to the registration page at http://sap.com/sap-hana-express.
Or
Go to the SAP HANA, express edition launch page at http://go.sap.com/developer/topics/sap-hana-express.html and click the Register and download
SAP HANA, express edition download manager link.
The registration page opens.
2. Complete the registration form and click the Register button.

Note: If you have an SAP login, click the Login icon at the top of the page to populate the registration form automatically.

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

The Registration Success page displays. (You will also receive an email indicating successful registration.)
3. On the Registration Success page, click the Download button.

The SAP HANA, express edition Download Manager opens.

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

Note: If you are using a Windows machine, you may receive a prompt preventing the Download Manager from running. Click More info
and then click Run anyway to run the Download Manager.

4. In Download Manager, in the Image pull-down, select Binary Installer.

5. Click Browse and select a directory where your downloads will be saved.
6. Select one or more of the following packages:
Server only - Downloads hxe.tgz ; a basic server-only package, and hxescripts.tgz ; a post-installation script.
Server + applications - Downloads hxexsa.tgz ; the server plus XSA and Web IDE.
Text analysis files for additional languages - For languages other than English and German, these files are required for the HANA Text Analysis function.
(The text analysis files for English and German are already included in the Server only and Server + applications packages.)
7. Click the Download button.

Gather Server Information

1. In a shell, enter:
hostname -f

2. Record the hostname.

Installing the SAP HANA, express edition Server

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

1. Navigate to the directory where you wish to extract hxe.tgz .

2. Extract the contents of hxe.tgz :
tar -xvzf <download_path>/hxe.tgz

Tip Run the tar command from the command shell as shown, rather than using a GUI-based extraction tool.

3. Install the server. You will be prompted to enter passwords during the installation.
1. Navigate to the hdblcm and execute it to install the server. Change to the hdblcm directory:
cd <extracted_path>/HANA_10_DEE/DATA_UNITS/HDB_SERVER_LINUX_X86_G4

2. Execute hdblcm:
sudo ./hdblcm -s HXE -H <HostName> --hdbinst_server_import_content=off

Note Here you may choose to install the Application Function Library (AFL) with --components=server,afl . AFL adds application
functions on top of your Express Edition installation for performing data intensive operations, such as the Predictive Analysis Library
(PAL) and the Business Function Library (BFL).

Example:
sudo ./hdblcm -s HXE -H myserver.mydomain.com --components=server,afl --hdbinst_server_import_content=off

3. Enter: 1(Install new system).

4. When prompted for database isolation, enter 1 (low).
5. Enter default settings and passwords.
6. When Summary Before Execution displays, click y to continue with installation.
7. If AFL was installed, you need to allow functions in AFL to run:
sudo su - hxeadm hdbsql -d SystemDB -u SYSTEM -p "${SYSTEM_PWD}" "alter system alter configuration
('indexserver.ini','SYSTEM')SET('calcengine','llvm_lib_whitelist') = 'bfl,pal'"

Note Any misbehavior (e.g. crash) in user written code could potentially destabilize the HANA server. Please ensure that user written AFL
libraries are stable.

Note If a libssl.so.0.9.8 error occurs, see Installation Fails with Error "Cannot load libssl.so.0.9.8".

(Optional) Installing XSC, XS Advanced, and Web IDE

1. Navigate to the directory where you wish to extract hxexsa.tgz .
2. Extract the contents of hxexsa.tgz :
tar -xvzf <download_path>/hxexsa.tgz

Tip Run the tar command from the command shell as shown, rather than using a GUI-based extraction tool.

3. Install XSC:
sudo /hana/shared/HXE/global/hdb/install/bin/hdbupdrep --content_directory=/hana/shared/HXE/global/hdb/auto_content
sudo /hana/shared/HXE/global/hdb/install/bin/hdbupdrep --content_directory=/hana/shared/HXE/global/hdb/auto_content/systemdb

4. Install HANA Extended Services (XSA):

1. Install statistics:
sudo su - hxeadm hdbsql -d SystemDB -u SYSTEM -p "${SYSTEM_PWD}" "alter system alter configuration('nameserver.ini','SYSTEM') SET
('statisticsserver','active') = 'true' with reconfigure"

Example:
sudo su - hxeadm hdbsql -d SystemDB -u SYSTEM -p ABCD1234 "alter system alter configuration('nameserver.ini','SYSTEM') SET
('statisticsserver','active') = 'true' with reconfigure"

2. Install XSA using hdblcm :

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

sudo ./hdblcm -s HXE -H <HOSTNAME> --action=update --components=xs --xs_components=all -configfile=configurations/auto_install.cfg --component_medium=<download_path>/HANA_10_DEE

Example:
sudo ./hdblcm -s HXE -H myhost.localdomain.com --action=update --components=xs --xs_components=all -configfile=configurations/auto_install.cfg --component_medium=/home/myname/Downloads/HANA_10_DEE

Execute the Post-Installation Script

1. Check proxy settings.
2. In SUSE, go to YAST. Click on Proxy
3. Ensure you have the fully qualified address for your proxy in the HTTP Proxy URL.
4. Check the "Use the same proxy" checkbox.
5. Add additional local domains to the No Proxy Domains list as necessary.
6. Extract hxescripts.tgz .
tar -xvzf <download_path>/hxescripts.tgz

3. Enable hxeadm .
sudo su - hxeadm

4. Navigate to the directory where you extracted *hxescripts.tgz* and execute the script.

`cd <extracted_path>
./hxe_optimize.sh`

5. Follow the prompts to enter the appropriate passwords.

Getting Started with SAP HANA, express edition

Record Your System's IP address
1. In a terminal, enter: /sbin/ifconfig .
2. The IP address is listed under the eth0 interface as inet addr . In the following example, the IP address is 10.172.90.53:
etho Link encap:Ethernet HWaddr 00:0C:29:06:1F:93 inet addr:10.172.90.53

Test Your Server installation

1. In a terminal, enter: HDB info . The following services must be running:
hdbnameserver
hdbcompileserver
hdbpreprocessor
hdbwebdispatcher
hdbdiserver (if XSA is installed)
XS services (if XSA is installed)

2. If any services are not running, enter HDB start . When the prompt returns, the system is started.

Test XSC, XSA, and Web IDE

1. Check if XSC is working by going to the following URL: http://<ip-address-of-VM>:8000
2. Check if XSA is working:
a. In a terminal, use the following command to log into XSA services:
xs login -u XSA_ADMIN -p <password>

b. View a list of XSA applications using: xs apps

c. Confirm that webide shows in the list of XSA applications. Note the URL for it.
3. Open the URL for Web IDE in a browser to confirm that it loads.

Install Eclipse and SAP HANA Tools

Prerequisites
Confirm that your machine meets the system requirements for SAP HANA Tools, listed at https://tools.hana.ondemand.com/#hanatools
1. Download and install Eclipse Neon from https://eclipse.org/downloads/, selecting one of the following packages:

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

Eclipse IDE for Java EE Developers

Eclipse IDE for Java Developers
2. Open Eclipse and select a workspace.
3. Install SAP HANA Tools:
a. Select Help > Install New Software
b. In the Work with field, enter https://tools.hana.ondemand.com/neon and click Add.
c. In the Name field, enter SAP HANA, express edition.
d. Expand the SAP HANA Tools node.
e. Select SAP HANA Administrator (Developer Edition).
f. Accept the installation wizard prompts and restart Eclipse.
g. Select Window > Perspective > Open Perspective > Other.
h. Select the SAP HANA Administration Console perspective.
4. Add the SAP HANA, express edition system:
a. On the Systems view, right-click and select Add System, or click the Add System button.
b. Enter the following information and click Next:
Host Name: the IP address for your system
Instance Number: 00
Mode: Multiple containers, System database c. Select Authentication by database user and enter the credentials for your SYSTEM user. Click Finish to
connect.

Obtain and Apply a License Key

1. Obtain your hardware key:
a. In Eclipse, connect to your system.
b. In the Systems view, right-click on your system and select Properties
c. Select License, then the System License tab.
d. Make a note of your hardware key.
2. Order your license key:
a. In a browser, go to http://www.sap.com/minisap and complete the form.
b. For System ID, select HXE - SAP HANA, express edition (32 GB).
c. For Hardware Key, enter the hardware key for your system.
d. Submit the form. The license key is emailed to you.
3. Apply the license key:
a. In Eclipse, click Delete License Key to remove existing licenses.
b. Click Install License Key and select the license key file.

Deactivate the SYSTEM user

1. In a terminal, create a new admin user with the USER ADMIN system privilege:
/usr/sap/HXE/HDB00/exe/hdbsql -d SystemDB -u SYSTEM -p <SYSTEM-password> "CREATE USER <admin-username> PASSWORD <admin-password> NO
FORCE_FIRST_PASSWORD_CHANGE;" /usr/sap/HXE/HDB00/exe/hdbsql -d SystemDB -u SYSTEM -p <SYSTEM-password> "GRANT USER ADMIN TO <adminusername> WITH ADMIN OPTION;"

2. Use the new admin user to deactivate the SYSTEM user:

/usr/sap/HXE/HDB00/exe/hdbsql -d SystemDB -u <admin-username> -p <admin-password> "ALTER USER SYSTEM DEACTIVATE USER NOW;"

Troubleshooting
Installation fails with error Cannot load libssl.so.0.9.8
Issue
You are installing SAP HANA, express edition on a Linux server using hdblcm . You receive this error:
Installation of SAP HANA Database failed.
Installation failed.
unhandled exception. Cannot load libssl.so.0.9.8

Solution
You need to downgrade your OpenSSL to version 0.9.8.
libopenssl version 0.9.8 is provided in Legacy Module 12 x86_64 of SUSE Linux Enterprise Server for SAP Applications 12 SP1.
You need to be registered on the SUSE site before you can download the legacy module. If you havent already registered, you will be prompted to register
during the download.
1. Go to YaST > Add-on Product.
2. Click the Add button.
3. Under Add-on Product, select Extensions and Modules from Registration Server. If you havent registered already, register to continue.
4. From the Available Extensions and Modules list, select Legacy Module 12 x86_64.

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

5. Agree to the license terms and accept the remaining installation prompts.
6. Restart your Linux server.
7. Retry your server-only installation.

HDB Daemon not Running

Issue
You are installing SAP HANA, 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 at these versions:
zypper info util-linux util-linux-systemd uuidd

The results need to show that you have at least the following versions installed:
util-linux: util-linux-2.25-22.1
uuidd : uuidd-2.25-22
util-linux-systemd: 2.25-22.1
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: systemctl status uuidd.socket
4. If the status is inactive, start socket activation: systemctl start uuidd.socket

Download Manager Internal Error: "downloaded size does not match content length"
Issue
You are downloading packages using Download Manager. The download fails. The Download Manager log file displays this error message: Internal error:
downloaded size does not match content length The Download Manager log file is located at /tmp/hxedm_[yymmdd].log on Linux and
%TEMP%\hxedm_[yymmdd].log on Windows.

Solution
Either the file on the download server changed since your last download session, or partial download files from your previous download session are corrupted.
Delete *.001 to *.008 files in your download directory and run the Download Manager again.

Download Manager Error Message: "Failed to verify {0} checksum"

Issue
You are downloading packages using Download Manager. The download fails and this error displays: Failed to verify {0} checksum

Solution
Either the file on the download server changed since your last download session, or the download file is inaccessible/corrupted. Delete the download file and/or
.00* in the download directory and run the Download Manager again.

Download Manager Error Message: "Failed to join downloaded files"

Issue
You are downloading packages using Download Manager. The download fails and this error displays: Failed to join download files

Solution
Download manager failed to assemble the download file. This might be because of lack of disk space in the download directory. In Linux, run: cat .001 .002
.003 .004 .005 .006 .007 .008 > < final_filename >
In Windows, run: type .001 .002 .003 .004 .005 .006 .007 .008 > < final_filename >

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

Important disclaimers and legal information

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

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

Gender-Neutral Language
As far as possible, SAP documentation is gender neutral. Depending on the context, the reader is addressed directly with "you", or a gender-neutral noun (such
as "sales person" or "working days") is used. If when referring to members of both sexes, however, the third-person singular cannot be avoided or a genderneutral 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).

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

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

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

go.sap.com/registration/
contact.html

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

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