Installation Guide PUBLIC

SAP Decision Service Management 1.0 SP04Document Version: 1.7 – 2016-10-14

SAP Decision Service Management Installation Guide

Content

1 Installation - Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 Installation Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3 Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

4 Installation Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104.1 Define an RFC Connection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104.2 Transfer the Public Key Defined for Decision Service Management to the Managed System. . . . . . . . 114.3 Set up a Managed System Based on the Previous Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

5 Setup for Working with Analytical Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Setup for Using BRFplus with SAP HANA Rules Framework. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Activating OData Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2 P U B L I CSAP Decision Service Management Installation Guide

Content

Document History

CautionBefore you start the implementation, make sure you have the latest version of this document.

The following table provides an overview of the most important document changes.

Table 1:

Version Date Description

1.0 2012-06-29 First version of SAP NetWeaver Deci­sion Service Management Installation Guide

1.1 2013-07-09 Version for SAP NetWeaver Decision Service Management 1.0 SP02

Updated Prerequisites [page 8].

1.2 2014-02-11 SAP NetWeaver Decision Service Man­agement 1.0 SP03

Updated Prerequisites [page 8].

1.3 2014-07-14 SAP NetWeaver Decision Service Man­agement 1.0 SP03

SAP NW 7.40 system requirements up­dated in Prerequisites [page 8].

1.4 2015-12-04 Updated Prerequisites [page 8] sec­tion (added additional required authori­zations).

1.5 2016-01-19 SAP NW 7.50 system requirements up­dated in Prerequisites [page 8].

1.6 2016-01-26 SAP NetWeaver Decision Service Man­agement 1.0 SP04

Added system requirements for DSM 1.0 SP04

SAP Decision Service Management Installation GuideDocument History P U B L I C 3

Version Date Description

1.7 2016-10-14 Updated Prerequisites [page 8] sec­tion for SAP NetWeaver 7.51 and SAP NetWeaver 7.65.

Reorganized the structure of the guide.

Added a new section, Setup for Work­ing with Analytical Mode [page 13].

4 P U B L I CSAP Decision Service Management Installation Guide

Document History

1 Installation - Overview

This guide gives you the information needed to install SAP NetWeaver Decision Service Management (DSM). DSM is an add-on based on SAP NetWeaver. It extends the capabilities of the ABAP-based business rules engine Business Rule Framework plus (BRFplus), which is a part of SAP NetWeaver release 7.02 (or higher). With DSM, you can completely separate the process of rule modeling from rule processing. To accomplish this, you set up a system landscape with a dedicated design time system for rule modeling and administration (SAP NetWeaver release 7.31 SP 4 or higher). In this system, you run the following tools:

● BRFplus workbenchThis is the rule modeling environment provided by BRFplus.

● Decision Service ManagerThis is the administration tool provided by DSM. It is used to associate a BRFplus application in the design time system with another system in your landscape (so-called managed system; the managed system can be a test system, your productive system, or any other system to which you want to connect). With that, the BRFplus application can access the Data Dictionary of the managed system rather than the data in the design time system. Once the functions defined in the BRFplus application have been tested successfully, they can be deployed as services to one or more managed systems.

Figure 1: SAP NetWeaver Decision Service Management System Landscape

SAP Decision Service Management Installation GuideInstallation - Overview P U B L I C 5

2 Installation Information

Required Documentation

The following sections describe the documentation you need for the installation:

● SAP Installation Notes● Information in the SAP Service Marketplace

SAP Installation Notes

You must read the following SAP Notes before you start the installation. These SAP Notes contain the most recent information on the installation, as well as corrections to the installation documentation.

Make sure that you have an up-to-date version of each SAP Note. You can find SAP Notes in the SAP Service Marketplace at http://service.sap.com/notes :

Table 2:

SAP Note Number Title Description

1688842 Installation DECSERMG 100 Describes in detail the technical steps of installing Decision Service Manage­ment

Reuse of BRFplus Services

While DSM is a NetWeaver add-on with respect to the software component stack, it is, at the same time, a functional extension to Business Rule Framework plus (BRFplus), which is part of SAP NetWeaver. As a consequence, DSM uses several objects and services that are already provided by BRFplus. This is true, for example, for the logging functionality where DSM makes use of the same application log objects as BRFplus. For more information, see the BRFplus application help topic Tracing.

Information in the SAP Service Marketplace

As already mentioned, SAP NetWeaver Decision Service Management is an add-on based on SAP NetWeaver 7.3 Enhancement Package 1, Support Package 4 or higher. All the technical information you may need to

6 P U B L I CSAP Decision Service Management Installation Guide

Installation Information

install, upgrade, operate, and maintain an SAP NetWeaver system can be found on SAP Service Marketplace at http://service.sap.com/instguidesnw73 .

Alternatively, you can access all DSM-related information on SAP Help Portal at http://help.sap.com/nwdsm100.

On SAP Service Marketplace, you can also find information on the following topics:

Table 3:

Description Internet Address Details

SAP Notes: Installation note for SAP NetWeaver Decision Service Manage­ment

http://service.sap.com/notes 1688842

Released platforms http://service.sap.com/platforms -

Technical infrastructure – configura­tion scenarios and related aspects like security, load balancing, availability, and caching

http://service.sap.com/ti -

Network infrastructure http://service.sap.com/network -

SAP Decision Service Management Installation GuideInstallation Information P U B L I C 7

3 Prerequisites

SAP NetWeaver Decision Service Management is an add-on based on SAP NetWeaver. For a proper installation of the add-on, you need a system with the following software components installed:

Table 4:

DSM Release SAP NetWeaver Releases

DSM 1.0 SP00 NW 7.31 SP05

NW 7.40 SP02

DSM 1.0 SP01 NW 7.31 SP05

NW 7.40 SP02

DSM 1.0 SP02 NW 7.31 SP08

NW 7.40 SP03

DSM 1.0 SP03 NW 7.31 SP08

NW 7.40 SP05 and SAP Note 1981624

or

NW 7.40 SP07

NW 7.50 SP01

DSM 1.0 SP04 NW 7.31 SP08

NW 7.40 SP05 and SAP Note 1981624

or

NW 7.40 SP07

NW 7.50 SP01

NW 7.51 SP00

NW 7.65

NoteThe software component entry for the SAP NetWeaver Decision Service Management add-on itself is the following:

● DECSERMG 100

8 P U B L I CSAP Decision Service Management Installation Guide

Prerequisites

In addition to this, the following prerequisites must be fulfilled:

● In the DSM system, WebDynpro ABAP must be active.● The following roles are assigned to your user profile:

○ SAP_BC_FDT_ADMINISTRATOR (rule modeling and setting up connections to managed systems)○ SAP_DSM_ADMINISTRATOR (working with the Decision Service Manager)

● A system that you want to set up as a managed system must be based on SAP NetWeaver 2004 (software component SAP_BASIS 640) or higher.

NoteTo use analytical functions in SAP DSM 1.0 SP04, the following is required:

● SAP NetWeaver 7.51 SP00 or SAP NetWeaver 7.65● SAP HANA Rules Framework 1.0 SP08 or higher..

For more information, see:

● SAP HANA Rules Framework Installation Guide● Setup for Working with Analytical Mode [page 13]

SAP Decision Service Management Installation GuidePrerequisites P U B L I C 9

4 Installation Procedure

For each system in your system landscape that you want to make available as a managed system for BRFplus, you have to run through all the steps described below:

4.1 Define an RFC Connection

Procedure

1. In the Decision Service Manager system, create an RFC connection (transaction code SM59) to the managed system with the following settings:○ Type: 3 (ABAP connections)○ Logon & Security: Either define a user with the password stored directly in the settings of the RFC

connection, or choose Trust Relationship = Yes.Make sure the user that you enter in the RFC connection has the SAP_BC_FDT_ADMINISTRATOR role assigned. In addition, you also need to make sure that this user has the following authorization objects with the given settings assigned:

Table 5: Authorization Objects

Authorization Object Field Value

S_DEVELOP ACTIVT 1

2

3

6

7

16

DEVCLASS $TMP

OBJNAME /FDT/*

10 P U B L I CSAP Decision Service Management Installation Guide

Installation Procedure

Authorization Object Field Value

OBJTYPE CLAS

CLSD

FUGR

PROG

P_GROUP *

S_RFC ACTIVT 16

RFC_NAME FDT_BRS_REMOTE_GENERATION

FDT_REMOTE_SERVICE

SRFC

SYST

RFC_TYPE FUGR

2. Save your settings and leave the transaction.

4.2 Transfer the Public Key Defined for Decision Service Management to the Managed System

Procedure

1. In the DSM system, start the Trust Manager (transaction code STRUST).

2. In the list of keys, select the System PSE node.3. Doubleclick the value shown in the Owner field.

The system populates the fields in the Certificate group with the data that belong to the selected certificate.

4. Choose Export certificate to export the key data to a local certificate file.5. In the managed system, start the Trust Manager transaction and select the System PSE node.6. Choose Import certificate to import the key data from the certificate file that you have created in the

previous step.7. Choose Add to Certificate List to include the imported key to the list of trusted certificates of the managed

system.8. Save your settings and leave the transaction.

SAP Decision Service Management Installation GuideInstallation Procedure P U B L I C 11

4.3 Set up a Managed System Based on the Previous Steps

Procedure

1. In the DSM system, start the Decision Service Manager (transaction DSM).

2. Click Edit to enter the DSM edit mode.

NoteIn Decision Service Manager, only one user can use the tool in edit mode. All other users are restricted to read-only mode as long as there is one user logged on in edit mode.

3. Click New to create a new managed system. Enter a system name and a description of your choice. For the RFC Destination, enter the technical name of the RFC connection that you have created as described above.

4. In the Details section of the newly created managed system, go to the Applications tab.5. Click Add to associate one of the already existing BRFplus applications with the managed system, or click

New to create a new application that is associated to the managed system.6. Save your settings.

Results

Once you are done with the steps described above, business users can start modeling rule applications in the BRFplus workbench, thereby accessing the ABAP Dictionary objects that are stored in the managed system to which the application is associated.

12 P U B L I CSAP Decision Service Management Installation Guide

Installation Procedure

5 Setup for Working with Analytical Mode

You can work with analytical mode in BRFplus to perform a business rules evaluation of a large set of data persisted in a SAP HANA database.

Prerequisites

● SAP NetWeaver 7.51 SP00 and higher, or SAP NetWeaver 7.65 and higher● SAP Decision Service Management 1.0 SP04● SAP HANA Rules Framework 1.0 SP08 or higher. For more information, see the relevant version of the

SAP HANA Rules Framework Installation Guide on the SAP Help Portal at https://help.sap.com/viewer/p/SAP_HANA_RULES_FRAMEWORK.

Context

The following steps are required before you can use analytical rules in BRFplus workbench.

Setup for Using BRFplus with SAP HANA Rules Framework

Procedure

1. Create a SAP HANA user.2. Assign the role HRF_TECH_ROLE_ABAP_ONLY.hdbrole to the SAP HANA user.

3. Create an RFC connection to the SAP HANA XS server using transaction code SM59.4. Create a new entry under HTTP Connections to External Server with the following settings.

Table 6:

Setting Tab Description

RFC Destination Name of the RFC destination to the external server

Target Host Technical Settings SAP HANA XS server host name

SAP Decision Service Management Installation GuideSetup for Working with Analytical Mode P U B L I C 13

Setting Tab Description

Service No. Technical Settings Service number in the format 80<IN­STANCE>, for example, 8000

User Name Logon & Security SAP HANA user that you created

Password Logon & Security SAP HANA user password

Status of Secure Protocol Logon & Security Security settings

5. Create and run a report to register the RFC connection to BRFplus that you created. (You can use the following code sample.)

Sample Code

"set connection for client cl_fdt_setting=>set_xs_compiler_rfc_conn( EXPORTING iv_rfc_connection = '<RFC Connection Name>' " Logical Destination (Specified in Function Call) iv_client = '<client number>' ).

6. Test the connection by running transaction FDT_TEST_HRF_CMP_CON.

On successful setup, the following message is displayed:

HRF server communication using RFC destination <RFC_name> is valid.

Activating OData Services

Context

These steps are only relevant for on-premise installations and should be performed in the back-end server.

Procedure

1. Activate the Rule OData service.a. Start transaction /IWFND/MAINT_SERVICE.b. Choose Add Service and set the following parameters:

○ System Alias - LOCAL, or the name of your system alias○ Technical Service Name - RULE_SRV○ External Service Name - RULE_SRV

c. Choose Get Services.

14 P U B L I CSAP Decision Service Management Installation Guide

Setup for Working with Analytical Mode

d. In the Select Backend Services list, select the service you just created and choose Add Selected Services.

e. In the Add Service dialog, set Package Assignment as $TMP or choose Local Object.f. Choose Confirm.

2. Activate the Vocabulary OData service.a. Start transaction /IWFND/MAINT_SERVICE.b. Choose Add Service and set the following parameters:

○ System Alias - LOCAL, or the name of your system alias○ Technical Service Name - VOCABULARY_SRV○ External Service Name - VOCABULARY_SRV

c. Choose Get Services.d. In the Select Backend Services list, select the service you just created and choose Add Selected

Services.e. In the Add Service dialog, set Package Assignment as $TMP or choose Local Object.f. Choose Confirm.

SAP Decision Service Management Installation GuideSetup for Working with Analytical Mode P U B L I C 15

Important Disclaimers and Legal Information

Coding 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 willful 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).

16 P U B L I CSAP Decision Service Management Installation Guide

Important Disclaimers and Legal Information

SAP Decision Service Management Installation GuideImportant Disclaimers and Legal Information P U B L I C 17

go.sap.com/registration/contact.html

© 2017 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.