Contact Us

Setup for Cloud Connector

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

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

Prepare Cloud Connector

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 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 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
    127.0.0.1 localhost monitoring.local
    ::1 localhost monitoring.local
  2. Verify that the alias works
    ping monitoring.local

Create the Certificate Signing Request in Cloud Connector with SAN

  1. Log on to 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 where the 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 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 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: HTTPS
    3. Internal Host: Enter the alias that you created for Cloud Connector
    4. Internal Port: Enter the port where the 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 Cloud Connector
  5. Note down the value of the column "Virtual Host" for later use
  6. In the section "Resources Of <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 Cloud Connector here.

Setup Steps in SAP Cloud ALM

Add Cloud Connector to Landscape Management

  1. Go to Administration → Landscape Management → Systems
  2. Click the "Add" button
  3. Enter:
    1. Product: Select "Cloud Connector"
    2. System Name: Enter a name for the 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 Cloud Connector. If no Location ID is maintained in the “Subaccount Overview”, please leave this field empty.
    5. Connector ID: You find the Connector ID under the view "Connector" in your Cloud Connector
  4. Save

Create HTTP Endpoint

  1. Open the Landscape Management application from the launchpad
  2. Go to "Systems"
  3. Select your 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 Cloud Connector during the setup in Cloud Connector
  8. Under "Authentication" enter
    1. Authentication Type: Basic Authentication
    2. User: The monitoring user created in 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

Troubleshooting & Customer Support

To troubleshoot any issues with the setup or the data collection for Cloud Connector, please follow the Troubleshooting for Cloud Connector page

Should this information not suffice to address your problem please open an incident.