Agent für SAP-Arbeitslasten einrichten

Workload Manager für SAP-Lösungen verwendet den Google Cloud-Agent für SAP, um Metadaten zur Bewertung Ihrer SAP-Systemkonfigurationen zu erkennen und zu erfassen. Der Agent für SAP und der SAP-Host-Agent sind auf allen VM-Instanzen erforderlich, auf denen SAP-Systeme ausgeführt werden, um Ihre SAP-Systeme, die auf Google Cloudausgeführt werden, zu unterstützen und zu überwachen, einschließlich SAP NetWeaver, SAP HANA, SAP ASE und SAP MaxDB.

Hinweis

Prüfen Sie vor der Installation und Konfiguration des Google Cloud-Agents für SAP, ob die folgenden Voraussetzungen erfüllt sind:

Erforderliche IAM-Rollen für den Agent

Der Agent für SAP verwendet das Dienstkonto, das der Compute-Instanz zugeordnet ist, zur Authentifizierung und für den Zugriff auf Google Cloud -Ressourcen.

Zur Verbesserung der Sicherheit empfehlen wir, ein Dienstkonto für einen bestimmten Zweck anstelle des Compute Engine-Standarddienstkontos zu verwenden.

Damit das Dienstkonto die erforderlichen Berechtigungen hat, damit sich Agent for SAP beiGoogle Cloud authentifizieren und auf Google Cloud Ressourcen zugreifen kann, bitten Sie Ihren Administrator, dem Dienstkonto die folgenden IAM-Rollen für Ihr Projekt zuzuweisen:

  • Messwerte von der Compute-Instanz erfassen: Compute-Betrachter (roles/compute.viewer)
  • Daten in das Workload Manager-Data Warehouse schreiben: Workload Manager Insights Writer (roles/workloadmanager.insightWriter)
  • Agent-Protokolle an Cloud Logging senden: Log-Autor (roles/logging.logWriter)
  • Wenn Sie Secret Manager zum Speichern des Passworts für die Verbindung mit der SAP-Arbeitslast verwenden: Secret Manager Secret Accessor (roles/secretmanager.secretAccessor)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Ihr Administrator kann dem Dienstkonto möglicherweise auch die erforderlichen Berechtigungen über benutzerdefinierte Rollen oder andere vordefinierte Rollen erteilen.

Zugriff auf Cloud APIs aktivieren

Compute Engine empfiehlt, Ihre Instanzen so zu konfigurieren, dass sie allen Cloud APIs alle Zugriffsbereiche gewähren. Verwenden Sie nur die IAM-Berechtigungen des Dienstkontos der Instanz, um den Zugriff auf Google Cloud-Ressourcen zu steuern. Weitere Informationen finden Sie unter VM mit vom Nutzer verwalteten Dienstkonto erstellen.

Wenn Sie den Zugriff auf die Cloud APIs beschränken, benötigt der Agent für SAP mindestens die folgenden Cloud APIs-Zugriffsbereiche auf der Host-Compute-Instanz:

https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Best Practices für Bereiche.

Wenn Sie SAP-Anwendungen auf einer Compute-Instanz ausführen, die keine externe IP-Adresse hat, müssen Sie den privaten Google-Zugriff im Subnetz der Instanz aktivieren, damit der Agent für Compute-Arbeitslasten auf die Google APIs und Dienste zugreifen kann. Informationen zum Aktivieren des privater Google-Zugriff finden Sie unter Privaten Google-Zugriff konfigurieren.

Agent mit dem Paketmanager installieren und konfigurieren

In diesem Abschnitt erfahren Sie, wie Sie den Agent für SAP auf Ihrer Compute-Instanz installieren und so konfigurieren, dass er mithilfe eines Paketmanagers eine Verbindung zu Ihrer SAP-Arbeitslast herstellt.

Wenn Sie den Agent auf einer Reihe von VMs installieren und konfigurieren möchten, können Sie stattdessen eine VM Extension Manager-Richtlinie verwenden. Weitere Informationen finden Sie unter Agent mithilfe von VM Extension Manager auf einer VM-Flotte installieren und verwalten.

Agent installieren

Falls noch nicht geschehen, installieren Sie den Google Cloud-Agent für SAP auf allen Compute-Instanzen, auf denen Ihr SAP-Arbeitslast ausgeführt wird:

So installieren Sie den Agent auf einer Compute Engine-Instanz:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Compute-Instanz her.
  2. Installieren Sie den Agent im Terminal mit dem Befehl, der für Ihr Betriebssystem spezifisch ist:
    • Empfohlen: So installieren Sie Version 3.15 (aktuell) des Agents:

      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 install google-cloud-sap-agent

      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

      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
    • Um eine bestimmte Version des Agents zu installieren:

      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 install 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.

      Informationen zum Downgrade des Agents auf eine bestimmte Version finden Sie unter Downgrade des Google Cloud-Agents für SAP ausführen.

Erfassung von Workload Manager-Bewertungsmesswerten konfigurieren

Nachdem Sie den Agent für SAP installiert haben, müssen Sie ihn für die Erfassung der Workload Manager-Bewertungsmesswerte konfigurieren.

Führen Sie die folgenden Schritte aus, um den Google Cloud-Agent für SAP zu konfigurieren:

  1. So kann der Agent die Workload Manager-Bewertungsmesswerte erfassen:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable

  2. Optional: Wenn Sie die Erfassung der Messwerte „SAP HANA Insights“ und „Best Practices für die Sicherheit von SAP HANA“ in Workload Manager aktivieren möchten, fügen Sie den Abschnitt workload_validation_db_metrics_config nach collect_workload_validation_metrics in der Konfigurationsdatei des Agents hinzu und geben Sie dann die folgenden Parameter an:

    • hana_db_user: Geben Sie das Nutzerkonto an, das zum Abfragen der SAP HANA-Instanz verwendet wird.
    • hostname: Geben Sie die Kennzeichnung der Maschine an, entweder lokal oder remote, die Ihre SAP HANA-Instanz hostet.
    • port: Geben Sie den Port an, über den die SAP HANA-Instanz Abfragen akzeptiert.

    • hana_db_password_secret_name: Gibt den Namen des Secrets im Secret Manager an, in dem das Passwort des Nutzerkontos gespeichert ist.

      Als Alternative zum Secret können Sie den Konfigurationsparameter hdbuserstore_key verwenden.

    • hdbuserstore_key: Gibt den Schlüssel hdbuserstore an, mit dem der Nutzer authentifiziert wird, den Sie für hana_db_user angegeben haben.

      Wenn Sie hdbuserstore_key angeben, überspringen Sie die Angabe der Parameter hostname und port.

    Weitere Informationen zu diesen Parametern finden Sie unter Konfigurationsparameter.

    Die folgenden Beispiele sind vollständige Konfigurationsdateien desGoogle Cloud-Agents für SAP, die auf einemeiner Compute Engine-Instanzausgeführt werden, wobei die Erfassung von Workload Manager-Bewertungsmesswerten aktiviert ist.

    Für die SAP HANA-Authentifizierung verwendet der Agent die folgende Reihenfolge der Priorität: Wenn angegeben, wird der Konfigurationsparameter hdbuserstore_key dem Parameter hana_db_password vorgezogen, der wiederum dem Parameter hana_db_password_secret_name vorgezogen wird. Wir empfehlen, nur eine Authentifizierungsoption in der Konfigurationsdatei festzulegen.

    • Im folgenden Beispiel wird ein Secure User Store (hdbuserstore)-Schlüssel für die SAP HANA-Authentifizierung verwendet: 
      {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
    • Im folgenden Beispiel werden ein Nutzername und ein Secret Manager-Secret für die SAP HANA-Authentifizierung verwendet: 
      {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
    • Im folgenden Beispiel werden ein Nutzername und ein Passwort für die SAP HANA-Authentifizierung verwendet. Wir empfehlen stattdessen, ein Secret Manager-Secret oder einen Secure Nutzerspeicher (hdbuserstore)-Schlüssel für die SAP HANA-Authentifizierung zu verwenden. 
      {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password": "TempPa55word",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

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

    sudo systemctl restart google-cloud-sap-agent

    Nachdem der Agent erfolgreich neu gestartet wurde, beginnt er mit dem Senden der Bewertungsmesswerte für den Workload Manager an den Workload Manager.

Agent mithilfe von VM Extension Manager auf einer Reihe von VMs installieren und verwalten

In diesem Abschnitt erfahren Sie, wie Sie den Agent for SAP auf einer Flotte von VMs mithilfe von VM Extension Manager installieren und verwalten.

Mit der VM Extension Manager-Richtlinie können Sie Aufgaben wie die folgenden ausführen:

  • Flottenweite Installation: Installieren Sie den Agent für SAP auf den folgenden Systemen:
    • Alle VMs in Ihrem Google Cloud Projekt oder eine Teilmenge von VMs, die durch Labels identifiziert werden.
    • Alle VMs in einer Zone oder eine Teilmenge von VMs, die durch Labels identifiziert werden.
  • Konfigurationsverwaltung: Wenden Sie eine benutzerdefinierte Konfiguration auf den Agent auf allen VMs an, die von einer Richtlinie verwaltet werden.

VM Extension Manager einrichten

Führen Sie die folgenden Schritte aus, um VM Extension Manager einzurichten:

Agent auf einer Flotte von VMs installieren und konfigurieren

Informationen zum Installieren der neuesten Version von Agent for SAP auf Ihrer VM-Flotte mithilfe einer VM Extension Manager-Richtlinie finden Sie im entsprechenden Abschnitt:

Agent auf VMs in Ihrem Google Cloud -Projekt installieren und konfigurieren

So installieren Sie den Agent auf allen VMs in Ihrem Google Cloud Projekt oder auf einer Teilmenge von VMs, die durch Labels identifiziert werden, mithilfe einer VM Extension Manager-Richtlinie:

  • Führen Sie in Ihrem Terminal oder in Cloud Shell den Befehl gcloud beta compute global-vm-extension-policies create aus:

    gcloud beta compute global-vm-extension-policies create POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-sap-extension  \
    --rollout-predefined-plan=ROLLOUT_PLAN_OPTION \
    [--description="<var>DESCRIPTION</var>" \]
    [--inclusion-labels=KEY1=VALUE1,KEY2=VALUE2 \]
    [--config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \]
    [--priority=PRIORITY]

    Ersetzen Sie Folgendes:

    • POLICY_NAME: Ein eindeutiger Name für die Richtlinie für VM-Erweiterungen.
    • PROJECT_ID: die Projekt-ID desGoogle Cloud -Projekts, für das Sie die Richtlinie erstellen

    • ROLLOUT_PLAN_OPTION: Die Rollout-Option, die Sie auf Ihre globale Richtlinie anwenden möchten. Die unterstützten Werte sind slow_rollout (empfohlen) und fast_rollout.

    • Alternativ können Sie einen benutzerdefinierten Rollout-Plan angeben, indem Sie die Option --rollout-custom-plan verwenden. Weitere Informationen finden Sie unter Rollout-Pläne.

    • Sie können entweder --rollout-predefined-plan oder --rollout-custom-plan verwenden, aber nicht beides im selben Befehl.

    • DESCRIPTION: eine optionale Beschreibung der Richtlinie.

    • CONFIG_FILE_PATH: der lokale Pfad zur JSON-Datei, die die Konfiguration für den Agent for SAP enthält.

    • Alternativ können Sie die Konfiguration als Inline-String angeben. Verwenden Sie dazu das Flag --config anstelle von --config-from-file. Beispiel: --config=google-cloud-sap-extension="CONFIG".

    • Sie können entweder --config-from-file oder --config verwenden, aber nicht beides im selben Befehl.

    • Informationen zu den vom Agent unterstützten Konfigurationsparametern finden Sie unter Konfigurationsparameter.

    • KEY_1=VALUE_1: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die die Labels definieren, mit denen die Richtlinie auf VMs ausgerichtet wird.

    • Damit eine VM von Ihrer Richtlinie erfasst wird, muss sie alle angegebenen Labels haben.

    • Wenn Sie --inclusion-labels mehrmals angeben, wird die Richtlinie auf VMs angewendet, die einem der angegebenen Selektoren entsprechen (logisches OR). Wenn Sie dieses Flag weglassen, wird die Richtlinie auf alle VMs im Projekt angewendet.

    • PRIORITY: Eine Ganzzahl zwischen 0 und 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Weitere Informationen finden Sie unter Richtlinienpriorität und Konfliktlösung.

Agent auf mehreren VMs in einer bestimmten Zone installieren und konfigurieren

So installieren Sie die neueste Version des Agent for SAP auf Ihrer VM-Flotte in einer bestimmten Zone mithilfe einer VM Extension Manager-Richtlinie:

Console

  1. Rufen Sie in der Google Cloud Console die Seite VM-Erweiterungsrichtlinien auf.

    Zu den VM-Erweiterungsrichtlinien

  2. Klicken Sie auf Erweiterungsrichtlinie erstellen.

  3. Geben Sie im Feld Name einen Namen für die Richtlinie ein.

  4. Optional: Geben Sie im Feld Beschreibung eine Beschreibung für die Richtlinie ein.

  5. Geben Sie im Feld Priorität eine Prioritätsnummer an, um Konflikte zwischen Richtlinien zu beheben. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000.

  6. Wählen Sie in den Listen Region und Zone die Zone aus, in der Sie diese Richtlinie anwenden möchten.

  7. Klicken Sie im Bereich Erweiterungen auf Erweiterung hinzufügen und gehen Sie dann so vor:

    1. Wählen Sie in der Liste Extension (Erweiterung) die Option Google Cloud's Extension for Compute Workloads (Google Cloud-Erweiterung für Compute-Arbeitslasten) aus.

    2. Lassen Sie das Feld Version leer.

      Dadurch wird die Richtlinie angewiesen, die neueste Version des Agenten für SAP vonGoogle Cloudzu installieren.

    3. Geben Sie im Feld Inhalt der Konfigurationsdatei die Konfiguration ein, die Sie auf den Agent anwenden möchten.

      Informationen zu den Konfigurationsparametern, die vom Agent für Ihre SAP-Arbeitslast unterstützt werden, finden Sie unter Konfigurationsparameter.

    4. Klicken Sie auf Fertig.

  8. Optional: So beschränken Sie die Einführung der Richtlinie auf die erforderlichen VMs:

    1. Klicken Sie auf Labels hinzufügen und fügen Sie die Labels hinzu, mit denen die erforderlichen VMs identifiziert werden.
    2. Klicken Sie auf Fertig.

  9. Klicken Sie auf Erstellen.

gcloud 

gcloud compute zone-vm-extension-policies create POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-sap-extension \
    --config-from-file=google-cloud-sap-extension=CONFIG_FILE_PATH \
    [--description="DESCRIPTION" \]
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY]

Ersetzen Sie Folgendes:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.

    Der Befehl schlägt fehl, wenn in der Zone bereits eine Richtlinie mit dem angegebenen Namen vorhanden ist.

  • ZONE: die Zone, in der Sie diese Richtlinie anwenden möchten.

  • CONFIG_FILE_PATH: Der lokale Pfad zur JSON-Datei, die die Konfiguration für den Agent for SAP enthält, um eine Verbindung zu Ihrer SAP-Arbeitslast herzustellen.

    • Alternativ können Sie die Konfiguration als Inline-String angeben. Verwenden Sie dazu das Flag --config anstelle von --config-from-file. Beispiel: --config=google-cloud-sap-extension="CONFIG". Google Cloud empfiehlt die Verwendung von --config-from-file.
    • Sie können entweder --config-from-file oder --config verwenden, aber nicht beides im selben Befehl.
    • Informationen zu den Konfigurationsparametern, die vom Agent für Ihre SAP-Arbeitslast unterstützt werden, finden Sie unter Konfigurationsparameter.

  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.

  • KEY_1=VALUE_1: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die die Labels definieren, mit denen die Richtlinie auf VMs ausgerichtet wird.

    • Damit eine VM von Ihrer Richtlinie erfasst wird, muss sie alle angegebenen Labels haben.
    • Wenn Sie --inclusion-labels mehrmals angeben, richtet sich die Richtlinie an VMs, die einen der angegebenen Selektoren erfüllen (logisches OR). Wenn Sie dieses Flag weglassen, richtet sich die Richtlinie an alle VMs in der angegebenen Zone.

  • PRIORITY: Eine Ganzzahl zwischen 0 und 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000.

Beispiel:

Mit dem folgenden Befehl wird eine Richtlinie mit dem Namen test-agent-policy im ProjektGoogle Cloud mit dem Namen test-project erstellt, mit der die neueste Version des Agents für Compute-Arbeitslasten auf allen VMs installiert wird, die in der Zone us-centrail-f bereitgestellt werden. Die in agent-config.json angegebene Konfiguration wird auf den Agent angewendet.

gcloud compute zone-vm-extension-policies create test-agent-policy  \
    --project=test-project \
    --zone=us-central1-f \
    --extensions=google-cloud-sap-extension \
    --config-from-file=google-cloud-sap-extension="/usr/agent-config.json"

Agent auf mehreren VMs verwalten

Wenn Sie ändern möchten, wie eine VM Extension Manager-Richtlinie den Agent for SAP verwaltet, aktualisieren Sie die Richtlinie. Wenn Sie eine Richtlinie aktualisieren, werden die Änderungen vom VM Extension Manager in der Regel innerhalb einer Minute auf alle anwendbaren VMs übertragen. Wenn Sie Einschlusslabels ändern, wird der Agent for SAP möglicherweise auf neuen VMs installiert oder von vorhandenen VMs deinstalliert, je nachdem, ob die VMs den aktualisierten Labels entsprechen.

In den folgenden Abschnitten wird beschrieben, wie Sie den Agent for SAP verwalten, um Folgendes zu tun:

Agentenkonfiguration auf einer Flotte von VMs ändern

Wenn Sie die Konfiguration von Agent for SAP-Instanzen ändern möchten, die Sie mithilfe einer VM Extension Manager-Richtlinie auf Ihren VMs installiert haben, müssen Sie diese Richtlinie bearbeiten.

Führen Sie die folgenden Schritte aus, um die Agent-Konfiguration für Ihre VM-Flotte zu ändern:

Console

So aktualisieren Sie eine zonale Richtlinie: Informationen zum Aktualisieren einer globalen Richtlinie finden Sie auf dem Tab gcloud.

  1. Rufen Sie in der Google Cloud Console die Seite VM-Erweiterungsrichtlinien auf.

    Zu den VM-Erweiterungsrichtlinien

  2. Klicken Sie auf die Richtlinie, die Sie ändern möchten.

  3. Klicken Sie auf der Seite Details zur Erweiterungsrichtlinie auf Bearbeiten.

  4. Klicken Sie im Bereich Erweiterungen verwalten auf Google Cloud-Erweiterung für SAP.

  5. Geben Sie im Feld Inhalt der Konfigurationsdatei die Konfiguration ein, die Sie auf den Agent anwenden möchten.

    Informationen zu den vom Agent unterstützten Konfigurationsparametern finden Sie unter Konfigurationsparameter.

  6. Klicken Sie auf Fertig.

  7. Klicken Sie auf Speichern.

gcloud

Zonal

Wenn Sie die Konfiguration von Agent for SAP auf VMs in einer bestimmten Zone ändern möchten, führen Sie den Befehl gcloud compute zone-vm-extension-policies update aus. Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Anfrage als vollständiger Ersatz behandelt. Alle optionalen Felder, die Sie weglassen, werden auf ihre Standardwerte zurückgesetzt, anstatt die vorhandenen Werte aus der geänderten Richtlinie beizubehalten.

So ändern Sie die Agent-Konfiguration:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --zone=ZONE \
  --extensions=google-cloud-sap-extension \
  --config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \
  [--inclusion-labels=KEY_1=VALUE_1 \]
  [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
  [--priority=PRIORITY_NUMBER \]
  [--description="DESCRIPTION"]

Ersetzen Sie Folgendes:

  • POLICY_NAME: Der Name der VM-Erweiterungsrichtlinie, die Sie ändern möchten.
  • ZONE: die Google Cloud Zone, in der die Richtlinie gilt.

  • CONFIG_FILE_PATH: der lokale Pfad zur JSON-Datei, die die Konfiguration für den Agent for SAP enthält.

    • Sie können die Agent-Konfiguration auch als Inline-String bereitstellen, indem Sie das Flag --config anstelle von --config-from-file verwenden. Beispiel: --config=google-cloud-sap-extension="CONFIG". Google Cloud empfiehlt die Verwendung von --config-from-file.
    • Sie können entweder --config-from-file oder --config verwenden, aber nicht beides im selben Befehl.
    • Informationen zu den vom Agent unterstützten Konfigurationsparametern finden Sie unter Konfigurationsparameter.

  • KEY_1=VALUE_1: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die die Labels definieren, mit denen die Richtlinie auf VMs ausgerichtet wird.

    • Damit eine VM von Ihrer Richtlinie erfasst wird, muss sie alle angegebenen Labels haben.
    • Wenn Sie --inclusion-labels mehrmals angeben, richtet sich die Richtlinie an VMs, die einen der angegebenen Selektoren erfüllen (logisches OR). Wenn Sie dieses Flag weglassen, richtet sich die Richtlinie an alle VMs in der angegebenen Zone.

  • PRIORITY_NUMBER: die Priorität, die Sie für Ihre Richtlinie festlegen möchten. Sie können eine Ganzzahl von 0 bis 65535 angeben.

  • DESCRIPTION: Eine Beschreibung der VM-Erweiterungsrichtlinie.

Global

Wenn Sie die Konfiguration von Agent for SAP auf VMs in IhremGoogle Cloud -Projekt ändern möchten, führen Sie den Befehl gcloud beta compute global-vm-extension-policies update aus. Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Anfrage als vollständiger Ersatz behandelt. Alle optionalen Felder, die Sie weglassen, werden auf ihre Standardwerte zurückgesetzt, anstatt vorhandene Werte aus der geänderten Richtlinie beizubehalten.

So ändern Sie die Agent-Konfiguration:

gcloud beta compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=google-cloud-sap-extension \
  --rollout-predefined-plan=ROLLOUT_PLAN_OPTION \
  --config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \
  [--inclusion-labels=KEY_1=VALUE_1 \]
  [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
  [--priority=PRIORITY_NUMBER \]
  [--description="DESCRIPTION"]

Ersetzen Sie Folgendes:

  • POLICY_NAME: Der Name der VM-Erweiterungsrichtlinie, die Sie ändern möchten.
  • PROJECT_ID: Die ID des Google Cloud Projekts, in dem sich die Richtlinie befindet.

  • ROLLOUT_PLAN_OPTION: Die Rollout-Option, die Sie auf Ihre globale Richtlinie anwenden möchten. Die unterstützten Werte sind slow_rollout (empfohlen) und fast_rollout.

    • Alternativ können Sie einen benutzerdefinierten Rollout-Plan angeben, indem Sie die Option --rollout-custom-plan verwenden. Weitere Informationen finden Sie unter Rollout-Pläne.
    • Sie können entweder --rollout-predefined-plan oder --rollout-custom-plan verwenden, aber nicht beides im selben Befehl.

  • CONFIG_FILE_PATH: der lokale Pfad zur JSON-Datei, die die Konfiguration für den Agent for SAP enthält.

    • Sie können die Agent-Konfiguration auch als Inline-String bereitstellen, indem Sie das Flag --config anstelle von --config-from-file verwenden. Beispiel: --config=google-cloud-sap-extension="CONFIG". Google Cloud empfiehlt die Verwendung von --config-from-file.
    • Sie können entweder --config-from-file oder --config verwenden, aber nicht beides im selben Befehl.
    • Informationen zu den vom Agent unterstützten Konfigurationsparametern finden Sie unter Konfigurationsparameter.

  • KEY_1=VALUE_1: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die die Labels definieren, mit denen die Richtlinie auf VMs ausgerichtet wird.

    • Damit eine VM von Ihrer Richtlinie erfasst wird, muss sie alle angegebenen Labels haben.
    • Wenn Sie --inclusion-labels mehrmals angeben, richtet sich die Richtlinie an VMs, die einen der angegebenen Selektoren erfüllen (logisches OR). Wenn Sie dieses Flag weglassen, richtet sich die Richtlinie an alle VMs im Projekt.

  • PRIORITY_NUMBER: die Priorität, die Sie für Ihre Richtlinie festlegen möchten. Sie können eine Ganzzahl von 0 bis 65535 angeben.

  • DESCRIPTION: Eine Beschreibung der VM-Erweiterungsrichtlinie.

Globale Richtlinie aktualisieren, um neue Zonen einzuschließen

Wenn Sie VMs in einer neuen Zone erstellen, nachdem Sie eine globale Richtlinie erstellt und eingeführt haben, wendet VM Extension Manager die Richtlinie nicht automatisch auf die VMs in den neuen Zonen an. Wenn Sie die VMs in neue Zonen aufnehmen möchten, müssen Sie die globale Richtlinienbereitstellung neu starten.

So starten Sie die Einführung einer globalen Richtlinie neu:

  • Führen Sie in Ihrem Terminal oder in Cloud Shell den Befehl gcloud beta compute global-vm-extension-policies update aus und geben Sie die Option --rollout-entry-uuid so an:

    gcloud beta compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-sap-extension  \
    --rollout-predefined-plan=ROLLOUT_PLAN_OPTION \
    --config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \
    --rollout-retry-uuid=UUID

    Ersetzen Sie Folgendes:

    • UUID: Eine UUID (Universally Unique Identifier), die die Wiederholungsanfrage identifiziert. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Weitere Informationen finden Sie unter Rollout wiederholen.

    • ROLLOUT_PLAN_OPTION: Die Rollout-Option, die Sie auf Ihre globale Richtlinie anwenden möchten. Die unterstützten Werte sind slow_rollout (empfohlen) und fast_rollout.

    • Alternativ können Sie einen benutzerdefinierten Rollout-Plan angeben, indem Sie die Option --rollout-custom-plan verwenden. Weitere Informationen finden Sie unter Rollout-Pläne.

    • Sie können entweder --rollout-predefined-plan oder --rollout-custom-plan verwenden, aber nicht beides im selben Befehl.

Globale Richtlinie aktualisieren, um Zonen auszuschließen

So aktualisieren Sie eine globale Richtlinie, um Zonen auszuschließen:

  • Führen Sie in Ihrem Terminal oder in Cloud Shell den Befehl gcloud beta compute global-vm-extension-policies update aus und geben Sie einen benutzerdefinierten Rollout-Plan an, in dem die Zonen angegeben sind, in denen die Richtlinie angewendet werden soll:

    gcloud beta compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-sap-extension  \
    --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
    --rollout-retry-uuid=UUID

    Ersetzen Sie Folgendes:

    • NEW_CUSTOM_PLAN_NAME: Der Name des neuen benutzerdefinierten Rollout-Plans, der die Zonen angibt, in denen die Richtlinie angewendet werden soll. Informationen zum Erstellen benutzerdefinierter Rollout-Pläne finden Sie unter Rollout-Pläne.
    • UUID: Eine UUID (Universally Unique Identifier), die die Wiederholungsanfrage identifiziert. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Weitere Informationen finden Sie unter Rollout wiederholen.

Agent von einer VM-Flotte deinstallieren

Wenn Sie den Agent for SAP von Ihren VMs deinstallieren möchten, müssen Sie die VM Extension Manager-Richtlinie löschen, mit der die VMs verwaltet werden.

Wenn beim Löschen einer Richtlinie eine andere aktive Richtlinie mit niedrigerer Priorität für eine VM gilt und den Agent for SAP deklariert, bleibt der Agent basierend auf der Richtlinie mit niedrigerer Priorität auf dieser VM installiert.

VM Extension Manager entfernt den Agent innerhalb einer Minute nach dem Löschen der Richtlinie von allen zugänglichen VMs. Wenn eine VM nicht zugänglich ist, weil der Gast-Agent entfernt oder die VM gelöscht wurde, überspringt VM Extension Manager das Löschen des Agent for SAP. Wenn eine solche VM wieder verfügbar ist, entfernt VM Extension Manager den Agent for SAP zu diesem Zeitpunkt.

So deinstallieren Sie den Agent für SAP von Ihrer VM-Flotte:

Console

  1. Rufen Sie in der Google Cloud Console die Seite VM-Erweiterungsrichtlinien auf.

    Zu den VM-Erweiterungsrichtlinien

  2. Klicken Sie auf die Richtlinie, mit der der Agent für SAP auf Ihrer VM-Flotte verwaltet wird.

  3. Klicken Sie auf der Seite Details zur Erweiterungsrichtlinie auf Löschen und bestätigen Sie den Löschvorgang.

gcloud

Zonal

Verwenden Sie zum Löschen einer zonalen VM Extension Manager-Richtlinie den Befehl gcloud beta compute zone-vm-extension-policies delete:

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ersetzen Sie Folgendes:

  • POLICY_NAME: Der Name der zonalen Richtlinie, die Sie löschen möchten.
  • PROJECT_ID: Die ID des Google Cloud Projekts, in dem sich die Richtlinie befindet.
  • ZONE: Die Google Cloud Zone, in der sich die Richtlinie befindet.

Global

Verwenden Sie zum Löschen einer globalen VM Extension Manager-Richtlinie den Befehl gcloud beta compute global-vm-extension-policies delete:

gcloud beta compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN_OPTION

Ersetzen Sie Folgendes:

  • POLICY_NAME: Der Name der zonalen Richtlinie, die Sie löschen möchten.
  • PROJECT_ID: Die ID des Google Cloud Projekts, in dem sich die Richtlinie befindet.

  • ROLLOUT_PLAN_OPTION: Die Rollout-Option, die Sie auf Ihre globale Richtlinie anwenden möchten. Die unterstützten Werte sind slow_rollout (empfohlen) und fast_rollout.

    • Alternativ können Sie einen benutzerdefinierten Rollout-Plan angeben, indem Sie die Option --rollout-custom-plan verwenden. Weitere Informationen finden Sie unter Rollout-Pläne.
    • Sie können entweder --rollout-predefined-plan oder --rollout-custom-plan verwenden, aber nicht beides im selben Befehl.

Agent-Version überprüfen

Google Cloud empfiehlt, dass Sie die neueste Version von Agent für SAP installieren, um Ihre SAP-Arbeitslasten genau zu bewerten, da durch regelmäßige Releases des Agents für SAP Messwerte hinzugefügt oder geändert werden können, die für die Bewertung verwendet werden.

Um sicherzustellen, dass Sie die neueste Version des Agents von Google Cloudfü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

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.15 (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.15 (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.

Einrichtung der Erfassung von Workload Manager-Bewertungsmesswerten validieren

Sie können prüfen, ob Sie die richtige Google Cloud -Einrichtung für die Erfassung der Workload Manager-Evaluierungsmesswerte haben, indem Sie den status-Befehl des Agents ausführen. Dieser Befehl wird ab Version 3.7 des Agents unterstützt.

Führen Sie die folgenden Schritte aus, um die Einrichtung von Google Cloud zu validieren:

  1. Stellen Sie eine SSH-Verbindung zu Ihrer Compute Engine-Instanz her.
  2. Führen Sie dazu diesen Befehl aus: 
    sudo /usr/bin/google_cloud_sap_agent status -f="workload_manager,sap_discovery"

    Wenn Ihre Google Cloud -Einrichtung für die Erfassung von Workload Manager-Bewertungsmesswerten korrekt ist, enthält die Ausgabe Folgendes. Ihre Konfiguration enthält möglicherweise andere Werte als default.

        Agent Status:
        ...
        Systemd Service Enabled: True
        Systemd Service Running: True
        Cloud API Full Scopes: True
        Configuration File: /etc/google-cloud-sap-agent/configuration.json
        Configuration Valid: True
    ...
    ----------------------------------------------------------------------------
    System Discovery: Enabled
        Status: Fully Functional
        IAM Permissions: All granted
        Configuration:
            enable_discovery:                  true  (default)
            enable_workload_discovery:         true  (default)
            sap_instances_update_frequency:    60    (default)
            system_discovery_update_frequency: 14400 (default)
    ----------------------------------------------------------------------------
    Workload Manager Evaluation: Enabled
        Status: Fully Functional
        IAM Permissions: All granted
        Configuration:
            collect_workload_validation_metrics:      true       (default)
            config_target_environment:                PRODUCTION (default)
            fetch_latest_config:                      true       (default)
            workload_validation_db_metrics_frequency: 3600       (default)
            workload_validation_metrics_frequency:    300        (default)
    ...
  3. Wenn in der Ausgabe darauf hingewiesen wird, dass eine Einrichtung fehlt, sehen Sie sich die Informationen in den vorherigen Abschnitten an, führen Sie die erforderlichen Aktionen aus und führen Sie den Befehl status noch einmal aus, um die Einrichtung neu zu validieren.

Beispiel: Konfigurationsdatei

Die folgenden Beispiele sind vollständige Konfigurationsdateien desGoogle Cloud-Agents für SAP, die auf einemeiner Compute Engine-Instanzausgeführt werden, wobei die Erfassung von Workload Manager-Bewertungsmesswerten aktiviert ist.

Für die SAP HANA-Authentifizierung verwendet der Agent die folgende Reihenfolge der Priorität: Wenn angegeben, wird der Konfigurationsparameter hdbuserstore_key dem Parameter hana_db_password vorgezogen, der wiederum dem Parameter hana_db_password_secret_name vorgezogen wird. Wir empfehlen, nur eine Authentifizierungsoption in der Konfigurationsdatei festzulegen.

  • Im folgenden Beispiel wird ein Secure User Store (hdbuserstore)-Schlüssel für die SAP HANA-Authentifizierung verwendet: 
    {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • Im folgenden Beispiel werden ein Nutzername und ein Secret Manager-Secret für die SAP HANA-Authentifizierung verwendet: 
    {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • Im folgenden Beispiel werden ein Nutzername und ein Passwort für die SAP HANA-Authentifizierung verwendet. Wir empfehlen stattdessen, ein Secret Manager-Secret oder einen Secure Nutzerspeicher (hdbuserstore)-Schlüssel für die SAP HANA-Authentifizierung zu verwenden. 
    {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password": "TempPa55word",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Informationen zu den Konfigurationsparametern, die vom Agent for SAP unterstützt werden, finden Sie unter Konfigurationsparameter.

Nächste Schritte