Install the monitoring agent for SAP NetWeaver on a Bare Metal Solution server

Google Cloud's monitoring agent for SAP NetWeaver is required for SAP support of SAP systems running on a Bare Metal Solution server, in which case, the agent does not include data from Monitoring.

When you install the monitoring agent for SAP NetWeaver on a Bare Metal Solution server, the agent does not require access to the Google Cloud APIs.

To install the monitoring agent for SAP NetWeaver on a Compute Engine machine, see Install the monitoring agent for SAP NetWeaver on a Compute Engine VM.

Installation overview

In Linux, you install the monitoring agent for SAP NetWeaver by using standard operating system package management commands, yum or zypper. The package management command completes the following tasks:

  • Downloads the latest version of the monitoring agent for SAP NetWeaver.
  • Creates the agent as a Linux systemd service, named google-sapnetweavermonitoring-agent.

In Windows, when you issue the install command, the provided installation script completes the following tasks:

  • Downloads the latest version of the monitoring agent for SAP NetWeaver.
  • Creates a Windows service named google-sapnetweavermonitoring-agent and a scheduled task that runs every minute to check if the service is still running and, if necessary, restart it.

Install the monitoring agent for SAP NetWeaver

To install the monitoring agent for SAP NetWeaver, select your operating system, and follow these steps:

Linux

Create the configuration file

You need to create a configuration.yaml file on the Bare Metal Solution server to enable the monitoring agent for SAP NetWeaver for that server.

To create the configuration file, follow these steps:

  1. Establish an SSH connection with your host VM.

  2. Create the configuration.yaml file in the following directory:

    /tmp/gcpsapdeps/configuration.yaml

  3. In the configuration.yaml file, include the following line:

    bare_metal: true

Add the Google Cloud RPM repository to the OS repository list

You need to add the URL for the Google Cloud RPM repository for the agent to the list of package repositories for the operating system. How you add a repository is different depending on whether you are using a Red Hat or a SLES operating system.

RHEL

To add the Google Cloud RPM repository to RHEL, follow these steps:

  1. Establish an SSH connection with your host VM.

  2. Run the following command after replacing RHEL_VERSION with your operating system version number. For example, replace RHEL_VERSION with 7 for RHEL 7 or 8 for RHEL 8. You might need to scroll to see RHEL_VERSION.

    sudo tee /etc/yum.repos.d/google-sapnetweavermonitoring-agent.repo << EOM
[google-sapnetweavermonitoring-agent]
name=Google Cloud monitoring agent for SAP NetWeaver
baseurl=https://packages.cloud.google.com/yum/repos/google-sapnetweavermonitoring-agent-elRHEL_VERSION-\$basearch
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

SLES

To add the Google Cloud RPM repository to SLES, follow these steps:

  1. Establish an SSH connection with your host VM.

  2. Run the following command after replacing SLES_VERSION with your operating system version number. For example, replace SLES_VERSION with 12 for SLES 12 or 15 for SLES 15. You might need to scroll to see SLES_VERSION.

    zypper addrepo --gpgcheck-allow-unsigned-package --refresh \
https://packages.cloud.google.com/yum/repos/google-sapnetweavermonitoring-agent-slesSLES_VERSION-\$basearch google-sapnetweavermonitoring-agent

Install the agent

You install the monitoring agent for SAP NetWeaver by using the OS package manager.

To install the agent, select your operating system, and follow these steps:

RHEL

  1. Establish an SSH connection with your host VM.

  2. Run the following command: 

    sudo yum install google-sapnetweavermonitoring-agent

SLES

  1. Establish an SSH connection with your host VM.

  2. Run the following command: 

    sudo zypper install google-sapnetweavermonitoring-agent

Windows

Create the configuration file

You need to create a configuration.yaml file on the Bare Metal Solution server to enable the monitoring agent for SAP NetWeaver for that server.

To create the configuration file, follow these steps:

  1. Establish an RDP connection with your host VM.

  2. Create the configuration.yaml file in the following directory:

    C:\gcpsapdeps\configuration.yaml

  3. In the configuration.yaml file, include the following line:

    bare_metal: true

Install the agent

To install the agent, follow these steps:

  1. Establish an RDP connection with your host VM.

  2. Run the following command as an administrator on the host VM:

    . { Invoke-WebRequest -useb https://storage.googleapis.com/cloudsapdeploy/netweaver-agent-windows/install.ps1 } | iex

After you install the monitoring agent for SAP NetWeaver and the SAP Host Agent, validate the installation of the monitoring agent for SAP NetWeaver, as described in Validate your installation of the agent.

Validate your installation of the monitoring agent for SAP NetWeaver

To validate the installation of the agent and confirm that you configured the agent correctly for a Bare Metal Solution server, select your operating system, and follow the steps:

Linux

  1. Use SSH to connect to the VM instance that you want to monitor.

  2. At the command prompt, enter the following command: 

    curl http://localhost:18181

Windows

  1. Use RDP to connect to the VM instance that you want to monitor.

  2. In a web browser, visit the following URL: 

    http://localhost:18181

If the monitoring agent for SAP NetWeaver is configured correctly for a Bare Metal Solution server, then the Instance Type value is bms-nn and the Hardware Model metric value is Google Cloud Bare Metal, as shown in the following example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <metrics>
   <metric category="config" context="vm" type="string" unit="none"
   last-refresh="1614391024" refresh-interval="0"><name>Data
   Provider Version</name><value>1.1.1.0</value>
   </metric><metric category="config" context="host" type="string"
   unit="none" last-refresh="1614391024" refresh-interval="0">
   <name>Cloud Provider</name><value>Google Cloud
   Platform</value></metric><metric category="config"
   context="vm" type="string" unit="none" last-refresh="1614391024"
   refresh-interval="0"><name>Instance Type</name>
   <value>bms-16.0</value></metric><metric
   category="config" context="host" type="string" unit="none"
   last-refresh="1614391024" refresh-interval="0"><name>Virtualization
   Solution</name><value>N/A</value></metric><metric
   category="config" context="host" type="string" unit="none"
   last-refresh="1614391024" refresh-interval="0"><name>Hardware Manufacturer</name><value>Google</value></metric>
   <metric category="config" context="host" type="string" unit="none"
   last-refresh="1614391024" refresh-interval="0"><name>Hardware
   Model</name><value>Google Cloud Bare Metal</value>
   </metric>
   ...
   </metrics>

If the monitoring agent isn't running, then see the Operations Guide section about restarting the agent.

Verify that SAP Host Agent is receiving metrics

To verify that the infrastructure metrics are collected by Google Cloud's Agent for SAP and sent correctly to the SAP Host Agent, follow these steps:

  1. In your SAP system, enter transaction ST06.

  2. In the overview pane, check the availability and content of the following fields for the correct end-to-end setup of the SAP and Google monitoring infrastructure:

    • Cloud Provider: Google Cloud Platform
    • Enhanced Monitoring Access: TRUE
    • Enhanced Monitoring Details: ACTIVE