Setup for SAP Process Integration (Java)

This page explains how to connect SAP Process Integration (Java) to SAP Cloud ALM to enable monitoring.

Currently, the following monitoring applications are supported for SAP Process Integration (Java):

Prerequisites

  • Install Cloud Connector in your SAP Process Integration (Java) system network (find more information here)

Setup Steps in Cloud Connector

Connect SAP Cloud ALM Subaccount

  1. Go to the Cloud Connector Administration page
  2. On the "Connector" page* choose "Add Subaccount" 
  3. Connect your SAP Cloud ALM tenant

* Please note: if the SAP Cloud ALM tenant is the first subaccount in this cloud connector you will automatically be forwarded to the "First Subaccount" page.

Add Connection to SAP Process Integration (Java)

  1. Go to Cloud Connector Administration → <SAP Cloud ALM tenant> → Cloud To On-Premise → ACCESS CONTROL
  2. Click the '+' button to add a new entry:
  3. Enter the SAP Process Integration (Java) system as system of Back-end Type: "SAP Application Server Java"
  4. Press "Finish"
  5. Select the entry for your SAP Process Integration (Java) system
  6. Note down the value of the column "Virtual Host" for later use
  7. In the section "Resources Of <SAP PI (Java) system>" press the '+' button
  8. Enter the following values:
    1. URL Path: /mdt_soa/frun with Access Policy: Path And All Sub-Paths
    2. URL Path: /AdapterMessageMonitoring/basic with Access Policy: Path And All Sub-Paths
  9. Press the "Save" button

Verify SAP Web Dispatcher Rules

If you use an SAP Web Dispatcher in your landscape you have to make sure that the requests can be routed successfully. To be able to connect successfully to SAP PI (Java) system, please verify that the following paths are permitted in your Web Dispatcher:

  • /mdt_soa/frun/*
  • /AdapterMessageMonitoring/basic/*

Setup Steps in SAP Process Integration (Java)

Create Technical User

Create a technical user for the data collection and assign a custom copy of the following SAP roles
  1. To collect PI monitoring data: SAP_XI_MONITOR_J2EE and NWA_READONLY
  2. To collect message payload: XI_FRUN_GET_MSG (Available with SAP PI 7.31 SP17+, SAP PI 7.40 SP12+, SAP PI 7.50 SP05+)

Setup Steps in SAP Cloud ALM

Add SAP Process Integration (Java) to Landscape Management

  1. Go to Administration → Landscape Management → Systems
  2. Click the "Add" button
  3. Enter:
    1. Product: Select "SAP Process Integration"
    2. System ID: The SID of SAP PI system
    3. Role: Select the correct system role
    4. Virtual Host and Port: The value from the field "Virtual Host" that is maintained for the SAP PI (Java) system in Cloud Connector (you collected it during the Cloud Connector setup steps above)
    5. Logon URL: The actual URL for the SAP PI (Java) system (host and HTTP(S) port)
    6. System Number: The system number of SAP PI (Java)
    7. Installation Number: The installation number
  4. Save

Create HTTP Endpoint

  1. Open the Landscape Management application from the launchpad
  2. Go to "Systems"
  3. Select your SAP Process Integration (Java) system
  4. On the tab "Endpoints", press the "Add" button to create a new endpoint
  5. Enter a description
  6. Choose the use-case "Integration Monitoring"
  7. The value for "Virtual Host and Port" will be filled automatically
  8. Cloud Connector Location ID: The name (description) of the Cloud Connector instance that you want to use. You find this information in your Cloud Connector or in the SAP BTP Cockpit in the SAP Cloud ALM subaccount under "Connectivity" > "Cloud Connectors". The location ID is the value in parenthesis next to the phrase "Master Instance" for the Cloud Connector you want to use. If you only have one Cloud Connector this value might be empty.
  9. Under "Authentication" enter
    1. Authentication Type: Basic Authentication
    2. User: The technical user created in SAP Process Integration (Java) for this purpose
    3. Password: The password for the user
  10. Save the endpoint.

Next Steps

After creating the endpoint in SAP Cloud ALM, you have to perform the following steps to activate the monitoring use cases: