Contact Us
How you can contact us:

Setup for SAP Cloud Connector

This page explains how to connect SAP Cloud Connector to SAP Cloud ALM to enable monitoring.

Currently, the following monitoring applications are supported for SAP Cloud Connector:

Prepare SAP Cloud Connector

SAP Cloud Connector APIs are only accessible by SSL-enabled HTTP (https://...). This means that localhost is not allowed to be connected to. In order to use a common naming scheme within SAP Cloud Connector, you must use a custom hostname as an alias for the localhost. This must be defined as Subject Alternative Name (SAN) in the SSL Certificate of SAP Cloud Connector and be identical across both master and shadow servers.

The following steps must be performed on both master and shadow servers.

Create an Alias for localhost

  1. Create a local alias in the /etc/hosts file, in this example we create the local alias monitoring.local localhost monitoring.local
    ::1 localhost monitoring.local
  2. Verify that the alias works
    ping monitoring.local

Create the Certificate Signing Request in SAP Cloud Connector with SAN

  1. Log on to SAP Cloud Connector with the Administrator user
  2. Go to Configuration > USER INTERFACE > UI Certificate
  3. Click the "Generate Certificate Signing Request" button
  4. Enter:
    1. Common Name (CN): The hostname of the host SAP Cloud Connector is installed on
    2. Enter the other fields as necessary
  5. Click the "+" button under "Subject Alternative Names"
    1. Select type "DNS"
    2. Enter your local alias (e.g. monitoring.local)
  6. Click the "Generate" button
  7. The signing request will be downloaded as a PEM File
  8. The signing request must be provided to a Certificate Authority (CA) - either one within your company or another one you trust. The CA signs the request and the returned response should be stored in a file.
  9. Click the button "Import a certificate"
  10. Select the certificate you received in response to your signing request
  11. Press "Import"

Setup Steps in SAP 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 Cloud Connector itself

  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:
    1. Back-end Type: Other SAP System
    2. Protocol: HTTP or HTTPS
    3. Internal Host: Enter the hostname of SAP Cloud Connector
    4. Internal Port: Enter the port SAP Cloud Connector is running on
    5. Virtual Host: Enter a hostname
    6. Virtual Port: Enter a port
    7. Allow Principal Propagation: No
    8. Host In Request Header: Use virtual host
  3. Press "Finish"
  4. Select the entry for your SAP Cloud Connector
  5. Note down the value of the column "Virtual Host" for later use
  6. In the section "Resources Of <SAP Cloud Connector>" press the '+' button
  7. Enter the following values:
    1. URL Path: /api/monitoring with Access Policy: Path And All Sub-Paths
    2. URL Path: /api/v1/configuration/connector/haRole with Access Policy: Path Only
    3. URL Path: /exposed with Access Policy: Path Only
  8. Press the "Save" button

Create Monitoring User

Create a user for the data collection and assign the following role to the user:
  • sccmonitoring or sccadmin

You can find more information on how to create named users in SAP Cloud Connector here.

Setup Steps in SAP Cloud ALM

Add SAP Cloud Connector to Landscape Management

  1. Go to Administration → Landscape Management → Systems
  2. Click the "Add" button
  3. Enter:
    1. Product: Select "SAP Cloud Connector"
    2. System Name: Enter a name for the SAP Cloud Connector
    3. Role: Select the correct system role
    4. Location ID: You find the Location ID under the "Subaccount Overview" group in the view for your SAP Cloud ALM subaccount in your SAP Cloud Connector
    5. Connector ID: You find the Connector ID under the view "Connector" in your SAP Cloud Connector
  4. Save

Create HTTP Endpoint

  1. Open the Landscape Management application from the launchpad
  2. Go to "Systems"
  3. Select your SAP Cloud Connector
  4. On the tab "Endpoints", press the "Add" button to create a new endpoint
  5. Enter a description
  6. Choose the use-case "Health Monitoring"
  7. Virtual Host and Port: The value from the field "Virtual Host" that is maintained for the SAP Cloud Connector during the setup in SAP Cloud Connector
  8. Under "Authentication" enter
    1. Authentication Type: Basic Authentication
    2. User: The monitoring user created in SAP Cloud Connector
    3. Password: The password for the user
  9. 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:

  • Health Monitoring: The data collection will be activated with the endpoint creation