Connector for LaMa installation and operations guide

Stay organized with collections Save and categorize content based on your preferences.

This guide covers the installation and configuration of the Google Cloud Connector for SAP Landscape Management (Connector for LaMa), as well as operational tasks after the connector is installed.

To install and configure the Connector for LaMa, you perform the following high-level steps:

  • Configure authentication and authorization to the Google Cloud APIs.
  • Download the installation archive from Google Cloud.
  • Install the Connector for LaMa on the same host as SAP Landscape Management. The host can be either a Compute Engine virtual machine (VM) or a virtual or physical machine that is not on Google Cloud.
  • Configure the Cloud Manager for Google Cloud functionality in SAP Landscape Management.
  • Install storage library and operations files on each VM that hosts an SAP system to be managed by SAP Landscape Management.

Prerequisites

Before you can install the Connector for LaMa, you need to install and configure a supported version of SAP Landscape Management. For the supported versions, see Software requirements.

Install SAP Landscape Management according to the SAP Landscape Management installation guides and the SAP Landscape Management Adaptive Design principles.

For more information, see:

Configure authentication and authorization to the Google Cloud APIs

You need to configure CA certificates and, if you need tighter access control, an IAM service account.

Upload CA Certificate for Google API communication

The Connector for LaMa requires a CA certificate to communicate with the Google Cloud APIs. Make sure the following certificates are available in the Trusted CAs view of the SAP NetWeaver Java KeyStore Storage view.

  1. Go to the Google Trust Services repository at https://pki.goog/repository/

  2. In the Download CA certificates section under Subordinate CAs, download CA certificate GTS CA 1C3.

  3. Import the certificate by following the instructions in the SAP NetWeaver documentation: Using the AS Java Key Storage.

Create an IAM service account

Unless you intend to use the service account of the hosting VM instance as the default service account, you need to create an IAM service account for the Connector for LaMa.

To create a service account for the Connector for LaMa:

  1. In the Google Cloud console, go to the Service accounts page:

    Go to Service Accounts

  2. Select your Google Cloud project.

  3. Click Create Service Account.

  4. Specify a name for the service account and, optionally, a description.

  5. Click Create and Continue.

  6. On the Grant this service account access to project step, grant the service account a role that contains all of the permissions that SAP Landscape Management requires. A role can be a predefined role, like Compute Admin, or a custom role that you create that contains the permissions that are listed in Required IAM resource permissions for the Connector for LaMa.

  7. Click Done.

  8. On the Service accounts page in the Google Cloud console, click on the service account that you just created.

  9. Under the service account name, click the Keys tab.

  10. Click the Add Key menu, and then select Create new key to create a service account key.

  11. Accept JSON as the key type and click Create. A private key is saved to your computer. Store the JSON key file in a safe place. Later, when you configure the Cloud Manager function SAP Landscape Management, you copy and paste the contents of the key file into SAP Landscape Management.

Set the JVM to use Internet Protocol version 4

Use either Java System Properties tool of SAP Netweaver Administrator or the SAP NetWeaver Config tool to specify -Djava.net.preferIPv4Stack=true in the JVM system parameters.

When -Djava.net.preferIPv4Stack=true is specified, SAP NetWeaver uses only Internet Protocol version 4 (IPv4).

For more information, see Internet Protocol version 4 (IPv4) requirement.

Download the Connector for LaMa

You download the Connector for LaMa from Google Cloud in a tar file, gcp-connectorversion.tar, that contains the following files:

  • The Connector for LaMa in a Java Enterprise Archive file, lvm.cloud.gcp-version.ear.
  • The Cloud Manager OS storage library:
    • For Linux: libsapacosprep_gcp-version.so
    • For Windows: libsapacosprep_gcp-version.dll
  • Operation definitions that are customized for Google Cloud.
  • Operation scripts that correspond to the operation definitions.

To download the latest version of Connector for LaMa, use one of the following commands:

  • If you have the Google Cloud CLI installed, use the following command:

    gsutil cp $(gsutil cat gs://cloudsapdeploy/lama-connector/LATEST.gs.txt) .
  • If you don't have the Google Cloud CLI installed do one of the following:

    • For Linux run:
      wget $(curl https://storage.googleapis.com/cloudsapdeploy/lama-connector/LATEST.txt)
    • For Windows:
      1. In a browser, display the latest available version of the Connector for LaMa installation .tar file by pasting the following URL into the browser address bar:
        https://storage.googleapis.com/cloudsapdeploy/lama-connector/LATEST.txt
      2. Copy the full URL for the installation file.
      3. Download the file by pasting the URL of the .tar file into the browser address bar and pressing enter.
      4. Save the file to the target server.

With the compressed tar file, Google Cloud also provides an asc signature file, gcp-connectorversion.tar.asc, that you can use to confirm that the gcp-connectorversion.tar file downloaded correctly.

Store the tar file in a Cloud Storage bucket that is accessible to both the SAP Landscape Management server and the servers to be managed, or upload it via the Cloud Shell upload function as described in Transferring files to instances.

Install the Connector for LaMa on the SAP Landscape Management server

To install the Connector for LaMa, you deploy an EAR file to SAP NetWeaver and configure a Cloud Manager for Google Cloud in SAP Landscape Management.

Deploying the Connector for LaMa on SAP NetWeaver

Install the EAR file that contains the Connector for LaMa by using any of the following SAP NetWeaver Java deployment methods (An SAP user account is required):

Configuring the Cloud Manager functionality in SAP Landscape Management

After you install the Connector for LaMa, in the SAP Landscape Management interface, you configure the Cloud Manager functionality for Google Cloud.

The general procedure for configuring Cloud Manager is documented by SAP in Configuring Cloud Managers.

The following steps are specific to configuring a Cloud Manager for Google Cloud.

To configure a new Cloud Manager for Google Cloud, perform the following configuration steps:

  1. In SAP Landscape Management, go to SAP Landscape Management Infrastructure > Cloud Managers.
  2. Create a new Cloud Manager by clicking Add.
  3. From the list of Installed Cloud Manager Types choose Google Cloud Adapter.
  4. In the Basic properties section:
    • In the Label field, enter a name for the Cloud Manager for Google Cloud.
    • In the Monitoring Interval, accept the default of 300 seconds.
    • Leave all other fields blank.
  5. If you are using a dedicated service account for Connector for LaMa, paste the contents of the JSON key file of the service account into the Service Account field in the Additional properties section.
  6. If you are using the service account of the VM for Connector for LaMa, leave Service Account blank.
  7. Perform "Test Configuration" to validate the settings and to test the connection to the Google Cloud API urls.
  8. Choose Next and Save to new Cloud Manager.

Entries in the Virtualization and Storage Manager views are created automatically.

Only the Cloud Manager configuration can be changed; editing is deactivated in the other views.

Configuring support for duplicate IP addresses

If the internal networks within your managed SAP landscape include duplicate IP addresses, configure SAP Landscape Management to use fully-qualified host names to map the managed SAP systems.

To use fully-qualified host names, in SAP Landscape Management monitoring settings, select the Use FQDN Hostnames Only checkbox. For more information, see Configuring Monitoring Settings.

Installing the monitoring agent for SAP NetWeaver

For support and performance monitoring, Google Cloud provides an agent for SAP, the Google Cloud monitoring agent for SAP NetWeaver. The agent collects data about the Google Cloud host machine and its environment from Cloud Monitoring and the Compute Engine APIs and provides that data to the SAP Host Agent.

The monitoring agent for SAP NetWeaver is required for SAP support of SAP systems running on Google Cloud, including SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB and others.

To install the monitoring agent in your Compute Engine VM, regardless of which SAP product you are using, see

After installing the monitoring agent, validate your installation and verify that the agent is running properly. See

Install the OS storage library and operation definitions on the managed VMs

The gcp-connectorversion.tar file includes an OS storage library and operation definitions with their corresponding scripts.

You need to install the OS storage library and operation files on each VM instance that is managed by SAP Landscape Management.

To install an OS storage library and operation definitions on a VM that is managed by SAP Landscape Management:

  1. Download or copy the gcp-connectorversion.tar file to the target VM.
  2. Extract the files in the gcp-connectorversion.tar file into a temporary directory.
  3. Run the installation script:

    • On Linux, enter:
      sudo bash install.sh
    • On Windows, with administrative privileges enter:
      install.cmd

    The install script copies the OS storage library to the directory of the active SAP Host Agent, /usr/sap/hostctrl/exe and the operations files to a subdirectory, /operations.d. The script sets file ownership to root:sapsys and sets appropriate access rights for each file type.

    file ./storage/libsapacosprep_gcp-2.2.15.96.so copied to /usr/sap/hostctrl/exe/libsapacosprep_gcp.so
    file ./storage/Operations/AcActivateIP copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/AcActivateIP
    file ./storage/Operations/AcDeactivateIP copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/AcDeactivateIP
    file ./storage/Operations/ActivateIP.sh copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/ActivateIP.sh
    file ./storage/Operations/DeactivateIP.sh copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/DeactivateIP.sh

Manage SAP systems on Google Cloud with SAP Landscape Management

After the Connector for LaMa is installed and the Cloud Manager function is configured in SAP Landscape Management, you can use SAP Landscape Management to manage SAP systems on Google Cloud. For information about how to use SAP Landscape Management, see the SAP Landscape Management, enterprise edition documentation.

Updating from an earlier release

To update the Connector for LaMa from a previous version, perform the following steps.

  1. In SAP Landscape Management, backup all existing Cloud Manager for Google Cloud configurations before updating the Connector for LaMa. For more information, see Exporting configuration data.
  2. Reinstall the Connector for LaMa. For instructions, see Deploying the Connector for LaMa on SAP NetWeaver.
  3. Replace the existing OS storage libraries and operations files in the managed systems by following the instructions in Installing the OS storage library and operation definitions.
  4. After deployment, restart SAP Landscape Management.

Troubleshooting

By default the SAP Landscape Management system operates on Google Cloud by using the identity of an IAM service account. If you experience authorization errors, first try using gcloud commands to perform the same action that is receiving the error from within the guest operating system. For example:

SAP Landscape Management action Equivalent gcloud command
Stop/start gcloud compute instances stop/start
Clone gcloud compute disks snapshot
gcloud compute disks create
Relocate gcloud compute instances attach-disk
gcloud compute instances detach-disk

The gcloud command output provides you with an indication of whether you are missing authorizations to execute a particular action. If this is successful, but your error persists, contact Support as described in the following section.

Support

If you come across issues with the operation of your SAP Landscape Management system that you need help to resolve, please log a support message via the SAP Support Portal under component BC-VCM-LVM.

If you determine that the root cause of the issue is in the Connector for LaMa, select sub-component BC-VCM-LVM-GOOGLE; however, if you are unsure of the cause of a problem, choose component BC-VCM-LVM, so that SAP support can analyse the issue first.

Information to include:

  • The SAP Landscape Management version
  • The Connector for LaMa version
  • The SAP NetWeaver kernel version
  • The version of the managed SAP system, including the version of the host agent
  • A description of the expected behavior