Getting Started with SAP Customer Activity Repository 2.0 ... · PDF file1 Overview ... future retail solution portfolio where all Retail business solutions can take root in a

Getting Started Guide

Document Version: 1.0 – 2015-10-27

CUSTOMER

Getting Started with SAP Customer Activity Repository 2.0 on SAP HANA SP8 [Partner Edition]

Table of Contents

1 Overview .......................................................................................................................................................... 3

2 Solution Information...................................................................................................................................... 4 2.1 Release and Support Package level ....................................................................................................................... 4

3 Solution Provisioning in SAP Cloud Appliance Library ............................................................................. 5

4 Connecting to your solution ......................................................................................................................... 6 4.1 Connecting to the SAP Customer Activity Repository ......................................................................................... 6

4.1.1 Mapping hostnames to IP address ........................................................................................................ 6 4.1.2 Remote Desktop Client ........................................................................................................................... 6 4.1.3 Connecting with RDP .............................................................................................................................. 7 4.1.4 Using SAP GUI for Windows ................................................................................................................... 7 4.1.5 Using SAP HANA Studio ......................................................................................................................... 7 4.1.6 Connecting to Your Backend on OS Level ............................................................................................ 8 4.1.7 Accessing your Backend Instance locally ............................................................................................. 8

5 Security Aspects .......................................................................................................................................... 10

6 Licenses ......................................................................................................................................................... 13 6.1 ABAP License ......................................................................................................................................................... 13 6.2 SAP HANA License ................................................................................................................................................ 13

7 Additional Information ................................................................................................................................ 14 7.1 OS Access to the Solution Instances ................................................................................................................... 14

8 Troubleshooting ........................................................................................................................................... 17

3

1 Overview

This quick guide provides information you need for setting up the SAP HANA Customer Activity Repository 2.0

system in the Cloud environment.

The pre-assembled system is delivered through a virtual appliance format that is specifically optimized for Cloud

deployment. The virtual appliance already contains a pre-installed system landscape and required software

components (for example, SAP Customer Activity Repository Applications Bundle 1.0 SP01), as well as the

database (SAP HANA).

This guide provides general information you need to use the solution SAP Customer Activity Repository 2.0 –

Developer Edition for Partners.

4

Getting Started with SAP Customer Activity Repository 2.0 on SAP HANA SP8 [Partner

Edition]

2 Solution Information

SAP Customer Activity Repository is a foundation that collects data on customer activities across all

interaction channels that was previously spread over multiple applications in diverse formats and provides a

foundation for advanced consumer analytics and cross-channel process support. It is the center piece of the

future retail solution portfolio where all Retail business solutions can take root in a common foundation with a

harmonized data model. SAP Customer Activity Repository stores data in in-memory at the most granular

level of detail allowing embedded science layer to execute advanced statistical algorithms and pattern

predictions

This virtual appliance can be used to learn about the scope of the SAP Customer Activity Repository

2.0 solution based on SAP Customer Activity Repository Applications Bundle 1.0 SP01.

In the system all the required software components are installed and the required SAP Notes

are applied. In addition business processes are configured and also test data are applied.

This solution comprises a backend image and a frontend image which can be instantiated using the Create

Instance command.

2.1 Release and Support Package level

Backend [SUSE Linux Enterprise Server 11 SP03]

[Main Component]: SAP Customer Activity Repository 2.0

[Stack-no. of Main Component]: 2.00 SP01

[Main Component]: SAP High Performance Analytic Appliance 1.0

[Stack-no. of Main Component]: 1.00.85

[Main Component]: SAP NetWeaver Application Server ABAP 7.4

[Stack-no. of Main Component]: 7.40 SP09

[Main Component]: SAP LT server

[Stack-no. of Main Component]:

Frontend [Microsoft Windows Server 2008 R2, AWS AMI]

[Main Component]: SAP JVM 8

[Stack-no. of Main Component]: 8.1.000

5

3 Solution Provisioning in SAP Cloud Appliance Library

If you have a user in SAP Cloud Appliance Library, you need to meet the following prerequisites before starting to

use the SAP Cloud Appliance library:

- Cloud Provider Configurations

You have a valid account in one of the cloud providers supported by SAP Cloud Appliance Library. If you already

have an active cloud provider account, you can proceed directly with the next section. Otherwise, navigate to the

cloud provider home page and sign up.

For more information about the supported cloud providers, see the FAQ page.

- Navigate to SAP Cloud Appliance Library

Open the SAP Cloud Appliance Library in your Web browser using the following link: https://cal.sap.com

For more information about how to use solutions in SAP Cloud Appliance Library, see the official documentation

of SAP Cloud Appliance Library (choose Support Documentation link and choose (expand all) button to see

all documents in the structure). You can also use the context help in SAP Cloud Appliance Library by choosing the

Help panel from the right side.

http://scn.sap.com/docs/DOC-33673

https://cal.sap.com/

6


Edition]

4 Connecting to your solution

4.1 Connecting to the SAP Customer Activity Repository

4.1.1 Mapping hostnames to IP address

Your Amazon VPC setup needs to have a DHCP Option Set which defines a domain-name <Domain Name>. If this

is not the case create the DHCP Option set terminate your CAL instance and create a new one. This is necessary

as <Domain Name> is used in the CAL instance creation process.

When creating a CAL instance the solution is deployed to a server with the predefined virtual host names

vhmonrtpdb, vhmonrtdci and vhmonrtdcs. You are also provided <IP Addresses> with which you can access the

servers. You can find the <IP Address> of the respective servers by clicking on the name of your instance in the

SAP Cloud Appliance Library. ABAP application server RTD the SAP HANA server RTP with the help of an entry for

vhmonrtpdb in its local /etc/hosts file.

Regarding <IP Address>: By default, it will be provided two IP addresses of Netweaver and the windows frontend

Internal IP address and external IP address. You can use internal IP address or external IP address according to

different scenario.

You still need to publish a mapping between the server names and the IP address in your network. You could do

this within your Domain Name Service (DNS) setup or adjust the hosts file on the client.

The following steps describe how to adjust the hosts file on the client:

4.1.2 Remote Desktop Client

For connecting to your frontend instance you need an RDP client for your local operating system:

Microsoft Windows: Start the Remote Desktop Connection using the Start Menu (All Programs > Accessories) or

executing mstsc.exe.

Apple Mac OS X: Use the free Microsoft Remote Desktop app available in the Mac App Store to connect to your

frontend.

Linux: You can use open source RDP clients like rdesktop or FreeRDP.

https://itunes.apple.com/en/app/microsoft-remote-desktop/id715768417

http://www.rdesktop.org/

http://www.freerdp.com/

7

4.1.3 Connecting with RDP

You can find the <IP Address> of your frontend instance by clicking on the instance name in your SAP Cloud

Appliance Library account. Take the IP of the frontend instance and use the OS user “Administrator” with your

master password to log in with your remote desktop client.

4.1.4 Using SAP GUI for Windows

SAP GUI for Windows is already installed on your frontend instance with a pre-configured system connection for

SAP Logon. If you want to create an additional entry, proceed with the following steps:

Start the SAP Logon.

Choose new entry User defined.

In the System wizard, specify the following parameters:

Parameter ID Parameter Value Note

Application Server vhmonrtdci The hostname of the instance from SAP

Cloud Appliance Library

Instance Number 00 ABAP instance number used by the

appliance.

System-ID RTD ABAP system id used by the appliance.

User Name Client 900: DISPLAY Default user

Password Show123

User Name Client 900: MASTER, Default user

Password Initial1

It is recommended that you change the password for all users directly after creation of the instance.

4.1.5 Using SAP HANA Studio

The pre-installed SAP HANA Studio on your frontend instance also contains the ABAP Development Tools, the

SAPUI5 Tools, and the BW Modeling Tools. In the Systems view of the HANA Development perspective you find a

pre-configured connection to your HANA system, using the following parameters:


Hostname vhmonrtpdb The hostname of the instance from the SAP Cloud

Appliance Library

8


Edition]

Instance Number 02 HANA instance number used for the appliance.

User Name SYSTEM

For the connection to the DB use SYSTEM user.

Password <Master Password> The password is the same as the master password

provided during instance creation in the SAP Cloud

Appliance Library.

The system ID of the database is RTP. It is recognized automatically via the host name.

For detailed information about these SAP development tools for Eclipse, we recommend to use the

documentation available within Eclipse by opening the Help menu > Help Contents or consult the standard

documentation available at http://help.sap.com/.

4.1.6 Connecting to Your Backend on OS Level

In case you want to access your backend instance on OS level (not recommended unless you know what you are

doing), you need an SSH client for your local environment, e.g. PuTTY for Windows.

The following steps describe how to connect to your backend instance using PuTTY, but are similar for alternative

SSH clients:

Click on the instance name in your CAL account, to retrieve the IP of your backend instance and download

the instance key pair (maybe you already downloaded the key pair during instance creation).

Extract the private key of the key pair by using a tool like puttygen.exe.

Open PuTTY and enter the IP of your backend instance.

Navigate to the SSH > Auth node and enter your private key file.

Navigate to the Connection > Data node and enter root as auto-login username.

Save these session settings and hit the Open button.

Now you can log in to your backend instance on OS level (SLES) for monitoring, troubleshooting, or accessing files

on the server.

4.1.7 Accessing your Backend Instance locally

If you want to access SAP HANA or the ABAP application server of your backend instance from your local client

(not via the associated frontend instance),

Before you can use your local SAP client software you have to ensure, that your backend instance is accessible

locally and all required TCP ports are open.

We strongly recommend not to use a public instance for this setup, but instances running in a virtual private cloud

(VPC) with a VPN connection to your local network. For more information, how to create instances in a VPC

please revisit the Using SAP Cloud Appliance Library section.

http://help.sap.com/

http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

9

If your instances are running in a VPC with VPN connection to your local network, you could open all ports by

checking the Open all TCP ports option in the Access Points setting (Virtual Machine tab of your CAL instance). If

you only want to expose the required ports (recommended approach), the list below shows all required TCP ports:

Protocol Port Description

SSH 22 Used for SSH connection to the server

Custom TCP 3200 SAP Dispatcher, used by SAP GUI

Custom TCP 3300 SAP Gateway. Used for CPIC and RFC communication.

Custom TCP 3601 Message Server

HTTP 8002 HTTP (HANA XS)

Custom TCP 30215 External SQL Interface. Used by SAP HANA Studio.

HTTP 50000 HTTP (AS ABAP)

HTTPS 50001 HTTPS (AS ABAP)

Custom TCP 50213 Instance agent. SAP Start administrative channel for low-level

access to the SAP HANA instance to allow features such as starting

or stopping of the SAP HANA database.

Custom TCP 50214 Instance agent (SSL).

After following the steps above you should be able to access your cloud instances from your local environment

and use the locally installed client software.

Please keep in mind that in case of latency or bandwidth issues a remote desktop connection to your frontend

instance might be the better choice.

10


Edition]

5 Security Aspects

This section provides an overview of the security-relevant information.

Be aware that creating your instances in the public zone of your cloud computing platform is convenient but less

secure. Ensure that only port 22 (SSH) is opened when working with Linux-based solutions and port 3389 (RDP)

when working with Windows based solutions. In addition, we also recommend that you limit the access to your

instances by defining a specific IP range in the Access Points settings, using CIDR notation. The more complex but

secure alternative is to set up a virtual private cloud (VPC) with VPN access, which is described in this tutorial on

SCN.

The list below describes the ports opened for the security group formed by the server components of your

solution instance:

To access back-end servers on the operating system (OS) level, use the following information:

Protocol Port Description

SSH 22 Used for SSH connection to Linux-based servers

RDP 3389 Used for RDP connection to Windows based servers

You must change the initial user passwords provided by SAP when you log onto the system for the first time.

Since the Master Password you provided during instance creation in the SAP Cloud Appliance Library are same

for all users. To mitigate the potential security risks (for example, OS users can obtain the password of the

solution while the initial provisioning is in process) we recommend changing the password of the following users:

SYSTEM – this is a HANA user.

The procedure can be executed from SAP HANA Studio:

Start the installed SAP HANA Studio.

From the Navigator view right click with the mouse on SAP HANA instance SID (user SYSTEM).

Select SQL editor.

In the editor, enter the following string:

ALTER USER system PASSWORD <new_password>.

Choose Execute.

Switch on OS to rtdadm user and execute the following command:

“/usr/sap/RTD/hdbclient/hdbuserstore set default vhmondbhdb:30215 SYSTEM <new_password>”

Change password also in properties of the HDB system in the SAP HANA Studio.

o From the Navigator view right click with the mouse on SAP HANA instance SID.

o Select Properties Database User Logon

o Change the password.

http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing



11

SAPRTP – this is a DB user.

As the user is used for the ABAP server connection to the database you should stop the ABAP system during

the password change procedure:

1. As the user is used for the ABAP server connection to the database you should stop the ABAP system

during the password change procedure. On operating system level execute:

2. su – rtdadm

stopsap

exit

3. Start the installed SAP HANA Studio.

4. Open the Systems view and right click with the mouse in this view and then choose Add System…

5. In the System wizard, specify the following parameters:


Hostname <IP Address> The IP address of the instance from the SAP

Cloud Appliance Library

Instance Number 02 HANA instance number used for the appliance.

User Name SAPRTP User used for ABAP DB connections

Password <Master Password> The password is the same as the master

password provided during instance creation in

the SAP Cloud Appliance Library.

6. From the Navigator view right click with the mouse on HANA instance SID (User SAPRTP).

7. Select SQL editor.

8. In the editor, enter the following string:

ALTER USER SAPRTP PASSWORD <new_password>

9. Choose Execute.

10. Switch on OS to rtdadm user and execute the following command:

“/usr/sap/RTD/hdbclient/hdbuserstore set default hanadb:30215 SAPRTP <new_password>”

11. Change password also in Properties of the HDB system in the HANA Studio.

o From the Navigator view right click with the mouse on HANA instance SID.

o Select Properties Database User Logon

o Change the password.

12. Restart the ABAP system: On operating system level execute:

su – rtdadm

startsap r3

exit

rtpadm – this is an OS user.

To change the password you have to logon with the root user to the Linux OS and change the password of

the rtpadm user. For more information, see Connecting to Your Backend on OS Level.

In the Linux console you have to execute the following command: passwd rtpadm and then enter the new

password.

rtdadm – this is an OS user.

12


Edition]

To change the password you have to logon with the root user to the Linux OS and change the password of

the rtdadm user. For more information, see Connecting to Your Backend on OS Level.

In the Linux console you have to execute the following command: passwd rtdadm and then enter the new

password.

MASTER – is an ABAP user.

The default password Initial1.To change the password insert user and password in the SAP GUI login

screen and press the button new password.

We recommend to create new developer users as a copy of user DEVELOPER and use MASTER as an

administrative user.

13

6 Licenses

6.1 ABAP License

SAP NetWeaver comes with a temporary license that is valid for 3 months from the activation of the instance in

the SAP Cloud Appliance Library.

To install a permanent license proceed as follows:

Logon to ABAP via SAP GUI with user SAP* in tenant 000.

Start transaction SLICENSE

Get your license from the service market place at http://www.service.sap.com/licensekey

Use the following data for the license request form:

o System ID: RTD

o System type: Test System

o Product: SAP NetWeaver

o Product Version: SAP NetWeaver 7.4

o Technical Usage: Application Server ABAP

o Database: SAP HANA database

o Operating system: Linux

Click “Install new License” and select the downloaded license from step 3.

6.2 SAP HANA License

The SAP HANA database comes with a temporary license that is valid for 3 months from the activation of the

instance in the SAP Cloud Appliance Library.

To install another license use:

Start the installed SAP HANA Studio.

From the Navigator view right click with the mouse on SAP HANA instance SID.

Select Properties.

From the Properties dialog box, select the License tab strip

http://www.service.sap.com/licensekey

14


Edition]

7 Additional Information

7.1 OS Access to the Solution Instances

If you need OS access, you must use SSH connectivity. Use the default user root and the private key for the

instances, downloaded while your landscaped instance is activated from SAP Cloud Appliance Library.


OS User Name root

The default OS Administrator user for

Linux SUSE

OS Password <none>

Use the private key (downloaded during

the activation of the instance in SAP

Cloud Appliance Library) for login with

the root user.

The administration users for Netweaver are defined as follows:


SAP NetWeaver

administrator name rtdadm

Additional user on OS to perform

administrative tasks on SAP system.

SAP NetWeaver

administrator Password <Master Password>

The password is the same as the master

password provided during instance

creation in the SAP Cloud Appliance

Library.

The administration users for SAP HANA are defined as follows:


SAP HANA administrator

name rtpadm

Additional user for HANA lifecycle

management – start/stop,

administration, functions, recovery

SAP HANA administrator

Password <Master Password>




Library.

15

Additional users on the operating system level.


SAP System administrator

name sapadm

SAP System administrator

Password <Master Password>




Library.

Parameter Summary

This section gives an overview over all relevant system parameters.


Master Password <Master Password>

You specify the master password during

instance creation in the SAP Cloud

Appliance Library.

Server Domain <Domain Name>

Domain name as specified in your VPC

DHCP Option Set.

Private key <Private Key File>

The private key file is provided during

instance creation in the SAP Cloud

Appliance Library. To be used for SSH

access to the host.

Server IP Address <IP Address>

The IP address of your instance from the

SAP Cloud Appliance Library

Host Name vhmonrtdci

Predefined name of the host on which

SAP HANA and ABAP are running.

HDB System ID RTP

HDB Instance Number 02

DB User / Password

SYSTEM / <Master Password>

SAPRTP / <Master Password>

HDB Administrator OS

Level / Password rtpadm / <Master Password>

ABAP System ID RTD

ABAP Instance number 00

ABAP Client / User /

Password

000 / DDIC / <Master

Password>

000 / SAP* / <Master

Password>

16


Edition]



Password>


Password>


Password>


Password>

900 / DEVELOPER /

<Master Password>

900 / MASTER / Initial1

900 / Display / Show123

ABAP Administrator OS

level / Password rtdadm / <Master Password>

17

8 Troubleshooting

Symptom: You cannot connect to your frontend instance via Remote Desktop Connection.

Please ensure that your local network permits outbound RDP connections on port 3389 (TCP/UDP), i.e. your

firewall/router doesn’t block these connections.

Symptom: You cannot connect to your backend instance via SSH.

Please ensure that your local network permits outbound SSH connections on port 22, i.e. your firewall/router

doesn’t block these connections.

Symptom: You cannot select the Corporate Network option when creating a new solution instance.

The AWS subnet you want to use might be located in the wrong region. Please ensure to create a subnet in the

Amazon region US-East (Virginia).

Symptom: You can’t connect to your backend instance using your local SAP GUI.

1. - Check, if the ABAP server is running:

2. Logon as root to the server on which the database is running (see Connecting to Your Backend on OS Level).

Then execute the following statements to check the status of the ABAP server:

su – rtdadm

sapcontrol -nr 00 -function GetProcessList

- Check if all required TCP ports are open and accessible from your local network:

Please refer to section Accessing your Backend Instance locally for more information.

www.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

www.sap.com/corporate-en/legal/copyright/index.epx for

additional trademark information and notices.

http://www.sap.com/corporate-en/legal/copyright/index.epx

Documents

Getting Started with SAP Customer Activity Repository 2.0 ... · PDF file1 Overview ... future retail solution portfolio where all Retail business solutions can take root in a