Betriebsleitfaden von Google Cloud für SAP

In diesem Leitfaden werden operative Überlegungen und Verfahren zum Ausführen der Version 3.5 (aktuell) des Google Cloud-Agents für SAP auf Compute Engine-VM-Instanzen und Bare-Metal-Solution-Servern behandelt.

Informationen zum Lebenszyklus eines Agents

Beim Verwalten der Vorgänge des Google Cloud-Agents für SAP ist es hilfreich, wenn Sie wissen, was der Agent tut. Im Allgemeinen funktioniert er so:

  • Sie müssen den Agent von Google Cloud für SAP auf jeder Compute Engine-VM-Instanz oder jedem Bare-Metal-Lösungsserver installieren, der SAP-Systeme hostet. Der Agent wird als Linux- oder Windows-Dienst ausgeführt.
  • Auf Compute Engine-VM-Instanzen kombiniert der Agent Monitoringdaten aus Monitoring und den Compute Engine APIs.
  • Auf Bare-Metal-Lösungsservern greift der Agent für die Erfassung nur von SAP-Host-Agent-Messwerten nicht auf die Google Cloud APIs zu.
  • Der SAP-Host-Agent fragt den Google Cloud-Agent für SAP über HTTP nach seinen im Cache gespeicherten Daten ab. Er fasst die Messwerte des SAP-Host-Agents zusammen, meldet sie und speichert sie in der SAP NetWeaver-Datenbank.
  • In der SAP-Transaktion ST06 oder der saposcol-Befehlszeile werden die aggregierten SAP-Host-Agent-Messwerte angezeigt.
  • Sie können die SAP Host Agent-Messwerte aus dem Google Cloud-Agent für SAP aufrufen. Führen Sie dazu einen Befehl in einem Terminalfenster aus.

Prüfen Sie, ob der Agent ausgeführt wird.

Nachdem Sie den Agent installiert oder neu gestartet haben, können Sie überprüfen, ob der Agent wie erwartet ausgeführt wird.

So prüfen Sie, ob der Agent ausgeführt wird:

Linux

  1. Stellen Sie eine SSH-Verbindung zu Ihrem Bare-Metal-Solution-Server oder Ihrer VM-Instanz her.

  2. Führen Sie dazu diesen Befehl aus: 

    systemctl status google-cloud-sap-agent

    Wenn der Agent ordnungsgemäß funktioniert, enthält die Ausgabe active (running). Beispiel: 

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Windows

  1. Stellen Sie eine RDP-Verbindung zur VM-Instanz her.

  2. Als Administrator führen Sie den folgenden Befehl in PowerShell aus: 

    $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
     Wenn der Agent ausgeführt wird, wird der Status Running angezeigt.

Wenn der Google Cloud-Agent für SAP nicht ausgeführt wird, starten Sie den Agent neu.

Version des Agents prüfen

Nachdem Sie den Google Cloud-Agent für SAP installiert oder neu gestartet haben, können Sie die Version des Agents prüfen.

Führen Sie folgende Schritte aus, um die Version Ihres Agents zu prüfen:

Linux

Für RHEL führen Sie die folgenden Schritte aus:

  1. Stellen Sie eine SSH-Verbindung zum Hostcomputer her.
  2. Führen Sie dazu diesen Befehl aus: 
    yum info google-cloud-sap-agent

Für SLES führen Sie die folgenden Schritte aus:

  1. Stellen Sie eine SSH-Verbindung zum Hostcomputer her.
  2. Führen Sie dazu diesen Befehl aus: 
    zypper info google-cloud-sap-agent

Windows

  1. Stellen Sie eine RDP-Verbindung zum Hostcomputer her.
  2. Als Administrator führen Sie den folgenden Befehl in PowerShell aus: 
    googet installed google-cloud-sap-agent

Listen Sie die verfügbaren Versionen des Agents auf:

So listen Sie alle verfügbaren Versionen des Google Cloud-Agents für SAP auf:

RHEL

  1. Stellen Sie eine SSH-Verbindung zu Ihrem Host her.

  2. Führen Sie dazu diesen Befehl aus:

    sudo yum list --showduplicates google-cloud-sap-agent

SLES

  1. Stellen Sie eine SSH-Verbindung zu Ihrem Host her.

  2. Führen Sie dazu diesen Befehl aus:

    sudo zypper search -s -t package -r google-cloud-sap-agent google-cloud-sap-agent

Prüfen, ob der SAP-Host-Agent Messwerte empfängt

Führen Sie die folgenden Schritte aus, um zu prüfen, ob die Infrastrukturmesswerte vom Agent von Google Cloud für SAP erfasst und korrekt an den SAP-Host-Agent gesendet werden:

  1. Geben Sie in Ihrem SAP-System Transaktion ST06 ein.

  2. Kontrollieren Sie im Übersichtsbereich die Verfügbarkeit und den Inhalt der folgenden Felder, um die korrekte End-to-End-Einrichtung der SAP- und Google-Monitoring-Infrastruktur zu überprüfen:

    • Cloud-Anbieter: Google Cloud Platform
    • Zugriff für erweitertes Monitoring: TRUE
    • Details für erweitertes Monitoring: ACTIVE

Messwerte für den SAP-Host-Agent aufrufen

Nachdem Sie die Konfiguration des Google Cloud-Agent für SAP installiert oder aktualisiert haben, können Sie die überwachten Messwerte des SAP-Host-Agents aufrufen.

So rufen Sie die Messwerte des SAP-Host-Agents auf, die vom Google Cloud-Agent für SAP erfasst wurden:

Linux

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz des Bare-Metal-Lösung-Servers her.

  2. Führen Sie dazu diesen Befehl aus: 

    curl http://localhost:18181

    Wenn die Messwerte verfügbar sind, sollten Sie eine XML-Ausgabe mit Informationen über Ihr System erhalten. Beispiel:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>0.0</value>
  </metric>

Windows

  1. Stellen Sie eine RDP-Verbindung zur VM-Instanz her.

  2. Als Administrator führen Sie den folgenden Befehl in PowerShell aus: 

    (Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

    Wenn die Messwerte verfügbar sind, sollte eine XML-Ausgabe mit Informationen zu Ihrem System angezeigt werden. Beispiel:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>10.0</value>
  </metric>

Weitere Messwerte ansehen

Nachdem Sie die Konfiguration des Google Cloud-Agents für SAP aktualisiert haben, um die Prozessmonitoring-Messwerte oder die SAP HANA-Monitoringmesswerte zu erfassen, sollten Sie diese aufrufen, um zu überprüfen, ob der Agent die Messwerte wie erwartet erfasst.

Mit den folgenden Schritten können Sie die Messwerte und Informationen aufrufen, die vom Google Cloud-Agent für SAP in Cloud Monitoring erfasst wurden:

  1. Rufen Sie in der Google Cloud Console die Monitoring-Seite Metrics Explorer auf.

    Zu Metrics Explorer

  2. Wählen Sie den Tab Konfiguration aus.

  3. Maximieren Sie das Menü Messwert auswählen.

  4. Wählen Sie im Menü Ressourcen die Option VM-Instanz aus.

  5. Wählen Sie im Menü Messwertkategorie die Option SAP aus.

  6. Wählen Sie im Menü Messwert einen metric: workload.googleapis.com/sap/service/active oder einen der neuen Messwerte aus, die als Diagramm angezeigt werden sollen.

  7. Klicken Sie auf Anwenden.

Sie sollten nun ein Diagramm mit den Zeitachsenmesswerten sehen.

Backint-Funktion validieren

Nachdem Sie das Backint-Feature des Agents aktiviert haben, müssen Sie es validieren, indem Sie eine Sicherung erstellen und wiederherstellen.

Eine Anleitung finden Sie unter Sicherung und Wiederherstellung validieren.

Agent neu starten

Wenn der Google Cloud-Agent für SAP nicht mehr funktioniert oder Sie seine Konfiguration aktualisieren, starten Sie den Agent neu.

Wählen Sie Ihr Betriebssystem aus und folgen Sie dann den Schritten:

Linux

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Führen Sie dazu diesen Befehl aus: 

    sudo systemctl restart google-cloud-sap-agent

Windows

  1. Stellen Sie eine RDP-Verbindung zu Ihrer Host-VM her.

  2. Als Administrator führen Sie den folgenden Befehl in PowerShell aus: 

    Restart-Service -Name 'google-cloud-sap-agent' -Force

Agent deaktivieren oder aktivieren

Damit eine ordnungsgemäße Überwachung möglich ist, muss der Dienst systemd des Google Cloud-Agents für SAP auf Ihrer Compute-Instanz jederzeit ausgeführt werden. Wenn Sie den Agent jedoch auf Ihrer Linux-basierten Compute-Instanz deaktivieren oder beenden möchten, führen Sie den folgenden Befehl aus:

sudo /usr/bin/google_cloud_sap_agent service -disable

So aktivieren und starten Sie den systemd-Dienst des Agents auf Ihrer Linux-basierten Compute-Instanz:

sudo /usr/bin/google_cloud_sap_agent service -enable

Wenn Sie den systemd-Dienst des Agents unter Linux deaktivieren oder aktivieren, wird die Aktion in der folgenden Datei protokolliert: /var/log/google-cloud-sap-agent/service.log.

Von anderen Google Cloud-Agents auf Google Cloud-Agent für SAP aktualisieren

Der Agent von Google Cloud für SAP ist der Nachfolger anderer Google Cloud-Agents. Die folgenden Abschnitte enthalten Informationen zum Upgrade von diesen Agents auf Version 3.5 (aktuell) des Google Cloud-Agents für SAP.

Eine Anleitung zum Installieren und Konfigurieren des Google Cloud-Agents für SAP finden Sie in der Installations- und Konfigurationsanleitung für den Google Cloud-Agent für SAP.

Upgrade vom Cloud Storage-Backint-Agent für SAP HANA

Führen Sie die folgenden Schritte aus, um ein Upgrade vom Cloud Storage-Backint-Agent für SAP HANA auf Version 3.5 (aktuell) durchzuführen:

  1. Achten Sie darauf, dass für den Zeitraum, der sich mit dem Upgrade überschneidet, keine Datensicherungen ausgeführt werden oder geplant sind.

  2. Deaktivieren Sie automatische Logsicherungen. Setzen Sie dazu den Parameter enable_auto_log_backup von SAP HANA auf no. Eine Anleitung hierzu finden Sie im SAP HANA-Dokument Automatische Logsicherung aktivieren und deaktivieren.

  3. Google Cloud-Agent für SAP installieren. Eine Anleitung finden Sie in der Installationsanleitung für Ihr Szenario.

  4. Aktivieren Sie das Backint-Feature des Google Cloud-Agents für SAP. Eine Anleitung finden Sie unter Backint-basierte Sicherung und Wiederherstellung konfigurieren.

    Wenn Sie das Backint-Feature des Google Cloud-Agents für SAP aktivieren, wird der Backint-Agent auf Ihrem Host automatisch erkannt und auf Ihrem Hostcomputer deaktiviert.

  5. Führen Sie den folgenden Befehl für jede Ihrer Textdateien aus, um eine JSON-Version Ihrer vorhandenen Backint-Konfigurationstextdatei zu erstellen:

    /usr/bin/google_cloud_sap_agent configurebackint -f=PATH_TO_PARAMETERS_FILE

    Ersetzen Sie PATH_TO_PARAMETERS_FILE durch den Pfad zur Datei PARAMETERS.txt.

    Die JSON-Dateien werden am selben Speicherort in Ihrem Dateisystem wie die Textdateien erstellt, solange der Agent von Google Cloud für SAP die Berechtigung für den Zugriff auf diese Speicherorte hat. Obwohl der Google Cloud-Agent für SAP die in der Textdatei angegebenen Backint-Parameter interpretieren kann, empfehlen wir die Verwendung der JSON-Dateien zum Aktualisieren jeder Konfiguration.

  6. Aktivieren Sie automatische Logsicherungen. Setzen Sie dazu den Parameter enable_auto_log_backup von SAP HANA auf yes. Eine Anleitung hierzu finden Sie im SAP HANA-Dokument Automatische Logsicherung aktivieren und deaktivieren.

  7. Prüfen Sie Sicherung und Wiederherstellung.

Wenn Sie dieses Upgrade durchführen, geschieht Folgendes:

  • Zu Sicherungs- und Referenzzwecken werden alle Installationsdateien im Verzeichnis backint-gcs des Backint-Agents in backint-gcs-old-TIMESTAMP/ kopiert. Diese sind erforderlich, falls Sie den Backint-Agent wieder verwenden müssen.
  • Der Ordner backint-gcs wird dann bereinigt, sodass er nur die Dateien enthält, die zum Ausführen des Agents von Google Cloud für SAP erforderlich sind, einschließlich der Konfigurationsdatei parameters.json und der Backint-Konfigurationsdateien wie PARAMETERS.txt.

Erweitern Sie für Informationen zur Zuordnung der Konfigurationsparameter zwischen dem Backint-Agent und dem Google Cloud-Agent für SAP den folgenden Abschnitt.

Zuordnung von Konfigurationsparametern

Parametername im Backint-Agent Parametername im Google Cloud-Agent für SAP
BUCKET bucket
DISABLE_COMPRESSION compress
ENCRYPTION_KEY encryption_key
KMS_KEY_NAME kms_key
MAX_GCS_RETRY retries
PARALLEL_FACTOR parallel_streams
PARALLEL_PART_SIZE Dies ist im Google Cloud-Agent für SAP nicht verfügbar.
RATE_LIMIT_MB rate_limit_mb
SERVICE_ACCOUNT service_account_key
THREADS thread
READ_IDLE_TIMEOUT file_read_timeout_ms
CHUNK_SIZE_MB buffer_size_mb
HTTP_READ_TIMEOUT Dies ist im Google Cloud-Agent für SAP nicht verfügbar.

Upgrade vom Monitoring-Agent für SAP HANA

Wenn Sie Version 3.5 (aktuell) des Google Cloud-Agents für SAP installieren, werden Versionen des Monitoring-Agents für SAP HANA automatisch erkannt, deaktiviert und dann während der Installation von Ihren Hostcomputern entfernt.

Wenn dieser Agent erkannt wird, wird seine Konfiguration während der Installation zum Google Cloud-Agent für SAP migriert. Zu Sicherungs- und Referenzzwecken wird die Konfiguration des Monitoring-Agents für SAP HANA in die folgende Datei kopiert:

/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

SSL-fähige Instanzen aktualisieren

Wenn Sie den Monitoring-Agent für SAP HANA so konfiguriert haben, dass er SSL-Zertifikate für die Kommunikation mit Ihren SAP HANA-Instanzen verwendet, müssen Sie bei der Installation des Google Cloud-Agents für SAP die gesamte SAP HANA-Monitoring-Konfiguration mit Ausnahme des SSL-Zertifikats ausführen. Die Konfiguration wird zum Google Cloud-Agent für SAP migriert. In einem solchen Fall müssen Sie die folgenden Schritte ausführen, um den Google Cloud-Agent für SAP zum Monitoring Ihrer SAP HANA-Instanzen zu verwenden:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Öffnen Sie die Konfigurationsdatei des Google Cloud-Agents für SAP:

    /etc/google-cloud-sap-agent/configuration.json

  3. Legen Sie im Abschnitt hana_monitoring_configuration den Parameter enabled auf true fest.

  4. Führen Sie im Abschnitt hana_monitoring_configuration.hana_instances für jede SAP HANA-Instanz, die das TLS-/SSL-Protokoll für eine sichere Kommunikation verwendet, die folgenden Schritte aus:

    1. Geben Sie den Parameter enable_ssl an und legen Sie als Wert true fest.

    2. Geben Sie den Parameter host_name_in_certificate an und legen Sie den SAP HANA-Hostnamen, wie im TLS-/SSL-Zertifikat angegeben, als Wert fest.

    3. Geben Sie den Parameter tls_root_ca_file an und legen Sie den Pfad, unter dem das TLS/SSL-Zertifikat gespeichert ist, als Wert fest.

  5. Speichern Sie die Konfigurationsdatei.

  6. Starten Sie den Agent neu, damit die neuen Einstellungen wirksam werden:

    sudo systemctl restart google-cloud-sap-agent

  7. Prüfen Sie, ob der Agent die SAP HANA-Monitoringmesswerte erfasst. Eine Anleitung finden Sie unter Andere Messwerte ansehen.

  8. Monitoring-Agent für SAP HANA deinstallieren

Wenn nach diesem Upgrade Verbindungsprobleme mit Ihren SAP HANA-Instanzen auftreten, können Sie die Logs des Agents in Logging aufrufen und die Anleitung zur Behebung des Problems verwenden.

Upgrade vom Monitoring-Agent für SAP NetWeaver

Wenn Sie Version 3.5 (aktuell) des Google Cloud-Agents für SAP installieren, werden Versionen des Monitoring-Agents für SAP NetWeaver automatisch erkannt.

Wenn dieser Agent erkannt wird, wird seine Konfiguration während der Installation zum Google Cloud-Agent für SAP migriert.

Google Cloud-Agent für SAP aktualisieren

Um sicherzustellen, dass Sie die neueste Version des Agents von Google Cloud für SAP verwenden, müssen Sie regelmäßig nach Updates suchen und den Agent aktualisieren.

Auf Aktualisierungen überprüfen

Wählen Sie Ihr Betriebssystem aus und folgen Sie dann den Schritten:

RHEL

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Instanz her.
  2. Führen Sie dazu diesen Befehl aus: 
    sudo yum check-update google-cloud-sap-agent

SLES

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Instanz her.
  2. Führen Sie dazu diesen Befehl aus: 
    sudo zypper list-updates -r google-cloud-sap-agent

Windows

  1. Stellen Sie eine RDP-Verbindung zu Ihrer Host-VM her.
  2. Als Administrator führen Sie den folgenden Befehl in PowerShell aus: 
    googet latest google-cloud-sap-agent

Update installieren

Wählen Sie Ihr Betriebssystem aus und folgen Sie dann den Schritten:

RHEL

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Instanz her.
  2. Aktualisieren Sie die Agent-Instanz:
    • (Empfohlen) So aktualisieren Sie den Agent auf Version 3.5 (aktuell): 
      sudo yum --nogpgcheck update google-cloud-sap-agent
    • So aktualisieren Sie auf eine bestimmte Version des Agents: 
      sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Ersetzen Sie VERSION_NUMBER durch die Versionsnummer des Agents, die Sie installieren möchten, z. B. 3.1-606637668. Informationen zu den Agent-Versionen, die Sie installieren können, finden Sie unter Alle verfügbaren Versionen des Agents auflisten.

SLES

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Instanz her.
  2. Aktualisieren Sie die Agent-Instanz:
    • (Empfohlen) So aktualisieren Sie den Agent auf Version 3.5 (aktuell): 
      sudo zypper --no-gpg-checks update google-cloud-sap-agent
    • So aktualisieren Sie auf eine bestimmte Version des Agents: 
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Ersetzen Sie VERSION_NUMBER durch die Versionsnummer des Agents, die Sie installieren möchten, z. B. 3.1-606637668. Informationen zu den Agent-Versionen, die Sie installieren können, finden Sie unter Alle verfügbaren Versionen des Agents auflisten.

Windows

  1. Stellen Sie eine RDP-Verbindung zu Ihrer Host-VM her.
  2. Führen Sie als Administrator den folgenden Befehl in PowerShell aus, um auf Version 3.5 (aktuell) des Agents zu aktualisieren:
    googet install google-cloud-sap-agent

Google Cloud-Agent für SAP auf eine niedrigere Version downgraden

Wir empfehlen zwar, immer die neueste Version des Agents von Google Cloud für SAP zu verwenden. Sie können jedoch mit dem folgenden Befehl ein Downgrade von der neuesten Version auf eine andere unterstützte Version des Agents ausführen:

RHEL

sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum downgrade google-cloud-sap-agent-VERSION_NUMBER.x86_64

SLES15

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

SLES 12

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

Ersetzen Sie VERSION_NUMBER durch die Versionsnummer des Agents, die Sie installieren möchten, z. B. 3.1-606637668. Informationen zu den Agent-Versionen, die Sie installieren können, finden Sie unter Alle verfügbaren Versionen des Agents auflisten.

Rollback zur Verwendung der anderen Google Cloud-Agents

Dieser Abschnitt enthält Informationen zum Rollback von Version 3.5 (aktuell) des Google Cloud-Agents für SAP und der Verwendung seiner Vorgänger-Agents.

Rollback zur Verwendung des Backint-Agents

Wenn Sie ein Rollback zur Verwendung des Backint-Agents durchführen und die Backint-Funktion des Agents von Google Cloud für SAP nicht mehr verwenden möchten, führen Sie die folgenden Schritte aus:

  1. Löschen Sie alle Dateien, die sich auf das Backint-Feature des Google Cloud-Agent für SAP beziehen:

    rm -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs

    Ersetzen Sie SID durch die SID Ihres SAP-Systems.

  2. Stellen Sie die Dateien des Backint-Agents wieder her, die als Sicherung bei dem Upgrade auf den Google Cloud-Agent für SAP gespeichert wurden. Kopieren Sie dazu diese in das Verzeichnis backint-gcs:

    cp -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs-old-TIMESTAMP /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs

    Ersetzen Sie Folgendes:

    • SID: die SID Ihres SAP-Systems
    • TIMESTAMP: der Zeitstempelwert im Namen des Ordners, der beim Upgrade vom Backint-Agent auf den Google Cloud-Agent für SAP erstellt wurde

  3. Verwenden Sie SAP HANA Studio oder SAP HANA Cockpit, um die Datei global.ini zu bearbeiten und die Pfade zu Ihren .txt-Konfigurationsdateien zu aktualisieren. Informationen zu den Parametern, für die Sie den Pfad zu den Dateien .txt angeben müssen, finden Sie unter SAP HANA für das Backint-Feature konfigurieren.

  4. Speichern Sie die Änderungen, die an der Datei global.ini vorgenommen wurden.

Rollback zur Verwendung des Monitoring-Agents für SAP HANA

Wenn Sie ein Rollback auf die Verwendung des Monitoring-Agents für SAP HANA ausführen und die SAP HANA-Monitoring-Funktion des Agents von Google Cloud für SAP nicht mehr verwenden möchten, führen Sie die folgenden Schritte aus:

RHEL

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Um die Erfassung doppelter Messwerte zu verhindern, deaktivieren Sie die Erfassung von SAP HANA-Monitoring-Messwerten durch den Agent von Google Cloud für SAP:

    1. Öffnen Sie die Konfigurationsdatei des Google Cloud-Agents für SAP:

      /etc/google-cloud-sap-agent/configuration.json

    2. Legen Sie im Abschnitt hana_monitoring_configuration den Parameter enabled auf false fest.

    3. Speichern Sie die Konfigurationsdatei.

    4. Starten Sie den Agent neu, damit die neuen Einstellungen wirksam werden:

      sudo systemctl restart google-cloud-sap-agent

  3. Kopieren Sie die Konfiguration des Monitoring-Agents für SAP HANA aus der folgenden Datei:

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. Monitoring-Agent für SAP HANA Version 2 installieren Eine Installationsanleitung finden Sie in der Installations- und Betriebsanleitung für den Monitoring-Agent für SAP HANA V2.0.

  5. Fügen Sie in der folgenden Datei die Konfiguration des Monitoring-Agents für SAP HANA ein, die Sie in einem vorherigen Schritt kopiert haben:

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. Starten Sie den Monitoring-Agent für SAP HANA neu:

    sudo systemctl start google-saphanamonitoring-agent

SLES

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Um die Erfassung doppelter Messwerte zu verhindern, deaktivieren Sie die Erfassung von SAP HANA-Monitoring-Messwerten durch den Agent von Google Cloud für SAP:

    1. Öffnen Sie die Konfigurationsdatei des Google Cloud-Agents für SAP:

      /etc/google-cloud-sap-agent/configuration.json

    2. Legen Sie im Abschnitt hana_monitoring_configuration den Parameter enabled auf false fest.

    3. Speichern Sie die Konfigurationsdatei.

    4. Starten Sie den Agent neu, damit die neuen Einstellungen wirksam werden:

      sudo systemctl restart google-cloud-sap-agent

  3. Kopieren Sie die Konfiguration des Monitoring-Agents für SAP HANA aus der folgenden Datei:

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. Monitoring-Agent für SAP HANA Version 2 installieren Eine Installationsanleitung finden Sie in der Installations- und Betriebsanleitung für den Monitoring-Agent für SAP HANA V2.0.

  5. Fügen Sie in der folgenden Datei die Konfiguration des Monitoring-Agents für SAP HANA ein, die Sie in einem vorherigen Schritt kopiert haben:

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. Starten Sie den Monitoring-Agent für SAP HANA neu:

    sudo systemctl start google-saphanamonitoring-agent

Agent deinstallieren

So deinstallieren oder entfernen Sie den Agent von Ihrem Host:

RHEL

  1. Stellen Sie eine SSH-Verbindung zu Ihrem Host her.

  2. Führen Sie dazu diesen Befehl aus:

    sudo yum remove google-cloud-sap-agent

SLES

  1. Stellen Sie eine SSH-Verbindung zu Ihrem Host her.

  2. Führen Sie dazu diesen Befehl aus:

    sudo zypper remove google-cloud-sap-agent

Windows

  1. Stellen Sie eine RDP-Verbindung zu Ihrer Host-VM her.

  2. Als Administrator führen Sie den folgenden Befehl in PowerShell aus: 

    Remove-Service -Name 'google-cloud-sap-agent'

Logs des Agents in Cloud Logging ansehen

Standardmäßig werden die Logs für den Agent von Google Cloud für SAP von Ihren VM-Instanzen und Bare-Metal-Lösungsservern zu Cloud Logging umgeleitet.

So rufen Sie die Logs des Agents in Logging auf:

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

    Zum Log-Explorer

  2. Rufen Sie den Bereich Abfrage auf.

  3. Wählen Sie im Drop-down-Menü Ressourcen die Option Global aus und klicken Sie dann auf Übernehmen.

  4. Geben Sie im Abfrageeditor google-cloud-sap-agent ein.

  5. Klicken Sie auf Abfrage ausführen.

Sie sollten die Logs sehen, die von den Agent-Instanzen generiert wurden, die auf allen VM-Instanzen oder Bare-Metal-Lösungsservern ausgeführt werden. Um die Logs von einer bestimmten Maschine zu filtern, verwenden Sie die in der Benutzeroberfläche verfügbaren Filter.

Sie können die Standardweiterleitung der Agent-Logs deaktivieren, die sich auf die Erfassung von Messwerten beziehen. Führen Sie dazu folgende Schritte aus:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Host-VM-Instanz oder Ihrem Bare-Metal-Lösung-Server her.

  2. Öffnen Sie die folgende Konfigurationsdatei:

    /etc/google-cloud-sap-agent/configuration.json

  3. Aktualisieren Sie für den Parameter log_to_cloud den Wert auf false.

  4. Speichern Sie die Konfigurationsdatei.

  5. Starten Sie den Agent neu, damit diese Änderung wirksam wird.

Um die Standardweiterleitung der Logs zu deaktivieren, die sich auf das Backint-Feature des Google Cloud-Agents für SAP beziehen, bearbeiten Sie Ihre Backint-Konfigurationsdatei und setzen Sie den Parameter log_to_cloud auf false.