SAP PDMS 1.0 FP02 On-premise edition 1.0 (Installation – Pt.1)

SAP Predictive Maintenance and Service, on-premise edition supports customers with a unified solution for operators looking to identify issues in large fleets of machines as well as to improve after-sales services and optimize service planning for individual machines.

The following image gives you an overview of what business users see when they work with the asset health control center, to get further detailed information about an asset health status, business users can go to the asset health fact sheet:

In the first part of my documentation (pt.1), I’ll explain and show in detail how to proceed with the mandatory landscape and component setup of the SAP Predictive Maintenance and Service solution.

In the second part (pt.2) I will explain and show how to install and configure a Raspberry PI with GroovePI to generate sensor data and store them in SQL Server

In the last part (pt.3) I will explain how to configure the applications (Thin Model Service, DSS and Insight Provider)

For my setup I’ll use my own lab on VMware vSphere 6.0 to virtualize all my server and a Raspberry PI 3 with GroovePI for sensor device.

I’ll will create a new environment by using vm template explain in my previous documentation.

Disclaimer: My deployment is only for test purpose, I make the security simple from a network perspective in order to realize this configuration and use open source software

In order execution

As mentioned previously, SAP Predictive Maintenance and Service require two mandatory component and one add-on within Hana, to be installed:

• XSA 1.0 including the standard application for administration (XS Monitoring) and job scheduling (XS Services)
• Hana Rules Framework 1.0
• R 3.2.3 and Rserve 1.7.3

Important: SAP PDMS1.0 FP02 is not supported on a SAP Hana database that use MDC.

Once the landscape is installed, the SAP Predictive Maintenance and Service software needs to be deployed. The deployment consist of the below activities:

• Download the PDMS software
• Create the PDMS user space in XSA
• Download or create the extension file for component installation
• Create PDMS technical user for application
• Create the schemas required for the installation
• Install Product Instance 1
• Create role collection and assign to user
• Install all remaining Product Instance

When the SAP Predictive Maintenance and Service software is installed the next step is to perform the setup for data science service, which consist of:

• Install the R package required to work with data science service on RServe

Testing url and services

• Test PDMS urls.
• Test the installation of Data Science Service

Guide used

• Installation of SAP Predictive Maintenance and Service, on-premise edition 1.0 FP02
• SAP HANA Administration Guide SP12
• SAP HANA R Integration Guide

Note used

• 2283623 – SAP Predictive Maintenance and Service, on-premise edition 1.0 FP02
• 2297816 – SAP HANA Smart Data Integration SPS 02 Rev 02
• 2185029 – SAP HANA and R compatibility and support

Link used

• Hana help.sap.com
• R project
• R integration guide
• SAP PDMS 1.0 Guide
• Raspberry PI
• GroovePI

High-Level Architecture overview

From a high level architecture point of view I’ll deploy 3 vms all registered in my internal DNS
vmhana01 – Master Hana single mode
vmscience – R Server
vmsql2012 – SQL Server 2012
Raspberry PI with GroovePI

Detail Architecture

All the environment will be running on SLES 12 SP1, except for SQL server which will sit on Windows 2012 R2 server, the diagram above provide an overview of the components/software interaction.

SAP HANA 1.0 SP12 (Including: XSA, Hana Rules Framework 1.0 )
In the context of SAP PDMS, XSA needs to be install on top of Hana in order to deploy the PDMS application, on Hana itself the HRF 1.0 add-on needs to be install since it is mandatory to run Insight provider.

R 3.2.5 and Rserve 1.7.3
SAP has tested the SAP HANA integration with R version 2.15 only, this component is mandatory for data science service

Raspberry PI with GroovePI (optional)
As an optional component in my scenario, I’ll use my physical Raspberry PI 3 model B with a GroovePI component in order to data from various sensor such as: temperature and humidity, and light.

Microsoft Server 2012 R2 with SDI agent installed on the server (optional)
For my document I will deploy a MS SQL server in order to store my sensor data, the SDI 2.0 agent will be installed on the same server and connect to Hana to retrieve the data

SAP PDMS Product Instance

In SAP PDMS, product instance consist of different subsequent part of landscape deployment such as:

The picture below illustrate the all the product install listed above.

SAP PDMS mandatory component

XSA 1.0 including the standard application for administration

As mentioned earlier, SAP PDMS needs specific mandatory components to be able to be deploy and run, the first piece of the puzzle consist to install XSA on my Hana instance with XS monitoring and XS service tool.

I start to download the component and store it, from “support package and patch”

Download the components from the list
–> path level 32 or 34
–> SP02
–> SP02

Once completed, from the resident hdblcm folder as root, I run the installation of XSA combine with the 2 application

During the installation process pay attention to the XS Controller API url

Once installed, I’ll access the API URL endpoint first and then log into XSA

And finally run the “xs apps” command just to see which application is running

This done I can go to the next phase with installation of the Hana Rules Framework 1.0

Hana Rules Framework 1.0

I start the download from “Installation & upgrade” path

Once downloaded I run the installation from the downloaded folder by “hdbalm”

The install done, I can move forward with the next component to be installed

R 3.2.5 and Rserve 1.7.3 installation

For my setup my R and Rserve will be install on a SLES 11.3 VM that I have already prepared, the necessary latest package to install the software are installed on the server:

• xorg-x11-devel
• gcc
• gcc-fortran
• readline-devel
• Java

From the cran website I download the version 3.2.5 of R because the 3.3.x has not been tested yet

And Rserve 1.7.3

My download ready I decompress the R package and compile it

Run the following command to install R

Once done check in the “/usr/local/bin” directory

R now installed I will install and configure Rserve, from the “/usr/local/bin” directory I execute R and run the Rserve package

Now done I configure Rserve by creating the Rserv.conf file

And I finally start Rserve in order to access it from Hana, from the “/usr/local/lib64/R/bin” folder

Rserve is up now so I’m going to configure Hana so I can connect to it, from the “indexserver.ini -> calcengine” I will add 3 parameter:

• cer_rserve_addresses –> location where the server is running
• cer_timeout –> Connection timeout in seconds
• cer_rserve_maxsendsize –> Maximum size of a result transferred from R to SAP HANA, in kilobyte

The baseline for R is done I will then install the dependent R package on RServe, I will download the package “dplyr , magrittr , survival , data.table , emdis” and installed them manually.

Note: Some dependency may exist for package install which will prevent you to install the necessary if not install, make sure to install them first.

Here the list of package dependency at the time I build the documentation by package

• Dplyr (‘assertthat’, ‘R6’, ‘Rcpp’, ‘tibble’, ‘magrittr’, ‘lazyeval’, ‘DBI’, ‘BH’)

Once installed run the package install in the order as below

1. setwd(“/media/R/R_indep_pack”)    –> this line set R for the package location
2. install.packages(“magrittr_1.5.tar.gz”, repos = NULL, type=”source”)
3. install.packages(“dplyr_0.5.0.tar.gz”, repos = NULL, type=”source”)
4. install.packages(“survival_2.40-1.tar.gz”, repos = NULL, type=”source”)
5. install.packages(“data.table_1.10.4.tar.gz”, repos = NULL, type=”source”)
6. install.packages(“emdist_0.3-1.tar.gz”, repos = NULL, type=”source”)

All mandatory component are installed and ready for SAP PDMS, I can proceed with main component installation.

SAP PDMS installation

To begging I will start to download the necessary software to run the installation.

Now from XSA I will create the user space pdms-op and switch into it, this can be done from command or the XSA admin page. I will use the command line.
This user space is necessary to run the installation

Now done I will download all the extension files which contain details of the user-provided service from the note 2283623.

You can either create them but I will recommend you to use a YAML validator

After all .mtaext are downloaded we I need to edit the necessary input in the “pdms-router.mtaext” which contain all the application setting such as: hana hostname, port, technical user to use, password and URLs.
Note: since I’m not using any CRM or ERP to connect to my PDMS system I will not configure any url in the “ahcc.mtaext” file.

From the file “pdms-router.mtaext” technical user are listed in order to works with the applications:

I run the following SQL command to create all of them

The next phase is now to create the relevant schema required for the installation of each application

Now done, I can run the PDMS application installation, I’ll install the “Product Instance 1” first by running following xs command from the from the folder where the PDMS zip file reside
“xs install SAPPDMSONPR02P_3-71002247.ZIP -i 1 -e pdms-router.mtaext,ahcc.mtaext,derived-signals.mtaext,work-activity.mtaext”

Note: Make sure you are in the user space “pdms-op” before to run the install

In case error happen during the deployment of any apps, you can check the error by executing the following command “ xs logs <app> –last 1000″

Once the Instance 1 is installed I check the running apps

I will now from the role builder create role collection, assign to necessary role template and grant them to the user

I create the following role collection associate with the template below

Finally once all my role are created, from the Hana webide/security I will provide the role create and additional privilege to the necessary user such as below.

Once done for all the user I install the remain Product Instance by issuing the following command
“xs install SAPPDMSONPR02P_3-71002247.ZIP -e pdms-router.mtaext,ahcc.mtaext,derived-signals.mtaext,work-activity.mtaext -o ALLOW_SC_SAME_VERSION”

Data Science Service on RServe

The main software component for PDMS are now fully installed, I will install the R Packages for DSS on Rerve.

I start to decompress the PDMS the zip archive in a separate folder

From this folder I locate the XSACPDMSDSRLIB02_0.ZIP and decompressed it too

Once done for the R server, I will load this package into it

The last package “com.sap.pdms.datascience.tar.gz” required dependency package to be installed “reshape2”,” plyr”,” stringr”,” stringi”

Testing services and URLs

Now the all mandatory component for PDMS are installed and up and running I will test different url to make sure I can access them and also check the DSS (Data Science Service) installation.

The first url I will test is the AHCC, which is the url use by the user who access the Asset Health Fact Sheet application

The next url I will test now is the Launchpad, basically this url is the configuration url role based on different user

PDMS_APP_USER

PDMS_TECH_USER

PDMS_DS_ADMIN

And finally I will test the rest call for DSS in order to make sure that my service working fine, the url should return all package installed and validated the version

I have tested all the necessary url and no error return, the following diagram expose the communication channels and interfaces

The first part of my documentation is now completed, the 2nd part and 3rd part will be available shorty.