SAP Decision Service Management Installation Guide S… · SAP Decision Service Management...
Transcript of SAP Decision Service Management Installation Guide S… · SAP Decision Service Management...
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 Decision 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 Management 1.0 SP03
Updated Prerequisites [page 8].
1.3 2014-07-14 SAP NetWeaver Decision Service Management 1.0 SP03
SAP NW 7.40 system requirements updated in Prerequisites [page 8].
1.4 2015-12-04 Updated Prerequisites [page 8] section (added additional required authorizations).
1.5 2016-01-19 SAP NW 7.50 system requirements updated in Prerequisites [page 8].
1.6 2016-01-26 SAP NetWeaver Decision Service Management 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] section for SAP NetWeaver 7.51 and SAP NetWeaver 7.65.
Reorganized the structure of the guide.
Added a new section, Setup for Working 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 Management
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 Management
http://service.sap.com/notes 1688842
Released platforms http://service.sap.com/platforms -
Technical infrastructure – configuration 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<INSTANCE>, 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.