Supported SAP NetWeaver AS Java system types

Currently, we only support PI message monitoring for SAP NetWeaver AS Java systems. Hence, it is only possible to successfully connect your SAP NetWeaver AS Java systems to SAP Cloud ALM if they are SAP Process Integration or SAP Process Orchestration systems.

The following use cases are supported:

Integration Monitoring

Prerequisites

Install Cloud Connector in your SAP NetWeaver AS 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 System
  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. Select Back-end Type: "SAP Application Server Java"
  4. Press "Finish"
  5. Select the entry for your new system
  6. Note down the value of the column "Virtual Host" for later use
  7. In the section "Resources Of <SAP 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 system, please verify that the following paths are permitted in your Web Dispatcher:

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

Setup steps in SAP NetWeaver AS 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+)

Please note: These roles will only be available in SAP NetWeaver AS Java with usage type SAP Process Integration to SAP Process Orchestration.

Setup steps in SAP Cloud ALM

Add SAP NetWeaver AS Java to Landscape Management

SAP Netweaver AS Java in SAP ECS

If your SAP Process Integration system is hosted by SAP ECS, e.g., as part of your RISE journey, it will be discovered and automatically imported into SAP Cloud ALM. The system will be imported with the system type "SAP Netweaver AS for Java". You do not need to create a system manually in Landscape Management. 

Please jump to the next section to create the endpoint for the data collection. 

  1. Go to Administration → Landscape Management → Systems
  2. Click the "Add" button
  3. Enter:
    1. Product: Select "SAP Netweaver AS for Java"
    2. System ID: The SID of SAP Process Integration 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 system in Cloud Connector (you collected it during the Cloud Connector setup steps above)
    5. Logon URL: The actual URL for the SAP system (host and HTTPS port)
      Please note: Only HTTPS is supported as URL type. 
    6. System Number: The SAP system number
    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 Netweaver AS for 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.

Endpoint Check for SAP NetWeaver AS Java Endpoint

Since we currently only support PI message monitoring in SAP Cloud ALM, the endpoint check will verify that the connected SAP NetWeaver AS Java system is indeed of the usage type SAP Process Integration or SAP Process Orchestration. 

If you connect a SAP NetWeaver AS Java system with another usage type, the endpoint check will fail.

Next steps

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

Integration Monitoring: Activate Monitoring Data Collection