instalação lumira server

64
SAP Lumira Server Document Version: 1.25 – 2015-04-20 SAP Lumira Server Installation Guide

Upload: rodrigocastaldelli

Post on 17-Aug-2015

235 views

Category:

Documents


4 download

DESCRIPTION

Manual de instalação do SAP Lumira Server

TRANSCRIPT

SAP Lumira ServerDocument Version: 1.25 2015-04-20SAP Lumira Server Installation GuideContent1Document History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.1Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.2Required information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Required Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83.1Summary of required components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83.2SAP HANA requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.3XS Engine requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103.4SAP HANA Client requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.5Universal Analytics Application Function Library (UAL AFL) requirements. . . . . . . . . . . . . . . . . . . . . . . 113.6SAP HANA Studio requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124List of steps for installing SAP Lumira Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134.1List of steps for a new installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134.2List of steps for an upgrade installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145Installing SAP HANA components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165.1To download SAPCAR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165.2To uninstall SAL AFL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175.3To install the Universal Analytics Application Function Library (UAL AFL). . . . . . . . . . . . . . . . . . . . . . . 176Installing and configuring SAP Lumira Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196.1Stopping background jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196.2Updating the SAP Lumira Server database schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206.3To install or upgrade SAP Lumira Server using HALM command line. . . . . . . . . . . . . . . . . . . . . . . . . . .216.4To install or upgrade SAP Lumira Server using HALM Web Administration tool. . . . . . . . . . . . . . . . . . . 246.5To assign catalog privileges to roles (SAP HANA SP09 and later). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256.6To create administration users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296.7To prepare SAP Lumira Server for configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306.8To configure SAP Lumira Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327Creating users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347.1User rights and roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347.2To test user rights and roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357.3To use SAP HANA Studio to specify the roles available for sharing. . . . . . . . . . . . . . . . . . . . . . . . . . . . 368Installing and uninstalling chart extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideContent8.1To create an extension management user. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388.2To add the Manage Lumira Extensions tile to SAP Fiori. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398.3To install chart extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398.4To update a chart extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408.5To uninstall a chart extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419To generate time data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4310To enable currency conversion for users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4411Backing up and restoring your server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4511.1To backup data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4511.2To back up configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4511.3To restore data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4611.4To restore configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4612To undeploy SAP Lumira Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4813Appendix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5013.1Working with SAP Fiori. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50To configure the SAP Fiori catalog on an ABAP application server. . . . . . . . . . . . . . . . . . . . . . . . . . 50Accessing SAP Fiori. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5113.2Logging server activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52To enable component-level tracing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53To view trace files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5313.3SQL setup on SAP HANA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5413.4Client authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5513.5Common installation problems and troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55SAP HANA Lifecycle Manager displays an error when clicking Run. . . . . . . . . . . . . . . . . . . . . . . . . 55SAP HANA Lifecycle Manager does not accept the SAP Lumira Server installation package. . . . . . . 56SAP HANA Lifecycle Manager displays an error when trying to deploy content. . . . . . . . . . . . . . . . . 56Cannot connect to SAP Lumira Server after a successful deployment to SAP HANA on Amazon Web Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57The web page is not found (404 error) when accessing the SAP Lumira Server or SAP HANA Extended Application Services administration pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57When trying to publish from SAP Lumira to SAP Lumira Server, the message Not available is displayed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58SAP Lumira Server installation may not succeed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5913.6Using SAP HANA Studio to manage roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5914Getting support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61SAP Lumira Server Installation GuideContent 2015 SAP SE or an SAP affiliate company. All rights reserved. 31Document HistoryThe following table provides an overview of the most important document changes.Table 1:Version Date DescriptionSAP Lumira Server Installation Guide v 1.19September, 2014 Added the sections Variables, Required information, and Required components. Removed requirement for SAP UI5 downgrade. SAP Fiori launchpad is now compatible with the version of SAP UI5 that is included with SAP HANA Support Package 08 Revision 82. Added section To download SAPCAR. You must use release 720 or later.SAP Lumira Server Installation Guide v 1.20.October, 2014 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 configure SAP Lumira Server.SAP Lumira Server Installation Guide v 1.21.Dec, 2014 Added instructions for installing SAP Lumira Server using SAP HANA Application Lifecycle Management tool (HALM). Added instructions for using the Universal Analytics Application Function Library Added the section List of steps for installing SAP LumiraSAP Lumira Server Installation Guide v 1.22.Jan, 2015 Added section To assign catalog privileges to roles. Added section To install or upgrade SAP Lumira Server using HALM Web Administration tool.SAP Lumira Server Installation Guide v 1.23.Feb, 2015 HLM is no longer supported for installing SAP Lumira Server. Use HALM instead. SAL AFL, an SAP HANA library, is no longer supported. Uninstall SAL AFL and install UAL AFL.SAP Lumira Server Installation Guide v 1.25.April, 2015 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 releases.4 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideDocument History2Getting StartedThis section helps you gather the information you need to install and configure SAP Lumira Server, then explains how to verify your deployment environment.2.1VariablesThe following variables are used in this document:Table 2:Variable Definition The instance number of your SAP HANA system. SAP HANA System ID. The name or IP address of the machine where SAP HANA is installed. The installation directory for SAP HANA. Default is /hana/shared/.2.2Required informationThis 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 Your valueSAP HANA Instance numberThe instance number is created when SAP HANA is installed. You can have more than one instance on a single machine.00SAP System ID (SID)The system ID is created when SAP HANA is installed.DB1adm username and passwordThe system administrator account is created when SAP HANA is installed.db1admSAP Lumira Server Installation GuideGetting Started 2015 SAP SE or an SAP affiliate company. All rights reserved. 5Item Example Your valuePassword for the SYSTEM userThe SYSTEM user is the database super user created when SAP HANA is installed. The username is SYSTEM and the password is set during installation.not applicable You may not want to write the password down, but you need to know it.Machine name and IP address of the host machine where SAP HANA is installedMYSERVERUser accounts created for SAP LumiraYou will create these user accounts during the configuration process. You can record them here for your convenience.Table 4:User account Description Your valuesSAP Lumira Server configuration user. For example, LUMIRACONFIG.The configuration user has the sap.bi.admin::BI_CONFIGURATOR role and has the rights to configure SAP Lumira Server.SAP Lumira Server technical user. For example, 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_CONSUMER role, and is an end user of SAP Lumira Server.SAP Lumira Server analyst userThe analyst user has the sap.bi.common::BI_DATA_ANALYST role, which includes the sap.bi.common::BI_DATA_CONSUMER role plus the right to publish a dataset from SAP Lumira (desktop). This user is a data analyst end user of SAP Lumira Server.6 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideGetting StartedUser account Description Your valuesChart extension managerThe chart extension manager user has the sap.bi.admin::BI_ADMIN role and has permissions to manage chart extensions.SAP Lumira Server Installation GuideGetting Started 2015 SAP SE or an SAP affiliate company. All rights reserved. 73Required Components3.1Summary 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 2108725and 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 2124824Table 5:Component Supported version(s) NotesSAP HANA 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 . The XS Engine must be installed on SAP HANA.Universal Analytics Application Function Library (UAL AFL) Version 1.304 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. NoteIf SAL AFL is installed on your SAP HANA server, you must remove it before installing UAL AFL.8 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideRequired ComponentsComponent Supported version(s) NotesSAP HANA Client The version of SAP HANA client must match the version of SAP HANA. The SAP HANA Client must be installed on your client machine. It contains SAP HANA Application Lifecycle 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.NoteThe 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.2SAP HANA requirementsEnsure 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 HANAUse this command to check your version of SAP HANA:/usr/sap//HDB/HDB versionExample:MYSERVER:/usr/sap/DB1/HDB00 # su db1admMYSERVER:/usr/sap/DB1/HDB00> ./HDB versionHDB version info:version: 1.00.84.00.XXXXXXDownloading a new version of SAP HANAUse the following path to download a new version of SAP HANA from the SAP Service Marketplace:SAP Software Download Center Support Packages and Patches A - Z Index H SAP HANA Platform EditionSAP Lumira Server Installation GuideRequired Components 2015 SAP SE or an SAP affiliate company. All rights reserved. 9SAP HANA Platform Edit. 1.0 Entry by Component HANA Database SAP HANA DATABASE 1.00 Linux on x86_64 64bit .NoteIn 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 runningThe 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 adm user to see which SAP HANA processes are running:/usr/sap//HDB/HDB info For example:MYSERVER:/usr/sap/DB1/HDB00 # su db1admMYSERVER:/usr/sap/DB1/HDB00> ./HDB infoUSERPID PPID %CPUVSZ RSS COMMANDdb1adm 110461 1104600.1139122772 -shdb1adm 110595 110461 12.5129001728\_ /bin/sh ./HDB infodb1adm 110618 1105950.0 4972 864\_ ps fx -U db1adm -o user,pid,ppid,pcpu,vsz,rss,argsdb1adm1425110.0219921512 sapstart pf=/C08_nfs/C08/profile/C08_HDB08_vanpglnxc52b3db1adm14262142510.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_vanpglnxc52b3db1adm14278142620.3 12223100 933644\_ hdbnameserverdb1adm14311142620.2 13089172 5561836\_ hdbpreprocessordb1adm14314142620.0 11678104 700712\_ hdbcompileserverdb1adm14342142627.3 14742528 4603556\_ hdbscriptserverdb1adm14345142627.5 17092972 5342528\_ hdbxsenginedb1adm15183142620.0 339368 79876\_ sapwebdisp_hdb pf=/usr/sap/C08/HDB08/vanpglnxc52b3/wdisp/sapwebdisp.pfl -f /usr/sap/C08/HDB08/vanpglnxc52b3/trace/dev_webdispdb1adm7304214262 13.0 21081684 10295188\_ hdbindexserverdb1adm1355110.0 286416 90684 /usr/sap/C08/HDB08/exe/sapstartsrv pf=/C08_nfs/C08/profile/C08_HDB08_vanpglnxc52b3 -D3.3XS Engine requirementsThe XS Engine must be installed and running. It is typically installed together with SAP HANA.10 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideRequired ComponentsVerifying the installation of XS EngineEnter the following URL in a browser to launch the XS administration application:http://:80/sap/hana/xs/admin/Example:http://MYSERVER:8000/sap/hana/xs/admin/3.4SAP HANA Client requirementsThe 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.5Universal Analytics Application Function Library (UAL AFL) requirementsIf 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//HDB/exe/plugins/sap_afl_sdk_ual/manifest Example:MYSERVER #:cat /usr/sap/DB1/HDB00/exe/plugins/sap_afl_sdk_ual/manifestap_afl_sdk_ual/manifest...release: 1.303...NoteThe 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].SAP Lumira Server Installation GuideRequired Components 2015 SAP SE or an SAP affiliate company. All rights reserved. 11Downloading a new version of UAL AFLUse the following path to download a new version of UAL AFL from the SAP Service Marketplace:SAP Software Download Center Support Packages and Patches A - Z Index L SAP Lumira Server SAP Lumira Server 1Comprised Software Component Versions Universal Analytics AFL 1.0 Linux on x86_64 64bitFor help installing this component, see To install the Universal Analytics Application Function Library (UAL AFL) [page 17].3.6SAP HANA Studio requirementsSAP 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 StudioLaunch SAP HANA Studio and selectHelp About SAP HANA Studioand ensure you have the correct version.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 StudioUse the following path to download a new version of SAP HANA Studio from the SAP Service Marketplace:SAP Software Download Center Support Packages and Patches A - Z Index H SAP HANA Platform EditionSAP HANA Platform Edit. 1.0 Entry by Component HANA Studio .12 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideRequired Components4List of steps for installing SAP Lumira ServerThis section explains the required steps for each supported installation option. Steps are provided for both new installations and upgrade installations.4.1List of steps for a new installationTable 6:Step Description Link to Information1Install a supported version of SAP HANA with the XS engine and UAL AFL according to your deployment environment. SAP HANA requirements [page 9]. XS Engine requirements [page 10]. Universal Analytics Application Function Library (UAL AFL) requirements [page 11]. To install the Universal Analytics Application Function Library (UAL AFL) [page 17].2Install SAP HANA Client (which contains HALM) and SAP HANA Studio on the client machine. SAP HANA Client requirements [page 11]. SAP HANA Studio requirements [page 12].3 Install SAP Lumira Server. To install or upgrade SAP Lumira Server using HALM command line [page 21], or To install or upgrade SAP Lumira Server using HALM Web Administration tool [page 24].4 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].5 Create administration users. See To create administration users [page 29].6 Prepare SAP Lumira Server for configuration. See To prepare SAP Lumira Server for configuration [page 30].7 Configure SAP Lumira. See To configure SAP Lumira Server [page 32].SAP Lumira Server Installation GuideList of steps for installing SAP Lumira Server 2015 SAP SE or an SAP affiliate company. All rights reserved. 134.2List of steps for an upgrade installationIf you have an existing installation of SAP Lumira Server that you want to upgrade, you must check if the Self-Service 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 2108725for 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 2124346for special instructions.Table 7:Step Description Link to information1 Stop all required background jobs. See Stopping background jobs [page 19].2 If SAL AFL is installed on your SAP HANA machine, uninstall SAL AFL. See To uninstall SAL AFL [page 17].3 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 version of SAP Lumira Server.This document does not explain how to perform an upgrade to SAP HANA Support Package 09 if SAP Lumira Server is already installed. See 2108725for information. See the SAP HANA Server installation guide.4 Install UAL AFL. See To install the Universal Analytics Application Function Library (UAL AFL) [page 17].5Update the SAP Lumira Server database schema. See Updating the SAP Lumira Server database schema [page 20].6 Install SAP Lumira Server. See To install or upgrade SAP Lumira Server using HALM command line [page 21], or To install or upgrade SAP Lumira Server using HALM Web Administration tool [page 24]7 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].8 Create administration users. See To create administration users [page 29].14 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideList of steps for installing SAP Lumira ServerStep Description Link to information9 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].SAP Lumira Server Installation GuideList of steps for installing SAP Lumira Server 2015 SAP SE or an SAP affiliate company. All rights reserved. 155Installing SAP HANA componentsThis section explains how to upgrade or install some of the required components.5.1To download SAPCARContextIf you downloaded .sar packages from SAP Service Marketplace, you will need SAPCAR to extract them.Procedure1. Download SAPCAR from SAP Service Marketplace to a temporary directory on your SAP HANA machine.Use the following path in the SAP Service Marketplace:SAP Software Download Center Support Packages and Patches A - Z Index S sapcar (latest version) Linux on x86_64 64bit .NoteThe 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 SAPCAR3. If necessary, give yourself permissions to execute SAPCAR. For example:chmod 777 SAPCARResultsYou are ready to use SAPCAR to install SAP HANA components.16 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideInstalling SAP HANA components5.2To uninstall SAL AFLContextYou 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//HDB/exe/pluginsIf 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/pluginstotal 16lrwxrwxrwx 1 db1adm sapsys43 Jul 11 11:50 sal -> ../../plugins/sal_1.00.84.0In this example, SAL AFL is installed.ProcedureInstructions 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.3To 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.ProcedureInstructions for installing UAL AFL are in the SAP Note 2103854 . Refer to this information for instructions on installing UAL AFL.SAP Lumira Server Installation GuideInstalling SAP HANA components 2015 SAP SE or an SAP affiliate company. All rights reserved. 17ResultsThe 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideInstalling SAP HANA components6Installing and configuring SAP Lumira ServerWe 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.1Stopping background jobsContextIf you are performing an upgrade, first turn off all background jobs.Procedure1. Access the SAP HANA XS Administration Tool in a browser.http://:80/sap/hana/xs/admin/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 tosap bi discover logic vizd backgroundjobs . If there are no job files, you can skip the remainder of these steps.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.ResultsAll background jobs are turned off.SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira Server 2015 SAP SE or an SAP affiliate company. All rights reserved. 196.2Updating the SAP Lumira Server database schema PrerequisitesWe 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.ContextThe 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.NoteYou 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.Procedure1. 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira Server 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);ALTER TABLE "SAP_BI_DISCOVER"."sap.bi.da.db.tables::DATASET_MASTER" ALTER TYPE COLUMN;ALTER TABLE "SAP_BI_DISCOVER"."sap.bi.da.db.tables::DATASET_MASTER" ALTER ("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.Example6.3To install or upgrade SAP Lumira Server using HALM command linePrerequisites 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.ContextHALM is part of SAP HANA client, so run it from the client machine.SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira Server 2015 SAP SE or an SAP affiliate company. All rights reserved. 21NoteHALM does not verify the version of required components before installation. Ensure you are using supported versions of the components.Procedure1. 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:SAP Software Download Center Installations and Upgrades A - Z Index L SAP Lumira Server SAP Lumira Server 1 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. SelectStart 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 DescriptionHDBALM_USER -u 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 installation or update.Password for the SAP HANA user account.HDBALM_HOST -h IP address or host name of the SAP HANA system where you want to install SAP Lumira Server.HDBALM_PORT -p 80 .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=SYSTEMset HDBALM_PASSWD=MyPassword122 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira Serverset HDBALM_HOST=10.160.15.50set 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.NoteUse 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 Using command-line parameters:hdbalm install Where 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.zipFor 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.zipTipThe following commands give you more information on the hdbalm command: hdbalm help hdbalm help installResultsSAP Lumira Server is installed.Next StepsYou must create administration users and configure SAP Lumira Server before using it for the first time. See To create administration users [page 29].SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira Server 2015 SAP SE or an SAP affiliate company. All rights reserved. 236.4To install or upgrade SAP Lumira Server using HALM Web Administration toolSAP 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.NoteHALM does not verify the version of required components before installation. Ensure you are using supported versions of the components.Procedure1. 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:SAP Software Download Center Installations and Upgrades A - Z Index L SAP Lumira Server SAP Lumira Server 1 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_0.SAR is created, where is replaced by the version number of the file.3. Extract the LUMIRASERVER_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://:80/sap/hana/xs/lm5. 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira Serverc. 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.ResultsSAP Lumira Server is installed.Next StepsYou must create administration users and configure SAP Lumira Server before using it for the first time. See To create administration users [page 29].6.5To assign catalog privileges to roles (SAP HANA SP09 and later)PrerequisitesNoteThis 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::AdministratorSAP Lumira Server Installation GuideInstalling and configuring SAP Lumira Server 2015 SAP SE or an SAP affiliate company. All rights reserved. 25ContextSAP 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 requiredsap.bi.admin::BI_CONFIGURATORSAP Lumira Administration with the role sap.bi.admin.configcatalog:AdminConfigThe configuration user, for example LUMIRACONFIG, must have this privilege in order to use SAP Fiori to configure SAP Lumira Server.sap.bi.admin::BI_ADMIN SAP Lumira Administration with the id sap.bi.admin.catalog:AdminExtensionsA user must have this privilege in order to add the Manage Lumira Extensions tile to SAP Fiori.sap.bi.common::BI_DATA_CONSUMERSAP Lumira End users must have this privilege in order 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.Procedure1. 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://:80/sap/hana/uis/clients/role-editor/RoleEditor.html?scenario=onPremise3. 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira ServerFor 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.SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira Server 2015 SAP SE or an SAP affiliate company. All rights reserved. 276. 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira Server8. Repeat this procedure for each of the roles listed in the table above.9. Close the Role Assignment application.ResultsThe roles now have sufficient privileges to allow configuration of SAP Lumira Server.Next StepsCreate administration users with sufficient roles to configure SAP Lumira Server. See To create administration users [page 29]6.6To create administration usersPrerequisites 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].ContextCreate the following user accounts. These user accounts will be used to administer and configure SAP Lumira Server.SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira Server 2015 SAP SE or an SAP affiliate company. All rights reserved. 29Table 10:User account description Example Required rolesAccount used to configure SAP Lumira Server.LUMIRACONFIG sap.bi.admin::BI_CONFIGURATORTechnical 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_USERWe recommend that you print the section Required information [page 5] and use it to record the user accounts that you create in this section.Procedure1. 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://:80/sap/hana/xs/formLogin/Next StepsPrepare SAP Lumira Server for configuration. See To prepare SAP Lumira Server for configuration [page 30].6.7To prepare SAP Lumira Server for configurationPrerequisitesA user account with the sap.bi.admin::BI_CONFIGURATOR role must exist, for example LUMIRACONFIG. See To create administration users [page 29].30 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira ServerContextYou 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.Procedure1. Launch SAP Fiori on your SAP HANA system:http://:80/sap/bi/launchpad/fioriFor example,http://MyHanaServer:8000/sap/bi/launchpad/fioriNote 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.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 .4.Click Go Back to return to the SAP Fiori launchpad.ResultsThe Configuration tile for SAP Lumira Server appears in the SAP Fiori launchpad under My Home.Next StepsConfigure SAP Lumira Server. See To configure SAP Lumira Server [page 32].SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira Server 2015 SAP SE or an SAP affiliate company. All rights reserved. 316.8To configure SAP Lumira ServerPrerequisites 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].ContextThe 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.NoteThe 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.Procedure1. Log on to SAP Fiori with the LUMIRACONFIG user.http://:80/sap/bi/launchpad/fioriFor example,http://MyHanaServer:8000/sap/bi/launchpad/fiori2. 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira ServerReplace 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.ResultsThe 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 StepsConfigure end users and log in to SAP Lumira Server. See Creating users [page 34]Related InformationWorking with SAP Fiori [page 50]SQL setup on SAP HANA [page 54]SAP Lumira Server Installation GuideInstalling and configuring SAP Lumira Server 2015 SAP SE or an SAP affiliate company. All rights reserved. 337Creating usersSAP 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.1User rights and rolesEnd 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 Descriptionsap.bi.common::BI_DATA_CONSUMER 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.NoteIn order to improve HANA SPS08 performances, you can optionally set the following application privilege:CALL _SYS_REPO.GRANT_APPLICATION_PRIVILEGE(sap.bi.sa::SA_EXECUTE, UPPER('));To revoke an application privilege:CALL _SYS_REPO.REVOKE_APPLICATION_PRIVILEGE(sap.bi.sa::SA_EXECUTE', UPPER(')); For more information see the SAP HANA Security Guide.sap.bi.common::BI_DATA_ANALYSTA 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.NoteThis 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideCreating usersNote 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://:80/sap/bi/launchpadFor example:http://MYSERVER:8000/sap/bi/launchpadRelated InformationTo test user rights and roles [page 35]7.2To test user rights and rolesContextThe following steps outline a basic example for how to configure and test end user rights and roles.NoteUsers LSANALYST and LSCONSUMER are for testing and demonstration purposes only. Implement your own users as required.Procedure1. 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://:80/sap/bi/launchpad.You can also test sharing a published dataset and story in SAP Lumira Server.SAP Lumira Server Installation GuideCreating users 2015 SAP SE or an SAP affiliate company. All rights reserved. 352. 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://:80/sap/bi/sa/versionb. 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.3To use SAP HANA Studio to specify the roles available for sharingPrerequisitesIn 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.ContextIn 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.Procedure1. Launch SAP HANA Studio and open your SAP HANA system.36 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideCreating users2. Navigate tosecurity rolesand 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.ResultsThe selected role is available for sharing.SAP Lumira Server Installation GuideCreating users 2015 SAP SE or an SAP affiliate company. All rights reserved. 378Installing and uninstalling chart extensionsSAP 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 InformationWorking with SAP Fiori [page 50]8.1To create an extension management userA user must be assigned to BI_ADMIN in order to manage chart extensions.Procedure1. 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 InformationUser rights and roles [page 34]38 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideInstalling and uninstalling chart extensions8.2To add the Manage Lumira Extensions tile to SAP FioriPrerequisites 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].ContextBefore you can add extensions, you need to add the extension management tile to your SAP Fiori launchpad.Procedure1. 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.ResultsThe extension management tile appears in the SAP Fiori launchpad under My Home.8.3To install chart extensionsPrerequisitesTo 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].SAP Lumira Server Installation GuideInstalling and uninstalling chart extensions 2015 SAP SE or an SAP affiliate company. All rights reserved. 39ContextThe following steps show how to install extensions on SAP Lumira Server.Procedure1. Log on to SAP Fiori.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.NoteA 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.ResultsThe 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 InformationWorking with SAP Fiori [page 50]8.4To update a chart extensionPrerequisitesTo 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideInstalling and uninstalling chart extensionsContextThe following steps show how to update extensions added to SAP Lumira Server.Procedure1. Log on to SAP Fiori.2. Click the Manage Lumira Extensions tile.The extension manager will appear, including a list of all extensions currently installed.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.NoteThe version number of the new extension bundle must be higher than the version number of the extension bundle currently installed.ResultsThe extension is updated. The version number displayed in the extension manager is updated to reflect the new version.Related InformationWorking with SAP Fiori [page 50]8.5To uninstall a chart extensionPrerequisitesTo 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].SAP Lumira Server Installation GuideInstalling and uninstalling chart extensions 2015 SAP SE or an SAP affiliate company. All rights reserved. 41ContextThe following steps show how to uninstall extensions added to SAP Lumira Server.Procedure1. Log on to SAP Fiori.2. Click the Manage Lumira Extensions tile.The extension manager will appear, including a list of all extensions currently installed.3. Select the extension you want to uninstall.4.Click the delete icon.ResultsThe extension is uninstalled.NoteIf you delete an extension, and then try to view a visualization that uses the extension, an error will appear.Related InformationWorking with SAP Fiori [page 50]42 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideInstalling and uninstalling chart extensions9To generate time dataTo explore data published from SAP Lumira that includes date dimensions or time hierarchies, you must first generate time data in SAP HANA Studio.ContextThe 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.Procedure1. Open the SAP HANA Studio Modeler perspective.2. ClickHelp 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.NoteSAP 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.SAP Lumira Server Installation GuideTo generate time data 2015 SAP SE or an SAP affiliate company. All rights reserved. 4310To enable currency conversion for usersContextTo use currency conversion, a user must be authorized to access the currency tables.Procedure1. 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideTo enable currency conversion for users11Backing up and restoring your serverThe following section describes how to backup and restore your data in SAP Lumira Server.11.1To backup dataProcedure1. 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.NoteYou 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.2To back up configurationProcedure1. Locate your configuration files.By default configuration files are stored in the following location: $DIR_INSTANCE/../SYS/global/hdb/custom/config2. Copy all .ini files in the /config directory to a location of your choice.NoteThe .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.SAP Lumira Server Installation GuideBacking up and restoring your server 2015 SAP SE or an SAP affiliate company. All rights reserved. 4511.3To restore dataPrerequisitesA backup of the data must be available.Procedure1. 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.ResultsWhen 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.4To restore configurationPrerequisitesA backup of the configuration must be available.ProcedureCopy the .ini files you previously saved to the config directory.$DIR_INSTANCE/../SYS/global/hdb/custom/config46 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideBacking up and restoring your serverResultsWhen you log in to SAP HANA Studio and refresh your system, all configuration settings should match the configuration of the backed up system.SAP Lumira Server Installation GuideBacking up and restoring your server 2015 SAP SE or an SAP affiliate company. All rights reserved. 4712To undeploy SAP Lumira ServerContextIf 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.NoteIf you undeploy the delivery unit, all saved data associated with the previous release will be erased.Procedure1. Turn off background jobs.a. Access the SAP HANA XS Administration Tool.http://:80/sap/hana/xs/admin/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 tosap 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=:315 --user= --password=Replace with your SAP HANA system administrator name, and 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideTo undeploy SAP Lumira ServerResultsThe delivery unit is undeployed.SAP Lumira Server Installation GuideTo undeploy SAP Lumira Server 2015 SAP SE or an SAP affiliate company. All rights reserved. 4913Appendix13.1Working with SAP FioriTo 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 InformationTo configure the SAP Fiori catalog on an ABAP application server [page 50]Accessing SAP Fiori [page 51]13.1.1To configure the SAP Fiori catalog on an ABAP application serverContextSAP 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.NoteIn SAP HANA, SAP Lumira Server automatically appears, and the SAP Fiori catalog does not require extra configuration.50 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideAppendixProcedure1. 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///wdisp, where is your server ID, and is your computer name.b. Add SAP HANA information to the profile.wdisp/system_15 = SID=, EXTSRV=https://:43, SRCSRV=*:53290, SRCURL=/sap/bi/;/sap/viz/;/sap/vi/;/sap/ui5/;/sap/hana/Replace with the ID of your SAP HANA server. Replace with the name of your SAP HANA server. Replace with the SAP HANA server instance. For example, EXTSRV=https://myhanaserver:4303For 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.ResultsSAP Lumira Server can be selected from the catalog in the SAP Fiori launchpad.13.1.2Accessing SAP FioriTo access SAP Fiori use one of the following:NoteThe URL may have been customized by your administrator. Contact your administrator for the correct URL. On an SAP HANA system, use this URL:http://:80/sap/bi/launchpad/fioriFor example, http://MyHanaServer:8000/sap/bi/launchpad/fiori.SAP Lumira Server Installation GuideAppendix 2015 SAP SE or an SAP affiliate company. All rights reserved. 51 On an ABAP-based SAP system, use this URL:https://:/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.htmlReplace with the name of your ABAP front-end server. Replace with the SAP NetWeaver Gateway port number.For example, https://MyABAPServer:8000/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html.13.2Logging server activityLogging 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 Descriptionsap.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_.trc log file. The xsengine_alert_.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_.trc log file.In the xsengine_alert_.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.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..trc_ and scriptserver_alert.trc_ log files.NoteThere 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideAppendix13.2.1To enable component-level tracingPrerequisitesYou must have SAP HANA Studio installed and access to the system that SAP Lumira Server is installed on.Procedure1. 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.2To view trace filesPrerequisitesYou must have SAP HANA Studio installed and access to the system that SAP Lumira Server is installed on.Procedure1. 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_...trc or scriptserver_...trc_ 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.SAP Lumira Server Installation GuideAppendix 2015 SAP SE or an SAP affiliate company. All rights reserved. 53ResultsIn the case of errors, the XS Engine will log details to the file named xsengine_alert_.trc. If the errors are the result of SAP HANA query execution, you will find additional details in the file named indexserver_alert_.trc. Replace with your SAP HANA server host name.13.3SQL setup on SAP HANAThe 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:PublishingThe 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.ExtensionsThe 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.lib.extensions::ExtensionRepoConnection.Self-service AnalyticsThe 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.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".DiscoverThe 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideAppendixData AcquisitionThe 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.da.logic::RepoConnection.13.4Client authenticationFor information on configuring client authentication, for example setting up SAML, or X.509 authentication, see the SAP HANA Administration Guide.13.5Common installation problems and troubleshooting13.5.1SAP HANA Lifecycle Manager displays an error when clicking RunProblemSAP 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 unitCauseThe 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.SolutionIn 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.SAP Lumira Server Installation GuideAppendix 2015 SAP SE or an SAP affiliate company. All rights reserved. 5513.5.2SAP HANA Lifecycle Manager does not accept the SAP Lumira Server installation packageProblemSAP HANA Lifecycle Manager does not accept the SAP Lumira Server installation package.CauseSAP HANA Lifecycle Manager accepts only .zip files that have the correct metadata and internal format.SolutionUse 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.3SAP HANA Lifecycle Manager displays an error when trying to deploy contentProblemOn the main page of SAP HANA Lifecycle Manager, when you click Deploy Content, an error message may be displayed.CauseSAP HANA Lifecycle Manager was not signed by the Software Download Center.SolutionDownload SAP HANA Lifecycle Manager from the Software Download Center and reinstall it.56 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideAppendix13.5.4Cannot connect to SAP Lumira Server after a successful deployment to SAP HANA on Amazon Web ServicesProblemThe 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.CauseAmazon Web Services does not have the SAP HANA Extended Application Services port open.SolutionOpen 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-xs-engine-with-aws .13.5.5The web page is not found (404 error) when accessing the SAP Lumira Server or SAP HANA Extended Application Services administration pagesProblemThe 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 CauseSAP 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.SAP Lumira Server Installation GuideAppendix 2015 SAP SE or an SAP affiliate company. All rights reserved. 57SolutionDeploy the missing delivery units (DUs):1. In SAP HANA Studio, clickFile 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_CORPossible CauseIf you are using basic authentication rather than SSO, basic authentication may not be enabled.SolutionEnable basic authentication.1. Launch the SAP HANA XS Administration Tool:http://:80/sap/hana/xs/admin/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.6When trying to publish from SAP Lumira to SAP Lumira Server, the message Not available is displayedProblemWhen trying to publish from SAP Lumira to SAP Lumira Server, the message Not available is displayed.58 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideAppendixCauseThe configuration steps required to allow publishing have not been followed.SolutionFollow the steps in the section To add the Configuration tile to SAP Fiori and To configure SAP Lumira Server.Related InformationTo prepare SAP Lumira Server for configuration [page 30]To configure SAP Lumira Server [page 32]SQL setup on SAP HANA [page 54]13.5.7SAP Lumira Server installation may not succeedWhen installing SAP Lumira Server, messages with the following format may appear:Repository: objects are already locked by another changeInstallation 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.6Using SAP HANA Studio to manage rolesContextBefore 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.SAP Lumira Server Installation GuideAppendix 2015 SAP SE or an SAP affiliate company. All rights reserved. 59To use SAP HANA Studio to add a role to a user:Procedure1. Select the system containing the user.2. ExpandSecurity 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.ResultsThe role is added to the user.60 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideAppendix14Getting supportIn 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.SAP Lumira Server Installation GuideGetting support 2015 SAP SE or an SAP affiliate company. All rights reserved. 61Important Disclaimers and Legal InformationCoding SamplesAny 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.AccessibilityThe 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 LanguageAs 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 HyperlinksThe 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 2015 SAP SE or an SAP affiliate company. All rights reserved.SAP Lumira Server Installation GuideImportant Disclaimers and Legal InformationSAP Lumira Server Installation GuideImportant Disclaimers and Legal Information 2015 SAP SE or an SAP affiliate company. All rights reserved. 63www.sap.com/contactsap 2015 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.