Instalação Lumira Server

SAP Lumira Server
Document Version: 1.25 2015-04-20
SAP Lumira Server Installation Guide
Content
Document History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.1
Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2
Required information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Required Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
3.1
Summary of required components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.2
SAP HANA requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.3
XS Engine requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3.4
SAP HANA Client requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.5
Universal Analytics Application Function Library (UAL AFL) requirements. . . . . . . . . . . . . . . . . . . . . . . 11
3.6
SAP HANA Studio requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
List of steps for installing SAP Lumira Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4.1
List of steps for a new installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4.2
List of steps for an upgrade installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Installing SAP HANA components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
5.1
To download SAPCAR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
5.2
To uninstall SAL AFL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
5.3
To install the Universal Analytics Application Function Library (UAL AFL). . . . . . . . . . . . . . . . . . . . . . . 17
Installing and configuring SAP Lumira Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
6.1
Stopping background jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
6.2
Updating the SAP Lumira Server database schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.3
To install or upgrade SAP Lumira Server using HALM command line. . . . . . . . . . . . . . . . . . . . . . . . . . .21
6.4
To install or upgrade SAP Lumira Server using HALM Web Administration tool. . . . . . . . . . . . . . . . . . . 24
6.5
To assign catalog privileges to roles (SAP HANA SP09 and later). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
6.6
To create administration users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
6.7
To prepare SAP Lumira Server for configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
6.8
To configure SAP Lumira Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Creating users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
7.1
User rights and roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
7.2
To test user rights and roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
7.3
To use SAP HANA Studio to specify the roles available for sharing. . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Installing and uninstalling chart extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
2015 SAP SE or an SAP affiliate company. All rights reserved.

Content
8.1
To create an extension management user. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
8.2
To add the Manage Lumira Extensions tile to SAP Fiori. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
8.3
To install chart extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
8.4
To update a chart extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
8.5
To uninstall a chart extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
To generate time data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
10
To enable currency conversion for users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
11
Backing up and restoring your server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
11.1
To backup data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
11.2
To back up configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
11.3
To restore data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
11.4
To restore configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
12
To undeploy SAP Lumira Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
13
Appendix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
13.1
Working with SAP Fiori. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50

To configure the SAP Fiori catalog on an ABAP application server. . . . . . . . . . . . . . . . . . . . . . . . . . 50
Accessing SAP Fiori. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
13.2
Logging server activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

To enable component-level tracing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
To view trace files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
13.3
SQL setup on SAP HANA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
13.4
Client authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
13.5
Common installation problems and troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

SAP HANA Lifecycle Manager displays an error when clicking Run. . . . . . . . . . . . . . . . . . . . . . . . . 55
SAP HANA Lifecycle Manager does not accept the SAP Lumira Server installation package. . . . . . . 56
SAP HANA Lifecycle Manager displays an error when trying to deploy content. . . . . . . . . . . . . . . . . 56
Cannot connect to SAP Lumira Server after a successful deployment to SAP HANA on Amazon
Web Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
The web page is not found (404 error) when accessing the SAP Lumira Server or SAP HANA
Extended Application Services administration pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
When trying to publish from SAP Lumira to SAP Lumira Server, the message Not available is
displayed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
SAP Lumira Server installation may not succeed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
13.6
Using SAP HANA Studio to manage roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59
14
Getting support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Content
Document History
The following table provides an overview of the most important document changes.
Table 1:
Version
Date
SAP Lumira Server Instal September,

lation Guide v 1.19
2014
SAP Lumira Server Instal October, 2014

lation Guide v 1.20.
SAP Lumira Server Instal Dec, 2014

SAP Lumira Server Instal Jan, 2015

SAP Lumira Server Instal Feb, 2015

SAP Lumira Server Instal April, 2015
Description
Added the sections Variables, Required information, and Required compo

nents.
Removed requirement for SAP UI5 downgrade. SAP Fiori launchpad is now
compatible with the version of SAP UI5 that is included with SAP HANA Sup
port Package 08 Revision 82.
Added section To download SAPCAR. You must use release 720 or later.
Updated version numbers for SAP HANA, SAP Lumira Server, and SAL AFL.
Added the section Using SAP HANA to specify the roles available for sharing.
Added a note that you must use the SAP HANA version of SAP Fiori to config
ure SAP Lumira Server.
Added instructions for installing SAP Lumira Server using SAP HANA
Application Lifecycle Management tool (HALM).
Added instructions for using the Universal Analytics Application Function Li

brary
Added the section List of steps for installing SAP Lumira
Added section To assign catalog privileges to roles.
Added section To install or upgrade SAP Lumira Server using HALM Web Ad
ministration tool.
HLM is no longer supported for installing SAP Lumira Server. Use HALM in
stead.
SAL AFL, an SAP HANA library, is no longer supported. Uninstall SAL AFL
and install UAL AFL.
Added a section on updating the SAP Lumira Server database schema. This
procedure must be done when upgrading SAP Lumira Server from version
(1.23) or earlier to version 1.25 (or later).
Removed section To enable the Discover feature for SAP HANA Support
Package 09. This configuration step is done automatically in 1.25 and later re
leases.

Document History
Getting Started
This section helps you gather the information you need to install and configure SAP Lumira Server, then explains
how to verify your deployment environment.
2.1
Variables
The following variables are used in this document:

Table 2:
Variable
Definition
<INSTANCE>
The instance number of your SAP HANA system.
<SID>
SAP HANA System ID.
<HOSTNAME>
The name or IP address of the machine where SAP HANA is

installed.
<INSTALL_DIR>
The installation directory for SAP HANA. Default is /hana/
shared/.
2.2
Required information
This section lists the information you need in order to install and configure SAP Lumira Server. We recommend
you print this page and add the values from your deployment so you can refer to it during installation.
Table 3:
Item
Example
SAP HANA Instance number
00
Your value
The instance number is created when SAP HANA is

installed. You can have more than one instance on a
single machine.
SAP System ID (SID)
DB1
The system ID is created when SAP HANA is installed.
<SID>adm username and password
db1adm
The system administrator account is created when

SAP HANA is installed.

Getting Started
Item
Example
Your value
Password for the SYSTEM user
not applicable
You may not want to write the password

down, but you need to know it.
The SYSTEM user is the database super user created

when SAP HANA is installed. The username is
SYSTEM and the password is set during installation.

Machine name and IP address of the host machine
where SAP HANA is installed
MYSERVER
User accounts created for SAP Lumira

You will create these user accounts during the configuration process. You can record them here for your
convenience.
Table 4:
User account
Description
SAP Lumira Server configuration user. For

example, LUMIRACONFIG.
The configuration user has the
Your values
sap.bi.admin::BI_CONFIGURA
TOR role and has the rights to config
SAP Lumira Server technical user. For exam

ple, LUMIRATECH.
The technical user is used by SAP

Lumira Server to communicate with
the SAP HANA database, and should
not be used for other purposes. A
technical user account is used by a
process, not by a person.
SAP Lumira Server data consumer user.
The data consumer user has the
sap.bi.common::BI_DATA_CON
SUMER role, and is an end user of SAP
Lumira Server.
SAP Lumira Server analyst user
The analyst user has the
sap.bi.common::BI_DATA_ANA
LYST role, which includes the
SUMER role plus the right to publish a
dataset from SAP Lumira (desktop).
This user is a data analyst end user of
SAP Lumira Server.

Getting Started
User account
Description
Your values
Chart extension manager
The chart extension manager user has

the sap.bi.admin::BI_ADMIN
role and has permissions to manage
chart extensions.

Getting Started
Required Components
3.1
Summary of required components
Before installing SAP Lumira Server onto your SAP HANA server for the first time, ensure that your deployment
environment meets these requirements. For more details, refer to the SAP Product Availability Matrix (PAM) for
SAP Lumira Server by visiting https://support.sap.com/pam , then searching for Lumira Server.
Note
The SAP HANA Self-Service Analytics Application Function Library (SAL AFL) is no longer supported. If this
library exists on your SAP HANA system, you must uninstall it, then install the Universal Analytics
Application Function Library (UAL AFL).
If SAP Lumira Server is installed on SAP HANA Support Package 08 and you are upgrading to SAP HANA
Support Package 09, see SAP Notes 2108725
and 2118990 .
If you upgrade SAP HANA Support Package 08 to SAP HANA Support Package 09 without following the
instructions in 2118990 , and then upgrade SAP Lumira Server, your deployment may encounter issues.
To resolve these issues, see 2124824
Table 5:
Component
SAP HANA
Supported version(s)
Support Package
08 Revision 82, 83,
84, or 85
For information
about Support
Package 09, see
the SAP PAM for
Lumira Server at
https://
support.sap.com/
pam
Universal Analytics Application Function

Library (UAL AFL)
Notes
The XS Engine must be installed on SAP HANA.
UAL AFL must be installed on your SAP HANA

server.
The SAP HANA Self-Service Analytics Application

Function Library (SAL AFL) is no longer supported.
Version 1.304
Note
If SAL AFL is installed on your SAP HANA server,
you must remove it before installing UAL AFL.

Required Components
Component
Supported version(s)
Notes
SAP HANA Client
The version of SAP

HANA client must
match the version
of SAP HANA.
The SAP HANA Client must be installed on your cli

ent machine. It contains SAP HANA Application Life
cycle Management (HALM), which replaces SAP
HANA Lifecycle Manager (HLM).
SAP HANA Studio
The version of SAP

HANA Studio must
match the version
of SAP HANA.
SAP HANA Studio must be installed on the client

machine, and must be able to connect to your SAP
HANA system.
Note
The versions of SAP HANA Client and SAP HANA Studio must match the version of SAP HANA. For example, if
you are using SAP HANA revision 85, you must use revision 85 of SAP HANA Client and SAP HANA Studio.
3.2
SAP HANA requirements
Ensure you are using a supported version of SAP HANA.

SAP HANA uses the secure sockets layer (SSL) protocol to ensure secure communications between individual
components and client connections. For this reason, we recommend you configure HTTPS (SSL) for client
application access to prevent interception of user names and passwords when connecting to SAP HANA with SAP
Lumira Server. For configuration details, refer to the section on Securing Data Communication in the SAP HANA
Security Guide.
Verifying the version of SAP HANA

Use this command to check your version of SAP HANA:
/usr/sap/<SID>/HDB<INSTANCE>/HDB version
Example:
MYSERVER:/usr/sap/DB1/HDB00 # su db1adm
MYSERVER:/usr/sap/DB1/HDB00> ./HDB version
HDB version info:
version:
1.00.84.00.XXXXXX
Downloading a new version of SAP HANA

Use the following path to download a new version of SAP HANA from the SAP Service Marketplace:
Software Download Center

Required Components
Support Packages and Patches
A - Z Index
SAP
SAP HANA Platform Edition
SAP HANA Platform Edit. 1.0
Entry by Component
HANA Database
SAP HANA DATABASE 1.00
Linux on
x86_64 64bit .
Note
In order to run SAP HANA Revision 80 or higher on SLES 11, additional operating system software packages are
required. See SAP Note 2001528 .
Ensure the SAP HANA processes are running

The SAP HANA server must be running in order to install SAP Lumira Server, but it may not be configured to start
up when the host machine is restarted. Run this command as the <SID>adm user to see which SAP HANA
processes are running:
/usr/sap/<SID>/HDB<INSTANCE>/HDB info
For example:
MYSERVER:/usr/sap/DB1/HDB00 # su db1adm
MYSERVER:/usr/sap/DB1/HDB00> ./HDB info
USER
PID
PPID %CPU
VSZ
RSS COMMAND
db1adm
110461 110460 0.1 13912 2772 -sh
db1adm
110595 110461 12.5 12900 1728 \_ /bin/sh ./HDB info
db1adm
110618 110595 0.0
4972
864
\_ ps fx -U db1adm -o
user,pid,ppid,pcpu,vsz,rss,args
db1adm
14251
1 0.0 21992 1512 sapstart pf=/C08_nfs/C08/profile/
C08_HDB08_vanpglnxc52b3
db1adm
14262 14251 0.0 829328 303828 \_ /usr/sap/C08/HDB08/vanpglnxc52b3/
trace/hdb.sapC08_HDB08 -d -nw -f /usr/sap/C08/HDB08/vanpglnxc52b3/daemon.ini
pf=/usr/sap/C08/SYS/profile/C08_HDB08_vanpglnxc52b3
db1adm
14278 14262 0.3 12223100 933644
\_ hdbnameserver
db1adm
14311 14262 0.2 13089172 5561836
\_ hdbpreprocessor
db1adm
14314 14262 0.0 11678104 700712
\_ hdbcompileserver
db1adm
14342 14262 7.3 14742528 4603556
\_ hdbscriptserver
db1adm
14345 14262 7.5 17092972 5342528
\_ hdbxsengine
db1adm
15183 14262 0.0 339368 79876
\_ sapwebdisp_hdb pf=/usr/sap/C08/
HDB08/vanpglnxc52b3/wdisp/sapwebdisp.pfl -f /usr/sap/C08/HDB08/vanpglnxc52b3/trace/
dev_webdisp
db1adm
73042 14262 13.0 21081684 10295188
\_ hdbindexserver
db1adm
13551
1 0.0 286416 90684 /usr/sap/C08/HDB08/exe/sapstartsrv pf=/
C08_nfs/C08/profile/C08_HDB08_vanpglnxc52b3 -D
3.3
XS Engine requirements
The XS Engine must be installed and running. It is typically installed together with SAP HANA.
10

Required Components
Verifying the installation of XS Engine

Enter the following URL in a browser to launch the XS administration application:
http://<HOSTNAME>:80<INSTANCE>/sap/hana/xs/admin/
Example:
http://MYSERVER:8000/sap/hana/xs/admin/
3.4
SAP HANA Client requirements
The SAP HANA Client contains the SAP HANA Application Lifecycle Management tool (HALM), which is required
to install SAP Lumira Server. You must install the SAP HANA Client on your client machine. The version of SAP
HANA Client must match the version of SAP HANA.
For more information, see the SAP HANA Client Installation and Update Guide.
3.5
Universal Analytics Application Function Library (UAL

AFL) requirements
If SAL AFL is installed on your SAP HANA server, you must uninstall it before installing UAL AFL. See To uninstall
SAL AFL [page 17].
Verifying the version of UAL AFL:

Use this command to check the version of UAL AFL:
cat /usr/sap/<SID>/HDB<INSTANCE>/exe/plugins/sap_afl_sdk_ual/manifest
Example:
MYSERVER #:cat /usr/sap/DB1/HDB00/exe/plugins/sap_afl_sdk_ual/manifest
ap_afl_sdk_ual/manifest
...
release: 1.303
...
Note
The version in this example may be different from the version that is required by your installation of SAP
Lumira Server. Use the version specified in Summary of required components [page 8].

Required Components
11
Downloading a new version of UAL AFL

Use the following path to download a new version of UAL AFL from the SAP Service Marketplace:
Download Center
Comprised Software Component Versions
A - Z Index
SAP Lumira Server
Universal Analytics AFL 1.0
SAP Software
SAP Lumira Server 1
Linux on x86_64 64bit
For help installing this component, see To install the Universal Analytics Application Function Library (UAL AFL)
[page 17].
3.6
SAP HANA Studio requirements
SAP HANA Studio must be installed on the client machine, and must be able to connect to the SAP HANA system
where you are installing SAP Lumira Server. The version of SAP HANA Studio must match the version of SAP
HANA.
Verifying the version of SAP HANA Studio

Launch SAP HANA Studio and select
version.
Help
About SAP HANA Studio
and ensure you have the correct
To ensure you can connect to your SAP HANA system, right-click the Systems panel and select Refresh. The
details of your SAP HANA system should be refreshed. If your SAP HANA system is not listed in the Systems
pane, you can add it by selecting the Add Systems icon.
Downloading a new version of SAP HANA Studio

Use the following path to download a new version of SAP HANA Studio from the SAP Service Marketplace:
Software Download Center
SAP HANA Platform Edit. 1.0
12

Entry by Component
A - Z Index
SAP
SAP HANA Platform Edition
HANA Studio .

Required Components
List of steps for installing SAP Lumira

Server
This section explains the required steps for each supported installation option. Steps are provided for both new
installations and upgrade installations.
4.1
List of steps for a new installation
Table 6:
Step
Description
Install a supported version of SAP HANA with the XS en
SAP HANA requirements [page 9].
gine and UAL AFL according to your deployment environ
XS Engine requirements [page 10].
ment.
Universal Analytics Application

Function Library (UAL AFL) require
ments [page 11].
To install the Universal Analytics Ap

plication Function Library (UAL AFL)
[page 17].
SAP HANA Client requirements

[page 11].
SAP HANA Studio requirements

[page 12].
To install or upgrade SAP Lumira

Server using HALM command line
[page 21], or

Server using HALM Web Administra
tion tool [page 24].
Link to Information
Install SAP HANA Client (which contains HALM) and SAP

HANA Studio on the client machine.
Install SAP Lumira Server.
If you are using SAP HANA Support Package 09, grant the
SAP Fiori catalog privileges to the SAP HANA user roles.
See To assign catalog privileges to

roles (SAP HANA SP09 and later)
[page 25].
Create administration users.
See To create administration users

[page 29].
Prepare SAP Lumira Server for configuration.
See To prepare SAP Lumira Server

for configuration [page 30].
Configure SAP Lumira.
See To configure SAP Lumira Server

[page 32].

List of steps for installing SAP Lumira Server
13
4.2
List of steps for an upgrade installation
If you have an existing installation of SAP Lumira Server that you want to upgrade, you must check if the SelfService Analytics Application Function Library (SAL AFL) is installed on your SAP HANA machine. If so, you must
uninstall SAL AFL and install the Universal Analytics Application Function Library (UAL AFL).
Note
This document does not explain how to perform an upgrade to SAP HANA Support Package 09 if SAP
Lumira Server is already installed. See 2108725
for information.
If you are installing SAP Lumira Server into a clustered SAP HANA environment, where a primary SAP
HANA system has been replicated to create a secondary SAP HANA system, see SAP Note 2124346
for
special instructions.
Table 7:
Step
Description
Stop all required background jobs.
See Stopping background jobs

[page 19].
If SAL AFL is installed on your SAP HANA machine, uninstall SAL

AFL.
See To uninstall SAL AFL [page

17].
Optional. Upgrade the version of SAP HANA. You can stay on the
same version of SAP HANA as long as it is supported for this ver
sion of SAP Lumira Server.
See the SAP HANA Server installa

tion guide.
See To install the Universal Analyt

ics Application Function Library
(UAL AFL) [page 17].
Link to information
This document does not explain how to perform an upgrade to

SAP HANA Support Package 09 if SAP Lumira Server is already
installed. See 2108725
for information.
Install UAL AFL.
Update the SAP Lumira Server database schema.
See Updating the SAP Lumira Server da

tabase schema [page 20].
Install SAP Lumira Server.
See To install or upgrade SAP Lu

mira Server using HALM command
line [page 21], or

Server using HALM Web Adminis
tration tool [page 24]
If you are using SAP HANA Support Package 09, grant the SAP
Fiori catalog privileges to the SAP HANA user roles.
See To assign catalog privileges to

roles (SAP HANA SP09 and later)
[page 25].
Create administration users.
See To create administration users

[page 29].
14

Step
Description
Prepare SAP Lumira Server for configuration.
See To prepare SAP Lumira Server

for configuration [page 30].
10
Configure SAP Lumira.
See To configure SAP Lumira

Server [page 32].

Link to information
15
Installing SAP HANA components
This section explains how to upgrade or install some of the required components.
5.1
To download SAPCAR
Context
If you downloaded .sar packages from SAP Service Marketplace, you will need SAPCAR to extract them.
Procedure
1. Download SAPCAR from SAP Service Marketplace to a temporary directory on your SAP HANA machine.
Use the following path in the SAP Service Marketplace:
and Patches
A - Z Index
sapcar
(latest version)
SAP Software Download Center
Support Packages
Linux on x86_64 64bit .
Note
The directory name cannot contain a space or the extraction may fail.
2. To make SAPCAR easier to use, you can rename it. For example:
mv SAPCAR_315-20010450.EXE SAPCAR
3. If necessary, give yourself permissions to execute SAPCAR. For example:
chmod 777 SAPCAR
Results
You are ready to use SAPCAR to install SAP HANA components.
16

5.2
To uninstall SAL AFL
Context
You cannot install UAL AFL on an SAP HANA server that has SAL AFL installed.
To see if SAL AFL is installed, run the following command:
ls -la /usr/sap/<SID>/HDB<INSTANCE>/exe/plugins
If the resulting listing contains a plugin with the string sal_ in its name, then SAL AFL is installed.
Example:
MYSERVER:/hana/shared/DB1/hdblcm # ls -la /usr/sap/DB1/HDB00/exe/plugins
total 16
lrwxrwxrwx 1 db1adm sapsys
43 Jul 11 11:50 sal -> ../../plugins/sal_1.00.84.0
In this example, SAL AFL is installed.
Procedure
Instructions for uninstalling SAL AFL are in the SAP Note 2103854 . Uninstalling SAL AFL is a prerequisite for
installing UAL AFL, so the instructions to uninstall are contained in this SAP Note.
5.3
To install the Universal Analytics Application Function

Library (UAL AFL)
Prerequisites
Ensure you have downloaded the Universal Analytics AFL package from the SAP Service Marketplace to a
temporary directory on your SAP HANA machine. See Universal Analytics Application Function Library (UAL
AFL) requirements [page 11].
Ensure SAL AFL is not installed on your SAP HANA system. See To uninstall SAL AFL [page 17].
You must run these instructions as the root user.
Procedure
Instructions for installing UAL AFL are in the SAP Note 2103854
installing UAL AFL.

. Refer to this information for instructions on
17
Results
The Universal Analytics AFL is installed. To verify the installation, wait until the SAP HANA server has restarted,
then use SAP HANA Studio and ensure the plugin SAP_AFL_SDK_UAL is listed under Installed Plug-ins.
18

Installing and configuring SAP Lumira

Server
We recommend that you follow the steps listed in List of steps for installing SAP Lumira Server [page 13]. Chose
the steps for the type of installation or upgrade you are performing.
6.1
Stopping background jobs
Context
If you are performing an upgrade, first turn off all background jobs.
Procedure
1. Access the SAP HANA XS Administration Tool in a browser.
2. Log in as the a user with the sap.hana.xs.admin.roles::JobAdministrator role. You may have to use
SAP HANA Studio to add this role to an existing user, or to create a user with this role granted.
3. Navigate to sap bi discover
remainder of these steps.
logic
vizd
backgroundjobs . If there are no job files, you can skip the
4. Choose a job file.

For example choose VDSchedulerJob_1, VDSchedulerJob_2 or VDSchedulerJob_3 .
5. Deselect the Active box, and then click Save.
6. Repeat steps d and e for all job files.
Results
All background jobs are turned off.

Installing and configuring SAP Lumira Server
19
6.2
Updating the SAP Lumira Server database schema
Prerequisites
We recommend that you back up the SAP HANA database before updating the SAP Lumira Server database
schema. For more details, see the system backup information in the SAP HANA Administration Guide at http://
help.sap.com/hana.
Context
The SAP HANA database schema for SAP Lumira Server was modified in the 1.25 release. If you have an SAP
HANA machine with SAP Lumira Server 1.23 or earlier, you must manually update the database schema when
upgrading to SAP Lumira 1.25 or later.
You do not need to update the database schema for a new installation of SAP Lumira Server.
You do not need to update the database schema for subsequent upgrades of SAP Lumira Server. For example, if
you update the database schema when upgrading from SAP Lumira Server 1.23 to SAP Lumira Server 1.25, you
do not need to update the database schema when upgrading from SAP Lumira Server 1.25 to SAP Lumira Server
1.26.
Note
You can choose to update the database schema before or after upgrading SAP Lumira Server. The SQL
commands are different for each scenario, as noted in the instructions below.
Procedure
1. In SAP HANA Studio, open the SQL console for your SAP HANA system.
a. Select the system in the Systems view.
b. Select Open SQL for the selected system.
For more information on using the SQL console, see Execute SQL Statements in SAP HANA Studio at http://
help.sap.com/saphelp_hanaplatform/helpdata/en/c0/c984fbbb5710149c7be707c74ad231/content.htm.
2. In the SQL console, enter one of the following sets of SQL statements:
To update the database schema before upgrading SAP Lumira Server:
ALTER TABLE "SAP_BI_DISCOVER"."sap.bi.da.db.tables::COLUMN_MASTER" ALTER TYPE
COLUMN;
ALTER TABLE "SAP_BI_DISCOVER"."sap.bi.da.db.tables::DATASET_MASTER" ALTER
TYPE COLUMN;
ALTER TABLE "SAP_BI_DISCOVER"."sap.bi.discover.db.tables::SEARCH_HISTORY"
ALTER TYPE COLUMN;
DROP TABLE
"SAP_BI_DISCOVER"."sap.bi.discover.db.tables::SEARCH_HISTORY_TEMPORARY";
20

Or, to update the database schema after upgrading SAP Lumira Server:
ALTER TABLE "SAP_BI_DISCOVER"."sap.bi.da.db.tables::COLUMN_MASTER" ALTER TYPE
COLUMN;
ALTER TABLE "SAP_BI_DISCOVER"."sap.bi.da.db.tables::COLUMN_MASTER" ALTER
("USER_ID" BIGINT);
TYPE COLUMN;
("USER_ID" BIGINT);
ALTER TABLE "SAP_BI_DISCOVER"."sap.bi.discover.db.tables::SEARCH_HISTORY"
ALTER TYPE COLUMN;
ALTER TABLE
"SAP_BI_DISCOVER"."sap.bi.discover.db.tables::SEARCH_HISTORY"ALTER ("USER_ID"
BIGINT);
DROP TABLE
"SAP_BI_DISCOVER"."sap.bi.discover.db.tables::SEARCH_HISTORY_TEMPORARY";
3. Execute the statement.
Example
6.3
To install or upgrade SAP Lumira Server using HALM

command line
Prerequisites
Your deployment environment must meet the requirements listed in Summary of required components [page
8].
The SAP HANA user who is running the installation must have the role
sap.hana.xs.lm.roles::Administrator. You may have to use SAP HANA Studio to add this role to an
existing user, or to create a user with this role granted.
Context
HALM is part of SAP HANA client, so run it from the client machine.

21
Note
HALM does not verify the version of required components before installation. Ensure you are using supported
versions of the components.
Procedure
1. Download the latest version of SAP Lumira Server from the SAP Service Marketplace.
Download the deployment package to the machine where SAP HANA Client is installed, or to a machine with
network access to it. Use the following path:
Upgrades
A - Z Index
SAP Lumira Server
SAP Lumira Server 1
Installations and
Installation and
Upgrade .
The deployment package is available as a .zip file for all platforms.
2. On the client machine, open a Command Prompt window.
In Windows, you may want to open the Command Prompt window in Administrator mode. This gives the
HALM tool the necessary permissions to write log files to the required directory. To open the Command
Prompt window in Administrator mode:
a. Select
Start
All Programs
Accessories .
b. Right-click Command Prompt then select Run as administrator.

3. In the Command Prompt window, navigate to the directory containing the SAP HANA Client.
On a Windows machine, the default directory is C:\Program Files\sap\hdbclient.
4. You can set the environment variables globally, or enter them as command-line parameters when running
HALM:
Table 8:
Environment variable
Command-line parameter
Description
HDBALM_USER
-u <USER>
SAP HANA user that will run the installation. This

user must have the
sap.hana.xs.lm.roles::Administrator
role.
HDBALM_PASSWD
Cannot be passed on the command

line. If you do not set this globally,
you will be prompted during installa
tion or update.
Password for the SAP HANA user account.
HDBALM_HOST
-h <HOSTNAME>
IP address or host name of the SAP HANA system

where you want to install SAP Lumira Server.
HDBALM_PORT
-p <PORT>
80<INSTANCE> .
For example, to set the environment variables globally on a Windows machine where the instance number of
the SAP HANA system is 00:
set HDBALM_USER=SYSTEM
set HDBALM_PASSWD=MyPassword1
22

set HDBALM_HOST=10.160.15.50
set HDBALM_PORT=8000
5. Run the following command to install or update SAP Lumira Server. If you did not set the required
environment variables globally, you must enter them as command-line parameters.
Note
Use the same command for both new installations and upgrade installations. HALM will detect any
previous SAP Lumira Server installation, and will automatically perform the required steps to upgrade the
software.
With environment variables set:
hdbalm install <ZIP_PATH>
Using command-line parameters:
hdbalm install <parameters> <ZIP_PATH>
Where <ZIP_PATH> is the path to the SAP Lumira Server deployment package, including the package name.
For example, to run an installation or an update from a Windows machine with the environment variables set
globally:
C:\Program Files\sap\hdbclient hdbalm install c:\download
\SAP_LUMIRA_SERVER_DVD_1.zip
For example, to run an installation or an update on a Windows machine using command-line parameters:
C:\Program Files\sap\hdbclient hdbalm -u myUser h 10.133.25.19 p 8000 install
C:\tempupdate\DATA_UNITS\SAP_LUMIRA_SERVER_1\SAP_LUMIRA_SERVER_DVD_1.zip
Tip
The following commands give you more information on the hdbalm command:
hdbalm help
hdbalm help install
Results
SAP Lumira Server is installed.
Next Steps
You must create administration users and configure SAP Lumira Server before using it for the first time. See To
create administration users [page 29].

23
6.4
To install or upgrade SAP Lumira Server using HALM

Web Administration tool
SAP HANA Application Lifecycle Management tool (HALM) has a web administration tool and a command-line
tool. This section explains how to use the web administration tool.
Prerequisites
Your deployment environment must meet the requirements listed in Summary of required components [page
8].
The SAP HANA user who is running the installation must have the role
sap.hana.xs.lm.roles::Administrator. You may have to use SAP HANA Studio to add this role to an
existing user, or create a user with this role granted.
Note
HALM does not verify the version of required components before installation. Ensure you are using supported
versions of the components.
Procedure
1. Download the latest version of SAP Lumira Server from the SAP Service Marketplace.
Download the deployment package to the SAP HANA machine or to a machine with network access to it. Use
the following path for the download:
Z Index
SAP Lumira Server

SAP Lumira Server 1
Installations and Upgrades
A-
Installation .
The deployment package is available as a .zip file for all platforms.

2. Extract the .zip file to a temporary folder.
A folder structure that contains the file \DATA_UNITS
\SAP_LUMIRA_SERVER_1\LUMIRASERVER<Version>_0.SAR is created, where <Version> is replaced by
the version number of the file.
3. Extract the LUMIRASERVER<Version>_0.SAR file to another temporary folder.
A .tgz file is extracted; example, lumiraserver.tgz.
4. Open the HALM web administration tool by entering the following URL in your browser:
http://<HOSTNAME>:80<INSTANCE>/sap/hana/xs/lm
5. Log in to the HALM web administration tool. Use an account that has the
sap.hana.xs.lm.roles::Administrator role.
6. Use the procedure in this step for SAP HANA SP 08. For SAP HANA SP 09, use the procedure in the next step.
a. Select the Import tile.
b. Navigate to the folder containing the .tgz file and select it.
24

c. Select Import Delivery Unit from File then confirm the import.
7. Use the procedure in this step for SAP HANA SP 09. For SAP HANA SP 08, use the procedure in the previous
step.
a. Select the Delivery Units tile.
b. Select the Import button.
c. Navigate to the folder containing the .tgz file and select it.
d. Select Import.
8. For both SAP HANA SP08 and SAP HANA sp09, wait until the import operation is finished.
Results
SAP Lumira Server is installed.
Next Steps
You must create administration users and configure SAP Lumira Server before using it for the first time. See To
create administration users [page 29].
6.5
To assign catalog privileges to roles (SAP HANA SP09

and later)
Prerequisites
Note
This step is required for SAP HANA Support Package 9 and later releases. It is not required for earlier versions
of SAP HANA.
A user account with the following roles must exist. You can use SAP HANA Studio to add these roles to an
existing user, or you can create a new user with these roles assigned.
sap.hana.uis.db::SITE_DESIGNER
sap.hana.admin.roles::Monitoring OR sap.hana.admin.roles::Administrator

25
Context
SAP Fiori is used to configure SAP Lumira Server. You must grant the SAP Fiori catalog privileges to the SAP
HANA user roles before performing the configuration. The following roles must be granted read privileges on the
specified SAP Fiori catalogs:
Table 9:
Role
SAP Fiori Catalog
Why the privilege is required
sap.bi.admin::BI_CONFIGURAT
OR
SAP Lumira Administration with the role
The configuration user, for example

LUMIRACONFIG, must have this privi
sap.bi.admin::BI_ADMIN
sap.bi.admin.configcatalog:
AdminConfig
SAP Lumira Administration with the id
sap.bi.admin.catalog:AdminE
xtensions
sap.bi.common::BI_DATA_CONS
UMER
SAP Lumira
lege in order to use SAP Fiori to config

A user must have this privilege in order
to add the Manage Lumira Extensions tile
to SAP Fiori.
End users must have this privilege in or
der to access SAP Lumira content from
the Fiori Launchpad using either the
Lumira Server static tile or the All Stories
Lumira Server dynamic tile.
For example, the sap.bi.admin::BI_CONFIGURATOR role must be granted privileges on the SAP Lumira
Administration catalog. This gives the configuration user the right to access SAP Fiori.
Procedure
1. Follow these steps for each role listed in the table above.
2. Open the Role Assignment application by entering the following URL in your browser:
http://<HOSTNAME>:80<INSTANCE>/sap/hana/uis/clients/role-editor/RoleEditor.html?
scenario=onPremise
3. Log in to the Role Assignment application. Use an account that has the roles specified in the Prerequisites
section.
The Role Assignment application opens. The side panel displays a list of the roles available in your SAP HANA
system, and the center area displays the catalogs assigned the currently selected role.
4. Search for the required role, for example sap.bi.admin::BI_CONFIGURATOR.
5. Select the role, then select "+" to search for the required catalog.
26

For example, if you have selected the sap.bi.admin::BI_CONFIGURATOR role, you would search for the
SAP Lumira Administration catalog, as listed in the table above.
If two catalogs with the name SAP Lumira Administration appear, select both. You can remove the role that is
not required in the next step.

27
6. Add the catalog(s) to the required role.

7. Once the catalog is added to the role, you can see the catalog ID and the catalog privileges that are added. If
necessary, remove the catalog that is not required. For example, the sap.bi.admin::BI_CONFIGURATOR
role only requires the catalog SAP Lumira Administration with the ID
sap.bi.admin.configcatalog:AdminConfig:
28

8. Repeat this procedure for each of the roles listed in the table above.
9. Close the Role Assignment application.
Results
The roles now have sufficient privileges to allow configuration of SAP Lumira Server.
Next Steps
Create administration users with sufficient roles to configure SAP Lumira Server. See To create administration
users [page 29]
6.6
To create administration users
Prerequisites
SAP Lumira Server must be installed on your SAP HANA server.
If you are using SAP HANA Support Package 09, the SAP HANA roles must have sufficient privileges. See To
assign catalog privileges to roles (SAP HANA SP09 and later) [page 25].
Context
Create the following user accounts. These user accounts will be used to administer and configure SAP Lumira
Server.

29
Table 10:
User account description
Example
Required roles
Account used to configure SAP Lumira

Server.
LUMIRACONFIG
sap.bi.admin::BI_CONFIGURATOR
Technical user account that SAP Lumira

Server uses to contact SAP HANA. This
account should not be used by a person.
LUMIRATECH
sap.bi.common::BI_TECH_USER
We recommend that you print the section Required information [page 5] and use it to record the user accounts
that you create in this section.
Procedure
1. Create a configuration user for SAP Lumira Server.
a. In SAP HANA Studio, create a new user. For example, the user may be called LUMIRACONFIG.
b. Assign the sap.bi.admin::BI_CONFIGURATOR role to LUMIRACONFIG.
2. Create a technical user for SAP Lumira Server. For example, the user may be called LUMIRATECH.
a. In SAP Hana Studio, create a new user called LUMIRATECH.
b. Assign the sap.bi.common::BI_TECH_USER role to LUMIRATECH.
c. To test the newly created technical user, log in as LUMIRATECH using the SAP HANA XS URL below.
Ensure that it is working correctly, and then log out before continuing.
http://<HOSTNAME>:80<INSTANCE>/sap/hana/xs/formLogin/
Next Steps
Prepare SAP Lumira Server for configuration. See To prepare SAP Lumira Server for configuration [page 30].
6.7
To prepare SAP Lumira Server for configuration
Prerequisites
A user account with the sap.bi.admin::BI_CONFIGURATOR role must exist, for example LUMIRACONFIG. See
To create administration users [page 29].
30

Context
You must configure SAP Lumira server before using it for the first time. To perform the configuration, use the SAP
Lumira Server configuration tile in the SAP Fiori application that is included with SAP HANA.
Procedure
1. Launch SAP Fiori on your SAP HANA system:
http://<HOSTNAME>:80<INSTANCE>/sap/bi/launchpad/fiori
For example,
http://MyHanaServer:8000/sap/bi/launchpad/fiori
Note
SAP Fiori is included with SAP HANA and no additional installation is required.
The SAP Fiori URL may have be customized by the SAP HANA administrator.
You must use the SAP HANA version of SAP Fiori to perform the configuration. The ABAP version will
not work.
2. Log on to SAP Fiori with the SAP Lumira Server configuration user, for example LUMIRACONFIG.
3.
4.
Click the symbol at the upper-left corner of the SAP Fiori launchpad, and click Tile Catalog to open the
Tile Catalog. In the SAP Lumira Administration section of the catalog, click the + symbol below Configuration,
select My Home, then click OK .
Click Go Back to return to the SAP Fiori launchpad.
Results
The Configuration tile for SAP Lumira Server appears in the SAP Fiori launchpad under My Home.
Next Steps
Configure SAP Lumira Server. See To configure SAP Lumira Server [page 32].

31
6.8
To configure SAP Lumira Server
Prerequisites
You must use a SAP Lumira user assigned to the sap.bi.admin::BI_CONFIGURATOR role, for example
LUMIRACONFIG.
A technical user assigned to the role sap.bi.common::BI_TECH_USER must exist, for example
LUMIRATECH. See To create administration users [page 29].
The configuration tile must be added to your SAP Fiori launchpad. See To prepare SAP Lumira Server for
configuration [page 30].
Context
The SAP Fiori configuration application sets all required SQL connections between your SAP HANA database and
SAP Lumira Server. The application also enables the job scheduler, script service, and assigns the technical user
the rights required for all features.
Note
The SQL connection configuration (SQLCC) file on the SAP HANA XS server is modified automatically by the
application.
The following features must be configured in the application:
Publishing - Allow users to publish stories from SAP Lumira to SAP Lumira Server.
Extensions - Enable the consumption of third-party chart extensions.
Self-service Analytics - Set the SQL connections between the SAP HANA repository and SAP Lumira Server.
Discover - Enable a job scheduler to automatically provision datasets as a background task, reducing the wait
time when generating related visualizations.
Data Acquisition - Allow users to create datasets from CSV and XLSX files.
Procedure
1. Log on to SAP Fiori with the LUMIRACONFIG user.
For example,
http://MyHanaServer:8000/sap/bi/launchpad/fiori
2. Click the Configuration tile with the description SAP Lumira Server.
3. Ensure the Use the same user for all rights assignments box is selected.
4. Enter LUMIRATECH in the Enter technical user field. For SAP HANA Support Package 09 deployments, enter
the LUMIRATECH user's password into the password field.
32

Replace LUMIRATECH with the name of the technical user you created. For a new installation, all features will
be in the unconfigured state.
Note
All features must be assigned a technical user.
A different technical user may be used for each feature. To add a different technical user, deselect the
Use the same name for all rights assignments box, and then edit the user name associated with a
feature. With SAP HANA Support Package 09, you must specify the password for the user assigned to
the Discover feature in order to configure the feature.
5. If you are using SAP HANA Support Package 09, in the Password field, enter the password for the user that is
assigned to the Discover feature.
6. Click Run Configuration in the bottom right of the screen.
Results
The correct rights and roles will be assigned to the technical user for all features.
You can reassign users on configured features. To reconfigure SAP Lumira Server, deselect the Use the same
name for all rights assignments box, edit the user name associated with a feature, type a password for the user
assigned to the Discover feature if necessary, and then click Run Configuration.
Next Steps
Configure end users and log in to SAP Lumira Server. See Creating users [page 34]
Related Information
Working with SAP Fiori [page 50]
SQL setup on SAP HANA [page 54]

33
Creating users
SAP Lumira Server users must be assigned rights and roles on the SAP HANA system in order to view and publish
stories or datasets. Users must also be created to perform extension management and configuration.
7.1
User rights and roles
End users of SAP Lumira Server must be assigned to one of the following SAP HANA roles. For a summary of all
users created during installation and configuration, see Required information [page 5].
Table 11:
User Roles
Description
SUMER
A user assigned to BI_DATA_CONSUMER is granted permission to view stories.

BI_DATA_CONSUMER includes the role sap.bi.sa::BI_SA_PRIV, which allows
users to retrieve data and metadata.
Note
In order to improve HANA SPS08 performances, you can optionally set the follow
ing application privilege:
CALL
_SYS_REPO.GRANT_APPLICATION_PRIVILEGE(sap.bi.sa::SA
_EXECUTE, UPPER('<user>));
To revoke an application privilege:
CALL
_SYS_REPO.REVOKE_APPLICATION_PRIVILEGE(sap.bi.sa::S
A_EXECUTE', UPPER('<user>));
For more information see the SAP HANA Security Guide.
sap.bi.common::BI_DATA_ANA
LYST
A user assigned to this role is granted the same permissions as the
BI_DATA_CONSUMER plus the ability to publish a dataset from SAP Lumira.
Note
This role has similar rights to the standard MODELING role in SAP HANA. For
more information see the SAP HANA Security Guide.
sap.bi.admin::BI_ADMIN
A user must be granted this role to manage chart extensions.
Users can be created and assigned to roles in SAP HANA Studio. In addition, end users must be granted sufficient
permissions to select data in analytic and calculation views they need to access in SAP Lumira Server.
34

Creating users
Note
Assigning both the roles BI_DATA_CONSUMER and BI_DATA_ANALYST to the user is not recommended.
Restricted users are not currently supported.
Once you have created an end user with either the sap.bi.common::BI_DATA_CONSUMER or the
sap.bi.common::BI_DATA_ANALYST role, you can log in to SAP Lumira Server. Use the following URL:
http://<HOSTNAME>:80<INSTANCE>/sap/bi/launchpad
For example:
http://MYSERVER:8000/sap/bi/launchpad
Related Information
To test user rights and roles [page 35]
7.2
To test user rights and roles
Context
The following steps outline a basic example for how to configure and test end user rights and roles.
Note
Users LSANALYST and LSCONSUMER are for testing and demonstration purposes only. Implement your own
users as required.
Procedure
1. Create a user named LSANALYST to test publishing from SAP Lumira to SAP Lumira Server:
a. In SAP HANA Studio, create a new user named LSANALYST.
b. Grant role sap.bi.common::BI_DATA_ANALYST to LSANALYST.
You can now test publishing a dataset and story from SAP Lumira to SAP Lumira Server using LSANALYST.
Use this URL in the SAP Lumira (desktop) preferences: http://<HOSTNAME>:80<INSTANCE>/sap/bi/
launchpad.
You can also test sharing a published dataset and story in SAP Lumira Server.

Creating users
35
2. Create a user named LSCONSUMER to test the consumption of shared content.

a. Create a user named LSCONSUMER.
b. Grant role sap.bi.common::BI_DATA_CONSUMER to LSCONSUMER.
You can now test consuming a story shared by LSANALYST with LSCONSUMER. You can also test to ensure
that LSCONSUMER cannot publish a dataset or story from SAP Lumira to SAP Lumira Server.
3. Test the configuration of SAP Lumira Server:
a. In a browser, enter the URL to request component version information:
http://<HOSTNAME>:80<INSTANCE>/sap/bi/sa/version
b. Log on with LSANALYST.
c. Check the version information for warnings or errors.
If there is a problem with the configuration, an error message is returned.
If version information is listed for the different components, SAP Lumira Server is properly configured.
7.3
To use SAP HANA Studio to specify the roles available

for sharing
Prerequisites
In order to share a dataset to a role, the role must have the following privileges on the dataset:
SQL SELECT privilege on the run-time representation of the calculation or analytical view in the _SYS_BIC
schema.
Analytical privilege on the design-time representation of the view, including associated attribute views,
column tables, and analytic views.
Context
In SAP Lumira Server, users can share datasets and stories with roles. This allows any user who belongs to the
role to see the dataset or story. If the dataset was created using the Connect to SAP HANA option in SAP Lumira
(desktop), users can share the dataset with any role that has been configured with the correct permissions. Use
SAP HANA Studio to specify permissions on a dataset for a role, and make the role available for sharing.
See the SAP Lumira Server User Guide for more information on roles available for sharing.
Procedure
1. Launch SAP HANA Studio and open your SAP HANA system.
36

Creating users
2. Navigate to
security
roles
and open the role you want to make available for sharing.
3. Select the Object Privilege tab.

4. Add the catalog object for the calculation or analytical view of the dataset.
5. Select the catalog object you added and select the SELECT privilege.
6. Select the Analytic Privileges tab and add the analytic privilege for the run-time representation of the view.
Results
The selected role is available for sharing.

Creating users
37
Installing and uninstalling chart extensions
SAP Lumira desktop lets you create stories that contain third-party visualization extensions. Before a story that
uses an extension can be viewed, you must install a chart extension on SAP Lumira Server.
Extension management can be done in the SAP Fiori launchpad and before you can add a chart extension, you
must add the Manage Lumira Extensions tile to SAP Fiori.
For information about how to create extensions, see the SAP Lumira Data Access Extensions Developer Guide.
Related Information
8.1
To create an extension management user
A user must be assigned to BI_ADMIN in order to manage chart extensions.
Procedure
1. In SAP Hana Studio, create a new user called LUMIRAEXT. Alternately, select an existing SAP Lumira Server
user.
In this example, the new configuration user is LUMIRAEXT, but you may use any name you prefer.
2. Assign the sap.bi.admin::BI_ADMIN role to LUMIRAEXT or to the existing user you have chosen.
Related Information
User rights and roles [page 34]
38

8.2
To add the Manage Lumira Extensions tile to SAP Fiori
Prerequisites
You must use a SAP Lumira user assigned to sap.bi.admin::BI_ADMIN role to see and add the extension
management tile.
You must have access to SAP Fiori. For the URL see Accessing SAP Fiori [page 51].
If you are working with SAP Fiori on ABAP you must configure the catalog before SAP Lumira can be added.
See To configure the SAP Fiori catalog on an ABAP application server [page 50].
Context
Before you can add extensions, you need to add the extension management tile to your SAP Fiori launchpad.
Procedure
1. Log on to SAP Fiori.
2.
Click the symbol at the upper-left corner of the SAP Fiori launchpad, and click Open Catalog to open the
Tile Catalog.
3. In the SAP Lumira Administration section of the catalog, click the + symbol below Manage Lumira Extensions
then select My Home.
4.
Click Go Back to return to the SAP Fiori launchpad.
Results
The extension management tile appears in the SAP Fiori launchpad under My Home.
8.3
To install chart extensions
Prerequisites
To install extensions, you must use a SAP Lumira user assigned to sap.bi.admin::BI_ADMIN role. The Manage
Lumira Extensions tile must be added to your SAP Fiori launchpad. See To add the Manage Lumira Extensions tile
to SAP Fiori [page 39].

39
Context
The following steps show how to install extensions on SAP Lumira Server.
Procedure
2. Click the Manage Lumira Extensions tile.
The extension manager will appear, including a list of all extensions currently installed.
3. Click the + symbol to upload an extension.
4. Browse to the location of an extension bundle on your local machine, and then click OK.
Note
A bundle must be in a .zip format, and each bundle may only contain one feature. For information about
how to create extensions, see the SAP Lumira Data Access Extensions Developer Guide.
Results
The extension is installed, and visualizations created using the extension will display in SAP Lumira Server. The
version number and a description of the bundle is displayed in the extension manager.
Related Information
8.4
To update a chart extension
Prerequisites
To update extensions, you must use a SAP Lumira user assigned to sap.bi.admin::BI_ADMIN role. The
Manage Lumira Extensions tile must be added to your SAP Fiori launchpad. See To add the Manage Lumira
Extensions tile to SAP Fiori [page 39].
40

Context
The following steps show how to update extensions added to SAP Lumira Server.
Procedure
3. Click on the extension you want to update.
4. Click Update.
5. Browse to the location of the extension bundle on your local machine, then click OK.
Note
The version number of the new extension bundle must be higher than the version number of the extension
bundle currently installed.
Results
The extension is updated. The version number displayed in the extension manager is updated to reflect the new
version.
Related Information
8.5
To uninstall a chart extension
Prerequisites
To uninstall extensions, you must use a SAP Lumira user assigned to sap.bi.admin::BI_ADMIN role. The
Manage Lumira Extensions tile must be added to your SAP Fiori launchpad. See To add the Manage Lumira
Extensions tile to SAP Fiori [page 39].

41
Context
The following steps show how to uninstall extensions added to SAP Lumira Server.
Procedure
3. Select the extension you want to uninstall.
4.
Click the delete icon.
Results
The extension is uninstalled.
Note
If you delete an extension, and then try to view a visualization that uses the extension, an error will appear.
Related Information
42

To generate time data
To explore data published from SAP Lumira that includes date dimensions or time hierarchies, you must first
generate time data in SAP HANA Studio.
Context
The query service relies on data stored in the SAP HANA system time table to process dates or time hierarchies
that are published from SAP Lumira. To explore data that includes dates or time hierarchies, you must first
generate data in the system table using SAP HANA Studio.
Procedure
1. Open the SAP HANA Studio Modeler perspective.
2. Click
Help
Quick Launch .
3. In the Data area, click Generate Time Data.

4. Select your preferred calendar type.
Gregorian is the standard Western calendar year.
5. Use the From Year and To Year fields to specify a time period.
All time periods that users need to analyze must be included in the range.
Note
SAP HANA Studio limits you to generating 50 years of data at a time. If more than 50 years of data is
needed, repeat this procedure for each 50-year segment until the required time period is covered.
For smaller time granularities the generation limits are as follows:
Hour: 30 years.
Minute: 15 years.
Second: 5 years.
6. Specify the Granularity level.
7. Click Generate.

To generate time data
43
10 To enable currency conversion for users
Context
To use currency conversion, a user must be authorized to access the currency tables.
Procedure
1. Open the SAP HANA Studio Administration Console perspective.
2. In the navigation pane, expand the node for your system. Open the Security folder and the Users subfolder,
and double-click the user you want to allow to use currency conversion.
3. In the editor, change the Session Client to a value that exists in currency tables, for example enter the value
001.
44

To enable currency conversion for users
11
Backing up and restoring your server
The following section describes how to backup and restore your data in SAP Lumira Server.
11.1
To backup data
Procedure
1. In SAP HANA Studio, log in to your SAP HANA system with a user who has the following privileges: BACKUP
ADMIN and CATALOG READ.
2. In the system view, double-click Backup under the system where SAP Lumira Server is installed.
3. Select the Configuration tab and note the destination path.
Note
You may change this path to a different location, however the destination should not be set to the data
volume directory: $DIR_INSTANCE/../global/hdb/data.
4. Select the Overview tab and click Back up now.
5. Click Next.
6. Review the backup settings and click Finish.
11.2
To back up configuration
Procedure
1. Locate your configuration files.
By default configuration files are stored in the following location: $DIR_INSTANCE/../SYS/global/hdb/
custom/config
2. Copy all .ini files in the /config directory to a location of your choice.
Note
The .ini files in /config only exist if the user has made changes to them. If the default configuration is
used, no .ini files will be located in this directory.

45
11.3
To restore data
Prerequisites
A backup of the data must be available.
Procedure
1. In SAP HANA Studio, right-click the system where SAP Lumira Server is installed and select Recover.
2. Enter your system username and password.
3. When prompted to shut down the system to perform a recovery, click OK.
4. Select Recover the database to a specific data backup in the popup dialog box and click Next.
5. Specify the backup location and the backup prefix and click Next.
6. Install a new license key and click Next.
7. Click Finish.
Results
When the system has been restored and restarted, login to SAP Lumira Server. All data and users from the
backup system should be restored and available without any additional configurations.
11.4 To restore configuration

Prerequisites
A backup of the configuration must be available.
Procedure
Copy the .ini files you previously saved to the config directory.
$DIR_INSTANCE/../SYS/global/hdb/custom/config
46

Results
When you log in to SAP HANA Studio and refresh your system, all configuration settings should match the
configuration of the backed up system.

47
12
To undeploy SAP Lumira Server
Context
If a previous release or support package of SAP Lumira Server is currently installed, you may choose to undeploy
the existing delivery unit before proceeding with the installation procedure outlined in this guide. Undeploying the
existing delivery unit is not required if you wish to upgrade SAP Lumira Server.
Note
If you undeploy the delivery unit, all saved data associated with the previous release will be erased.
Procedure
1. Turn off background jobs.
a. Access the SAP HANA XS Administration Tool.
For example, if you are using instance 01 on machine myserver open the link http://myserver:
8001/sap/hana/xs/admin.
b. Log in as the SYSTEM user.
c. Navigate to
sap
bi
discover
logic
vizd
backgroundjobs .
d. Choose a job file.

For example choose VDSchedulerJob_1, VDSchedulerJob_2 or VDSchedulerJob_3 .
e. Deselect the Active box, and then click Save.
f. Repeat steps d and e for all job files.
2. On your SAP HANA system, navigate to the hdbclient directory where regi program is located.
3. Run the following command to undeploy SAP Lumira Server 1.15:
regi undeploy du LUMIRA_SERVER --vendor=sap.com --host=<HOSTNAME>:3<INSTANCE>15
--user=<USER> --password=<PASSWORD>
Replace <USER> with your SAP HANA system administrator name, and <PASSWORD> with the system
administrator password. For example, if you are using instance 27 on myserver enter: regi undeploy du
LUMIRA_SERVER vendor=sap.com --host=myserver:32715 --user=myuser -password=mypassword.
48

Results
The delivery unit is undeployed.

49
13
Appendix
13.1
Working with SAP Fiori
To perform SAP Lumira Server configuration or install chart extensions, you must have access to SAP Fiori. SAP
Fiori is included with your SAP HANA server installation and can be accessed through a URL. On a SAP HANA
server, SAP Lumira Server is automatically connected to the SAP Fiori catalog and no additional installation or
configuration is required.
Note
To enable an SAP Fiori connection to SAP Lumira Server on an ABAP application server, additional
configuration steps are required.
You must install SAP Lumira Server before you can access it from SAP Fiori.
You can use the ABAP version of SAP Fiori to access SAP Lumira Server content, but you must use the
SAP HANA version of SAP Fiori to configure SAP Lumira server.
Related Information
To configure the SAP Fiori catalog on an ABAP application server [page 50]
Accessing SAP Fiori [page 51]
13.1.1
To configure the SAP Fiori catalog on an ABAP

application server
Context
SAP Fiori can be enabled in an ABAP-based SAP system or SAP HANA. The following steps describe how to
configure an ABAP application server to include SAP Lumira Server in the SAP Fiori catalog.
Note
In SAP HANA, SAP Lumira Server automatically appears, and the SAP Fiori catalog does not require extra
configuration.
50

Appendix
Procedure
1. Configure the SAP Web Dispatcher to redirect to an SAP HANA server when required.
a. Open the SAP Web Dispatcher profile in a text editor.
By default, the profile file sapwebdisp.pfl is located in the sapwebdisp folder. For
example, /usr/sap/hana/shared/<SID>/<NAME>/wdisp, where <SID> is your server ID, and
<NAME> is your computer name.
b. Add SAP HANA information to the profile.
wdisp/system_15 = SID=<SERVERID>, EXTSRV=https://<HANAHOST>:43<INSTANCE>,
SRCSRV=*:53290, SRCURL=/sap/bi/;/sap/viz/;/sap/vi/;/sap/ui5/;/sap/hana/
Replace <SERVERID> with the ID of your SAP HANA server. Replace <HANAHOST> with the name of your
SAP HANA server. Replace <INSTANCE> with the SAP HANA server instance. For example,
EXTSRV=https://myhanaserver:4303
For more information see the Administration of the SAP Web Dispatcher topic in your SAP NetWeaver
documentation.
2. Assign the SAP_LUMIRA_TCR role to SAP Lumira users in your ABAP-based SAP system.
For more information, see the PFCG Overview topic in your SAP NetWeaver Business Client documentation.
3. Create SAP HANA users for all SAP NetWeaver users that require SAP Lumira access.
For more information, see the SAP HANA Administration Guide.
4. Set up the trust relationship between your ABAP application server and SAP HANA.
Perform the procedure outlined in Configure SSO with SAP Logon Tickets for SAP HANA XS Applications in the
SAP HANA Administration Guide.
Results
SAP Lumira Server can be selected from the catalog in the SAP Fiori launchpad.
13.1.2
Accessing SAP Fiori
To access SAP Fiori use one of the following:
Note
The URL may have been customized by your administrator. Contact your administrator for the correct URL.
On an SAP HANA system, use this URL:
For example, http://MyHanaServer:8000/sap/bi/launchpad/fiori.

Appendix
51
On an ABAP-based SAP system, use this URL:

https://<HOSTNAME>:<PORT>/sap/bc/ui5_ui5/ui2/ushell/shells/abap/
FioriLaunchpad.html
Replace <HOSTNAME> with the name of your ABAP front-end server. Replace <PORT> with the SAP NetWeaver
Gateway port number.
For example, https://MyABAPServer:8000/sap/bc/ui5_ui5/ui2/ushell/shells/abap/
FioriLaunchpad.html.
13.2 Logging server activity

Logging server activity is done by the SAP HANA XS trace facility. In SAP HANA, server-side JavaScript tracing is
configurable per component. You can configure the log file to capture information for selected components. For
more information, see the chapter on Server-Side JavaScript Tracing in the SAP HANA Developer Guide.
The following components are part of SAP Lumira Server:
Table 12:
Component
Description
sap.bi.common
Security roles and other common files.
sap.bi.launchpad
Launchpad features. Supports the item catalog and sharing functionality.
sap.bi.va.tp
Resources required by third-party libraries used and distributed with SAP Lumira Server.
sap.bi.sa
Self-service analytics enables end-user-oriented analytic capabilities for ad-hoc querying of SAP
HANA information models.
SAP Lumira Server activity and error information traces are saved in the xsengine_<HOSTNAME>.trc log file.
The xsengine_alert_<HOSTNAME>.trc log file is created simultaneously and contains only error information. If
errors are the result of SAP HANA query execution, you can find additional details in the
indexserver_alert_<HOSTNAME>.trc log file.
In the xsengine_alert_<HOSTNAME>.trc file, a scenario ID may be provided with an error, for example,
SCENARIO_6608015710059306_1369800676156. You can use a scenario ID to search for additional information
in the indexserver_alert<HOSTNAME>.trc file. If no scenario ID is associated with an error, you can use its
timestamp to search for errors. Errors that occurred around the same time may contain the information you
require.
The self-service analytics component activity and error information traces are saved in the
scriptserver<HOSTNAME>.<numbers>.trc_ and scriptserver_alert<host>.trc_ log files.
Note
There is no persisted logging in the SAP HANA client web browser console. Any web browser console logs are
only available to the current user and are discarded when the browser closes or the user navigates to another
URL.
SAP HANA also provides the capability to trace the execution of SQL statements. For more information on SQL
.
tracing, see http://www.saphana.com/docs/DOC-2182
52

Appendix
13.2.1
To enable component-level tracing
Prerequisites
You must have SAP HANA Studio installed and access to the system that SAP Lumira Server is installed on.
Procedure
1. In the Administration Editor, select the Trace Configuration tab.
2. Click the edit icon beside Database Trace.
3. Select Show All Components.
4. Search for sap.bi.
A list of SAP Lumira Server components will appear.
5. Set each component's trace level to DEBUG.
Setting the trace level to debug captures the maximum amount of information in the log file.
6. Click Finish.
13.2.2 To view trace files

Prerequisites
You must have SAP HANA Studio installed and access to the system that SAP Lumira Server is installed on.
Procedure
1. In the SAP HANA Studio administration console, select the Diagnosis Files tab.
A list of trace files will appear.
2. Locate the file named xsengine_<HOSTNAME>.<#####>.<###>.trc or
scriptserver_<HOSTNAME>.<#####>.<###>.trc_
<HOSTNAME> contains your SAP HANA server host name. <#####> contains a five digit number. <###>
contains a three digit number.
You can filter the list by entering, for example, xsengine_ in the filter box.
3. Right-click the .trc file to open it, or to download it.

Appendix
53
Results
In the case of errors, the XS Engine will log details to the file named xsengine_alert_<HOSTNAME>.trc. If the
errors are the result of SAP HANA query execution, you will find additional details in the file named
indexserver_alert_<HOSTNAME>.trc. Replace <HOSTNAME> with your SAP HANA server host name.
13.3 SQL setup on SAP HANA

The SAP Fiori configuration application sets all required SQL connections between your SAP HANA repository and
SAP Lumira Server. The application also assigns the technical user all required roles.
The SQL connection configuration (SQLCC) file on the SAP HANA XS server is modified automatically by the
application. The following roles and connections are configured on SAP HANA:
Publishing
The user provided will be assigned the role sap.bi.common::BI_TECH_USER, and will be associated with the
SQL connection configuration (SQLCC) via sap.bi.launchpad.logic.v2::RepoConnection.
Extensions
SQL connection configuration (SQLCC) via
sap.bi.launchpad.logic.lib.extensions::ExtensionRepoConnection.
Self-service Analytics
SQL connection configuration (SQLCC) via sap.bi.sa.db.connections::TechnicalConnection.
Additionally, the scriptserver will be enabled and launched by updating the system configuration daemon.ini to
set scriptserver instances to "1".
Discover
The user provided will be assigned the role sap.bi.discover::BI_DISCOVER_SCHEDULER_PRIV. As well, the
job scheduler will be enabled by setting the system configuration xsengine.ini scheduler enabled to "true".
54

Appendix
Data Acquisition
SQL connection configuration (SQLCC) via sap.bi.da.logic::RepoConnection.
13.4 Client authentication

For information on configuring client authentication, for example setting up SAML, or X.509 authentication, see
the SAP HANA Administration Guide.
13.5 Common installation problems and troubleshooting

13.5.1
SAP HANA Lifecycle Manager displays an error when

clicking Run
Problem
SAP HANA Lifecycle Manager displays an error message when clicking Run, at the Prepare Deployment step of
the Deploy HANA Content workflow. The message includes this text:
Could not parse manifest.txt inside delivery unit
Cause
The SAP HANA Lifecycle Manager version is Support Package 06 or lower, and needs to be updated to SP07 or
higher. You can find the version number in the upper-right corner of any SAP HANA Lifecycle Manager page in
SAP HANA Studio.
Solution
In the Software Download Center, search for Hana Lifecycle Manager and download the SAP HANA Lifecycle
Manager version SP07. Run the Update SAP HANA Lifecycle Manager (HLM) workflow in SAP HANA Lifecycle
Manager. It accepts the SAR file you downloaded and updates itself. When you open SAP HANA Lifecycle
Manager again in SAP HANA Studio, the version number should begin with 1.0.7 if the update was successful.

Appendix
55
13.5.2 SAP HANA Lifecycle Manager does not accept the SAP
Lumira Server installation package
Problem
SAP HANA Lifecycle Manager does not accept the SAP Lumira Server installation package.
Cause
SAP HANA Lifecycle Manager accepts only .zip files that have the correct metadata and internal format.
Solution
Use the .zip file downloaded from the Software Download Center directly. This .zip file already has the correct
format and metadata, and does not need to be unpacked.
13.5.3 SAP HANA Lifecycle Manager displays an error when

trying to deploy content
Problem
On the main page of SAP HANA Lifecycle Manager, when you click Deploy Content, an error message may be
displayed.
Cause
SAP HANA Lifecycle Manager was not signed by the Software Download Center.
Solution
Download SAP HANA Lifecycle Manager from the Software Download Center and reinstall it.
56

Appendix
13.5.4 Cannot connect to SAP Lumira Server after a

successful deployment to SAP HANA on Amazon Web
Services
Problem
The deployment was successful, but browsers are unable to connect when you try to access the SAP Lumira
Server or SAP HANA Extended Application Services (XS Engine) administration pages.
Cause
Amazon Web Services does not have the SAP HANA Extended Application Services port open.
Solution
Open the SAP HANA Extended Application Services port in the Amazon control panel.
The port number is composed of 80 plus the XS Engine instance number. For example, if you are using
instance 15, the port number is 8015.
This SCN article describes how to open the port in the Amazon Web Services control panel: http://
scn.sap.com/community/developer-center/hana/blog/2013/05/13/solution-to-issue-setting-up-hana-xsengine-with-aws .
13.5.5 The web page is not found (404 error) when accessing
the SAP Lumira Server or SAP HANA Extended
Application Services administration pages
Problem
The web page is not found (404 error) when trying to access the SAP Lumira Server or SAP HANA Extended
Application Services administration pages, after a successful deployment.
Possible Cause
SAP HANA was installed using a nostart flag. When this flag is used, some SAP HANA content, such as the SAP
HANA Extended Application Services administration and logon pages, is not deployed. You can verify that this is
the problem by searching in the installation logs for this flag.

Appendix
57
Solution
Deploy the missing delivery units (DUs):
1. In SAP HANA Studio, click
File
Import .
2. Under SAP HANA Content, select Delivery Unit, and click Next.
3. Select your server from the list, and click Next.
4. Under Select file, choose Server.
5. Expand the File list to see all available DUs, and select HANA_XS_BASE.tgz.
6. Click Finish.
7. Repeat for these DUs (it is recommended to deploy all DUs available in the list):
HANA_XS_LM
HANA_XS_SQLCC
HANA_XS_EDITOR
HANA_XS_IDE
SAPUI5_1
HANA_IDE_COR
Possible Cause
If you are using basic authentication rather than SSO, basic authentication may not be enabled.
Solution
Enable basic authentication.
1. Launch the SAP HANA XS Administration Tool:
2. Navigate to sap.bi.launchpad.
3. In the Authentication section, ensure that Form based and Basic are selected.
4. Save the configuration.
13.5.6 When trying to publish from SAP Lumira to SAP Lumira

Server, the message Not available is displayed
Problem
When trying to publish from SAP Lumira to SAP Lumira Server, the message Not available is displayed.
58

Appendix
Cause
The configuration steps required to allow publishing have not been followed.
Solution
Follow the steps in the section To add the Configuration tile to SAP Fiori and To configure SAP Lumira Server.
Related Information
To prepare SAP Lumira Server for configuration [page 30]
To configure SAP Lumira Server [page 32]
SQL setup on SAP HANA [page 54]
13.5.7 SAP Lumira Server installation may not succeed

When installing SAP Lumira Server, messages with the following format may appear:
Repository: objects are already locked by another change
Installation of SAP Lumira Server may not succeed if a previous version of SAP Lumira Server was installed and
removed while Change Management was enabled on SAP HANA. To resolve this issue, see 2092162 .
13.6 Using SAP HANA Studio to manage roles

Context
Before a user can configure. administer, or use SAP Lumira Server, they must have the required roles granted to
them. In SAP HANA, roles are a collection of privileges that grant a user the right to perform a certain action. You
can use SAP HANA Studio to grant roles to a user. For more information on roles and security in SAP HANA, see
SAP HANA Security Guide.

Appendix
59
To use SAP HANA Studio to add a role to a user:
Procedure
1. Select the system containing the user.
2. Expand
Security
User .
3. Open the user that will be assigned the new role.

4. Select the Granted roles tab.
5. Select the
symbol and search for the role.
6. Select the role and click OK to add the role to the user.
7. Select Deploy (
) to activate the changes.
Results
The role is added to the user.
60

Appendix
14 Getting support
In some support situations, it may be necessary to allow an SAP support engineer to log into your SAP HANA
system to analyze the situation. For more information, refer to the Getting Support section of the SAP HANA
Administration Guide.

Getting support
61
Important Disclaimers and Legal Information
Coding Samples
Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system
environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and
completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, unless damages were caused by SAP
intentionally or by SAP's gross negligence.
Accessibility
The information contained in the SAP documentation represents SAP's current view of accessibility criteria as of the date of publication; it is in no way intended to be a
binding guideline on how to ensure accessibility of software products. SAP in particular disclaims any liability in relation to this document. This disclaimer, however, does
not apply in cases of wilful misconduct or gross negligence of SAP. Furthermore, this document does not result in any direct or indirect contractual obligations of SAP.
Gender-Neutral Language
As far as possible, SAP documentation is gender neutral. Depending on the context, the reader is addressed directly with "you", or a gender-neutral noun (such as "sales
person" or "working days") is used. If when referring to members of both sexes, however, the third-person singular cannot be avoided or a gender-neutral noun does not
exist, SAP reserves the right to use the masculine form of the noun and pronoun. This is to ensure that the documentation remains comprehensible.
Internet Hyperlinks
The SAP documentation may contain hyperlinks to the Internet. These hyperlinks are intended to serve as a hint about where to find related information. SAP does not
warrant the availability and correctness of this related information or the ability of this information to serve a particular purpose. SAP shall not be liable for any damages
caused by the use of related information unless damages have been caused by SAP's gross negligence or willful misconduct. All links are categorized for transparency
(see: http://help.sap.com/disclaimer).
62


63
www.sap.com/contactsap

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.

Instalação Lumira Server

Diunggah oleh

Informasi Dokumen

Judul Asli

Hak Cipta

Format Tersedia

Bagikan dokumen Ini

Bagikan atau Tanam Dokumen

Opsi Berbagi

Apakah menurut Anda dokumen ini bermanfaat?

Apakah konten ini tidak pantas?

Hak Cipta:

Format Tersedia

Instalação Lumira Server

Diunggah oleh

Hak Cipta:

Format Tersedia

SAP Lumira Server

Document Version: 1.25 2015-04-20

SAP Lumira Server Installation Guide

Summary of required components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

SAP HANA requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

SAP HANA Client requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Universal Analytics Application Function Library (UAL AFL) requirements. . . . . . . . . . . . . . . . . . . . . . . 11

SAP HANA Studio requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

List of steps for installing SAP Lumira Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

List of steps for a new installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

List of steps for an upgrade installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Installing SAP HANA components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

To uninstall SAL AFL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

To install the Universal Analytics Application Function Library (UAL AFL). . . . . . . . . . . . . . . . . . . . . . . 17

Installing and configuring SAP Lumira Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Stopping background jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Updating the SAP Lumira Server database schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

To assign catalog privileges to roles (SAP HANA SP09 and later). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

To create administration users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

To prepare SAP Lumira Server for configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

To configure SAP Lumira Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Creating users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

User rights and roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

To test user rights and roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Installing and uninstalling chart extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

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

SAP Lumira Server Installation Guide

To create an extension management user. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

To add the Manage Lumira Extensions tile to SAP Fiori. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

To install chart extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

To update a chart extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

To uninstall a chart extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

To generate time data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

To enable currency conversion for users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44

Backing up and restoring your server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

To restore configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46

To undeploy SAP Lumira Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Working with SAP Fiori. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50

Logging server activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

SQL setup on SAP HANA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Common installation problems and troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Using SAP HANA Studio to manage roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59

SAP Lumira Server Installation Guide

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

SAP Lumira Server Instal September,

SAP Lumira Server Instal October, 2014

SAP Lumira Server Instal Dec, 2014

SAP Lumira Server Instal Jan, 2015

SAP Lumira Server Instal Feb, 2015

SAP Lumira Server Instal April, 2015

Added the sections Variables, Required information, and Required compo

Added instructions for using the Universal Analytics Application Function Li

Added the section List of steps for installing SAP Lumira

Added section To assign catalog privileges to roles.

lation Guide v 1.25.

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

SAP Lumira Server Installation Guide

The following variables are used in this document:

The instance number of your SAP HANA system.

SAP HANA System ID.

The name or IP address of the machine where SAP HANA is

The installation directory for SAP HANA. Default is /hana/

SAP HANA Instance number