© SAP AG

LECTURER NOTES

Product SAP HANA G.B.I. Release 1.0 SP7 Level Instructor Focus Introduction Author Benjamin Wegener Sonja Hecht Oliver Görtz Version 1.0

MOTIVATION Theoretical lectures explain concepts, principles, and theories through reading and discussion. They, therefore, enable students to acquire knowledge and gain theoretical insights. In contrast, case studies allow them to develop their abilities to analyze enterprise problems, learn and develop possible solutions, and make sound decisions. The main objective of the GBI case studies in general is for students to understand the concept of integration. These descriptive and explanatory case studies will allow students to understand the importance and the advantages of integrating different business information systems.

The main goal of this document is to help instructors prepare the SAP HANA system for the HANA Introduction case study process and to support them trouble-shoot problems that might occur during the course. Beside technical and didactic prerequisites, the lecturer notes list actions for testing and correcting student results in the SAP system. In addition, this document describes common problems and explains their reason and solution.

SAP HANA Introduction Curriculum – Lecturer Notes This document is intended to help instructors understand the curriculum exercises and the case study and manage the learning process in and outside the classroom. The main focus lies on prerequisites and common tasks such as testing and trouble-shooting.

© SAP AG Page 2

LECTURER NOTES

Prerequisites

Note Before using the case studies in your classroom please make sure that all technical (user management etc.) and didactic prerequisites are fulfilled. Such prerequisites are briefly pointed out below. Detailed documentation can be displayed at and downloaded from the SAP University Alliances Community (UAC) portal or the UCC web sites.

Technical Prerequisites

Installation of client tools: Before you can start with the SAP HANA curriculum, several client tools have to be installed on each PC that is used in the training.

SAP HANA Studio

Download the SAP HANA Studio from the FTP server on the SAP UA EMEA Portal (https://portal.ucc.uni-magdeburg.de/irj/portal/ftp) at

SAP_HANA HANA Studio SP7 Please contact your UCC regarding the Support Package (SP) suitable for you. Choose Win32 or Win64 32 or 64 Bit Windows system and download the ZIP package. Unpack the archive and start the installation with the hdbinst.exe.

SAP HANA Client

Download the SAP HANA Client from the FTP server on the SAP UA EMEA Portal (https://portal.ucc.uni-magdeburg.de/irj/portal/ftp) at

SAP_HANA HANA Client SP7 Please contact your UCC regarding the Support Package (SP) suitable for you. Choose Win32 or Win64 for 32 or 64 Bit Windows system and download the ZIP package. Unpack the archive and start the installation with the hdbinst.exe.

SAP BusinessObjects Data Services Client Tools

Download the SAP BusinessObjects Data Services Client Tools from the FTP server on the SAP UA EMEA Portal (https://portal.ucc.uni-magdeburg.de/irj/portal/ftp) at

BusinessObjects DataServices Win32/Win64 Choose Win32 or Win64 for 32 or 64 Bit Windows systems and download the executable. Executing the file starts the Installation.

SAP HANA Studio Installation

SAP HANA Client Installation

SAP BusinessObjects Data Services Client Tools

Installation

© SAP AG Page 3

LECTURER NOTES

SAP Predictive Analysis

Download SAP Predictive Analysis from the FTP Server of the SAP UA EMEA Portal (https://portal.ucc.uni-magdeburg.de/irj/portal/ftp) at

BusinessIntelligence PredictiveAnalysis Choose the 32Bit or 64Bit depending on your Operating System. Please make sure to download and install version 1.17. After you downloaded the archive, unzip it using the Password “bipredictive” (without the quotes). Run the extracted executable to install SAP Predictive Analysis.

Client preparation: SAP BusinessObjects Data Services License

Before you can start to use the SAP BusinessObjects Data Services Client Tools like the Data Service Designer, you have to install a valid license key for the software on each client PC. You will get a valid license key with the handing over of your system from your UCC. If you have any questions concerning the license, please contact your UCC. To install the license, open the License Manager with

Start All Programs SAP BusinessObjects Data Services 4.1 SAP BusinessObjects License Manager.

SAP Predictive Analysis Installation

SAP BusinessObjects Data Services License

© SAP AG Page 4

LECTURER NOTES

Enter your license key in the Product Activation Keycodes field and click on Add. Next, click on Save to activate your license.

Entry in hosts file

The SAP BusinessObjects Clients (including the Data Services Client Tools) require an entry in the hosts file of each client. The required line will be provided by your UCC. Open the file

C:\Windows\System32\drivers\etc\hosts and add the line.

Open network ports

To access the different servers respectively services of SAP HANA and SAP BusinessObjects, several network ports need to be opened for communication. The specific ports are communicated by your UCC during handing over. Please contact your local system administrator for further instructions about how to open the network ports.

Hosts file

Network ports

© SAP AG Page 5

LECTURER NOTES

SAP Predictive Analysis

By default, the SAP Predictive Analysis installation includes a temporary license key for 30 days. For UA program members, 180 day keys are available here: http://scn.sap.com/docs/DOC-45789.

To enter a new license key, open SAP Predictive Analysis and choose Help Enter Keycode.

Remark: For connecting SAP Predictive Analysis with SAP HANA, users have to change their initial HANA password once, using the SAP HANA Studio. Instructions on how to change the password using the SAP HANA Studio are provided in the exercise “SAP HANA Data Modeling” in the SAP HANA introduction curriculum.

SAP Predictive Analysis License

Didactic Prerequisites

Before you start teaching we recommend to go through the complete curriculum at least one time and to do all exercises in order to get to know the teaching materials.

We strongly recommend reading this document in order to be able to recognize and solve small problems. If you have any questions, please contact your SAP UCC.

Test curriculum

Read lecturer notes

© SAP AG Page 6

LECTURER NOTES

Student Assessment

Note With the following instructions you can check your students progress and results of the case study of the curriculum #1.

Analytic View / Information Space

1. Open the SAP HANA Studio

2. For each student that you want to check, open his/her analytic view

SAP HANA Systems Content gbi-student-## Analytic Views SALES_AV_##

Here you can check if all fields were created correctly. In order to check if all calculations and data loads were conducted successfully, click on “Data Preview”.

© SAP AG Page 7

LECTURER NOTES

Here you have similar data exploration possibilities as with BusinessObjects Explorer, including filtering, aggregation etc. In order to check the validity of the values, compare them with the data of the GBI_DEMO1_SALES_AV Analytic View.

If you want to check if your students successfully created an information space of the Analytic view which is accessible through the SAP BusinessObjects Explorer, just open the Explorer with your administrative user. You can access all information spaces of your students.

© SAP AG Page 8

LECTURER NOTES

Problem: SAP HANA user locked

Symptom You receive an error message that a user is locked when trying to log on to the SAP HANA System with the user.

Reason The User is either deactivated or locked due to too many failed login attempts Solution Unlock the user or reset the login attempts of the user

Error Message

The screenshot below displays the error message that pops up when the user is deactivated:

The screenshot below displays the error message that pops up when the user is locked due to failed login attempts:

Solution

Open an SQL Editor by making a right click on your SAP HANA System and selecting SQL Console from the context menu

© SAP AG Page 9

LECTURER NOTES

The following command activates the user XX_STUDENT_001. Change the name of the user to unlock a different user: ALTER USER XX_STUDENT_001 ACTIVATE USER NOW;

Execute the command with .

The following command resets the login attempts for the user XX_STUDENT_001. Change the name of the user to reset the login attempts for a different user: ALTER USER XX_STUDENT_001 RESET CONNECT ATTEMPTS;

Execute the command with .

© SAP AG Page 10

LECTURER NOTES

Problem: Password for SAP HANA user not known

Symptom The password for a SAP HANA user is not known.

Reason -/- Solution Reset the password for the SAP HANA user

Solution

Open the administration for the user by navigating to

SAP HANA System Security Users [USER] and double-click on the user

Enter a new password for the user in the fields Password and Confirm.

Execute the command with .

© SAP AG Page 11

LECTURER NOTES

Problem: Additional users for the HANA system are required

Symptom You already use the entire 30 XX_STUDENT_### users, but additional users are required.

Reason -/- Solution If you need additional users for the curriculum, proceed with Solution #1. If you need additional users for other purposes, proceed with Solution #2.

Solution #1

Please contact your curriculum support team and tell them how many additional users you need. Your UCC support will create additional users and distribute the corresponding users.

Solution #2

Open an SQL Editor by making a right click on your SAP HANA System and selecting SQL Console from the context menu

The following command creates a new user “TEST” with the password “Hana2013”. Change the name of the user and/or the password as you wish. CREATE USER TEST PASSWORD Hana2013;

Execute the command with .

A new user with the specified password will be created. The user will be forced to change the

© SAP AG Page 12

LECTURER NOTES

password on the first logon.

A schema with the same name as the user will be created. Only the new user has access to this schema.

Initially, no specific privileges are assigned to the user, so additional privileges have to be assigned to the user depending on your requirements.

© SAP AG Page 13

LECTURER NOTES

Problem: BusinessObjects user locked

Symptom The logon with a BusinessObjects user is not possible

Reason The user is locked Solution Unlock the BusinessObjects

Error Message

Solution

Open the Central Management Console (CMC) of your Business Objects server. The URL of the CMC has been provided to you when your system has been handed over. The URL has the following schema: http://[FQHN of BusinessObjects Server]:8080/BOE/CMC Open the URL with Internet Explorer for the best usability and log on with the following credentials:

© SAP AG Page 14

LECTURER NOTES

1. Enter the name of the BusinessObjects Host, a colon and the port of the BusinessObjects Server, i.e. B06Z:6400

2. Enter the username of your BusinessObjects administrative user. It is composed like: [naming convention] + _ + MASTER

for example UC_MASTER

3. Enter the password for the administrative User

Note: The naming convention for your institute is delivered via the HANA Guidelines that you retrieve on handing over the system.

On the home screen of the CMC, open the user administration by clicking on Users and Groups:

1

2

3

© SAP AG Page 15

LECTURER NOTES

In the Users and Groups view, navigate to your assigned group via Group Hierarchy Data Service Disgner Users UCC_DATA_SERVICES [YOUR GROUP]

© SAP AG Page 16

LECTURER NOTES

On the left hand side, you can see all users that you can use within the system. Double-click on the user that you want to change.

Note: DO NOT CHANGE any users outside of your group; this would affect other institutions working on the same system.

You can see that an account is disabled when the checkbox is selected. To unlock the user, uncheck the checkbox Account is disabled and click on the Save button in bottom left corner.

© SAP AG Page 17

LECTURER NOTES

Problem: Password for BusinessObjects user not known

Symptom The password for a SAP BusinessObjects user is not known.

Reason -/- Solution Reset the password for the BusinessObjects user

Error Message

Solution

Log on to the CMC and navigate to the user administration and your user group as described in the Problem “BuinessObjects user locked”.

Open the user of which the password has to be reset by double-clicking on the user.

© SAP AG Page 18

LECTURER NOTES

To reset the password, enter a new password in the fields Password and Confirm. If you want that the user has to change this password at the next logon, check the checkbox User must change password at next logon. To save, click on the Save button in bottom left corner.

© SAP AG Page 19

LECTURER NOTES

Problem: Cannot connect to SAP BusinessObjects Data Services

Symptom You cannot connect to SAP BusinessObjects Data Services

Reason The required HANA driver for the repository is not selected. Solution Use the Driver Selector tool to mark the required driver as installed.

Error Message

When trying to connect to the repository with the BusinessObjects Data Services Designer, you receive the following error:

Solution

The error occurs because no driver was selected for the HANA database on client side. In order to select the driver, click on “Start” on your Windows Desktop and type in the following line: %LINK_DIR%\bin\ODBCDriversSelector.exe

Press enter to run the driver selector. Select the installed driver for the HANA 1.x ODBC Driver (you need to have the HANA Client software installed), so that the state of the ODBC driver changes to installed.

© SAP AG Page 20

LECTURER NOTES

© SAP AG Page 21

LECTURER NOTES

Problem: Additional users for the BusinessObjects Data Services system are required

Symptom You already use all of the 30 <ID>_STUDENT_### users, but additional users are required.

Reason -/- Solution Create additional users on the BusinessObjects Server

Solution

Log on to the CMC and navigate to the user administration and your user group as described in the Problem “BusinessObjects user locked”.

Click on the Create User button in the upper left corner of the screen.

In the popup, enter all required information.

© SAP AG Page 22

LECTURER NOTES

The “Account Name” is the username of the user and needs to satisfy the following schema: [naming convention] + _ + STUDENT + _ + ###

where ### is a consecutive number, i.e. UC_STUDENT_001

Note: The naming convention for your institute is delivered via the HANA Guidelines that you retrieve on handing over the system.

Next to the account name, a password has to be entered. Always make sure that Concurrent User is selected as Connection Type.

If you want to create more than one user, click on Create in the bottom right corner. The user will be created and the fields reset. Otherwise, click on Create & Close in the bottom right corner.

© SAP AG Page 23

LECTURER NOTES

Problem: The Browser doesn’t show any content

Symptom The content of the site is not available

Reason Wrong implementation / Resources aren’t available Solution Investigate by checking the JavaScript Console

Solution

You are using Google Chrome to check the student’s content in the browser. In the address bar of the browser, you typed in the correct address, for example: http://[FQHN of your SAP HANA Server]:[Development Port HANA Server]/[Client ID]/gbi-student-XXX/PROJECT/WebContent/index.html

If the browser doesn’t show the content that you expect, a first starting point for troubleshooting is the JavaScript Console.

To open the JavaScript Console, click on the menu symbol in the upper right corner of the Chrome browser. Then click on Tools and choose JavaScript-Console.

© SAP AG Page 24

LECTURER NOTES

The JavaScript-Console will open on the bottom of your browser. Red lines show error messages. If the console is empty, open the settings of the JavaScript Console by clicking on the settings symbol

and selecting Disable cache:

Reload the page.

© SAP AG Page 25

LECTURER NOTES

Problem: A file on the HANA Server is declared with “Inactive Version”

Symptom The file is marked with a red rhombus

Reason There is a conflict between two different versions of the file

Solution The file needs to be synchronized

Solution

Files can be updated by other users. Therefore, files can be released in a new Version. If you now want to activate your (different) version that is based on an older version then the updated one in the repository, you get an error.

In that case, the file will be marked with a red rhombus.

To solve that conflict, right-click on your project and choose Team Show in the Synchronize View.

© SAP AG Page 26

LECTURER NOTES

Read the hint and click Yes.

In this view your project will be scanned for conflicting versions of files. These are shown in the left navigation bar.

Double-click on the affected file.

Now, the conflicting versions are shown side by side. On the left side you see your local (inactive) version and on the right side you see the active version from the repository.

Compare the versions. Differences will be marked by a blue bar.

You can change both versions. Afterwards you need to decide which version may solve the conflict. Right-click in the left navigation bar on the affected file and choose Team and then choose between Local Version and Remote Version.

© SAP AG Page 27

LECTURER NOTES

Then you can leave the Synchronizing View by right-clicking the Team Synchronizing button in the upper right angle and clicking Close.

Now your file has the newest version and is also activated.