Agent für SAP-Arbeitslasten einrichten

Workload Manager für SAP-Lösungen verwendet den Agent für SAP vonGoogle Cloud, 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 in Google Cloudzu 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 Agenten

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

Aus Sicherheitsgründen empfehlen wir, ein Dienstkonto für einen bestimmten Zweck anstelle des Compute Engine-Standarddienstkontos zu verwenden.

Damit das Dienstkonto die erforderlichen Berechtigungen hat, um dem Agent für SAP die Authentifizierung beiGoogle Cloud und den Zugriff auf Google Cloud -Ressourcen zu ermöglichen, bitten Sie Ihren Administrator, dem Dienstkonto die folgenden IAM-Rollen für Ihr Projekt zuzuweisen:

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 zur Steuerung des Zugriffs auf Google Cloud-Ressourcen nur die IAM-Berechtigungen des Instanzdienstkontos. 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 API-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 SAP auf die Google APIs und -Dienste zugreifen kann. Informationen zum Aktivieren des privater Google-Zugriff finden Sie unter Privaten Google-Zugriff konfigurieren.

Agent mithilfe des Paketmanagers 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 über einen Paketmanager eine Verbindung zu Ihrer SAP-Arbeitslast herstellt.

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

Agent installieren

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

So installieren Sie den Agenten 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.16 (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 Agenten von Google Cloudfü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 des Agenten für SAP vonGoogle Cloud, der auf einemeiner Compute Engine-Instanzausgeführt wird, wobei die Erfassung von Workload Manager-Bewertungsmesswerten aktiviert ist.

    Für die SAP HANA-Authentifizierung verwendet der Agent die folgende Reihenfolge: Falls 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, in der Konfigurationsdatei nur eine Authentifizierungsoption 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 User Store (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, sendet er die Workload Manager-Bewertungsmesswerte an Workload Manager.

Agenten auf einer Reihe von VMs mit dem VM Extension Manager installieren und verwalten

In diesem Abschnitt erfahren Sie, wie Sie den Agent für SAP mithilfe des VM Extension Managers auf einer Flotte von VMs installieren und verwalten.

Mit der VM Extension Manager-Richtlinie können Sie unter anderem folgende Aufgaben ausführen:

  • Installation im gesamten Pool: Installieren Sie den Agent für SAP auf Folgendem:
    • 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: Benutzerdefinierte Konfiguration auf den Agent auf allen VMs anwenden, die von einer Richtlinie verwaltet werden.

VM Extension Manager einrichten

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

Agent auf einer Reihe von VMs installieren und konfigurieren

Informationen zum Installieren der aktuellen Version des Agenten für 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 Agenten 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:

Console

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

    Zu „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 lösen. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000.

  6. Wählen Sie im Abschnitt Umfang die Option Globaler Roll-out aus.

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

    1. Wählen Sie in der Liste Erweiterung die Option Google Cloud-Erweiterung für SAP aus.

    2. Lassen Sie die Auswahl im Feld Version unverändert.

      Dadurch wird die Richtlinie angewiesen, die aktuelle Version des Agents für SAP vonGoogle Cloudauf Ihrer VM-Flotte zu 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.

    5. Wählen Sie im Feld Roll-out die gewünschte Roll-out-Planoption aus: Langsamer Roll-out (empfohlen) oder Schneller Roll-out.

  8. Optional: Wenn Sie das Roll-out der Richtlinie auf die erforderlichen VMs beschränken möchten, gehen Sie unter Ziel-VM-Instanzen so vor:

    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

Führen Sie im Cloud Shell-Terminal den Befehl gcloud compute global-vm-extension-policies create aus:

gcloud 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 VM-Erweiterungsrichtlinie.
  • PROJECT_ID: die Projekt-ID desGoogle Cloud -Projekts, für das Sie die Richtlinie erstellen

  • ROLLOUT_PLAN_OPTION: die Roll-out-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 Roll-out-Plan verwenden, indem Sie die Option --rollout-custom-plan angeben. Weitere Informationen finden Sie unter Roll-out-Pläne.
    • Sie können entweder --rollout-predefined-plan oder --rollout-custom-plan verwenden, aber nicht beide 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 für SAP enthält.

    • Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen 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 beide 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 abzielt.

    • Damit eine VM von Ihrer Richtlinie erfasst wird, muss sie alle angegebenen Labels haben.
    • Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches OR). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs im Projekt.

  • PRIORITY: Eine Ganzzahl von 0 bis 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 einer Reihe von VMs in einer bestimmten Zone installieren und konfigurieren

So installieren Sie die aktuelle Version des Agenten für 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 „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 lösen. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000.

  6. Wählen Sie im Abschnitt Bereich die Option Zonales Roll-out und dann die Region und die Zone aus, auf die Sie diese Richtlinie anwenden möchten.

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

    1. Wählen Sie in der Liste Erweiterung die Option Google Cloud-Erweiterung für SAP aus.

    2. Lassen Sie das Feld Version leer.

      Dadurch wird die Richtlinie angewiesen, die aktuelle 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: Wenn Sie das Roll-out der Richtlinie auf die erforderlichen VMs beschränken möchten, gehen Sie unter Ziel-VM-Instanzen so vor:

    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

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

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, auf die Sie diese Richtlinie anwenden möchten.

  • CONFIG_FILE_PATH: der lokale Pfad zur JSON-Datei, die die Konfiguration für den Agent für SAP zum Herstellen einer Verbindung mit Ihrer SAP-Arbeitslast enthält.

    • Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen 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 beide 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 abzielt.

    • Damit eine VM von Ihrer Richtlinie erfasst wird, muss sie alle angegebenen Labels haben.
    • Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches OR). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone.

  • PRIORITY: Eine Ganzzahl von 0 bis 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. Dadurch wird die aktuelle Version des Agenten für Computing-Arbeitslasten auf allen VMs installiert, die in der Zone us-centrail-f bereitgestellt sind. Die in der 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 einer Reihe von 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, führt VM Extension Manager die Änderungen auf allen anwendbaren VMs aus, in der Regel innerhalb einer Minute. Wenn Sie Einschlusslabels ändern, wird der Agent für SAP möglicherweise auf neuen VMs installiert oder von vorhandenen VMs deinstalliert, je nachdem, ob die VMs mit den aktualisierten Labels übereinstimmen.

In den folgenden Abschnitten wird beschrieben, wie Sie den Agent für SAP für Folgendes verwalten:

Agent-Konfiguration auf einer Reihe von VMs ändern

Wenn Sie die Konfiguration von Agent für SAP-Instanzen ändern möchten, die Sie mithilfe einer VM Extension Manager-Richtlinie auf Ihrer VM-Flotte 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

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

    Zu „VM-Erweiterungsrichtlinien“

  2. Wenn Sie eine zonale Richtlinie aktualisieren möchten, rufen Sie den Tab Zonale Richtlinien auf.

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

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

  5. Führen Sie im Abschnitt Erweiterungen verwalten folgende Schritte aus:

    1. Wählen Sie Google Cloud-Erweiterung für SAP aus.
    2. Geben Sie im Feld Inhalt der Konfigurationsdatei die Konfiguration ein, die Sie auf den Agenten 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

Führen Sie den Befehl gcloud compute zone-vm-extension-policies update aus, um die Konfiguration des Agenten für SAP auf VMs in einer bestimmten Zone zu ändern. Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Richtlinie vollständig ersetzt. 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 für SAP enthält.

    • Sie können die Agent-Konfiguration auch als Inline-String angeben, 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 beide 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 abzielt.

    • Damit eine VM von Ihrer Richtlinie erfasst wird, muss sie alle angegebenen Labels haben.
    • Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches OR). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für 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

Führen Sie den Befehl gcloud compute global-vm-extension-policies update aus, um die Konfiguration des Agenten für SAP auf VMs in IhremGoogle Cloud -Projekt zu ändern. Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Richtlinie durch die Anfrage vollständig ersetzt. 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 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 Projekts in Google Cloud , in dem sich die Richtlinie befindet.

  • ROLLOUT_PLAN_OPTION: die Roll-out-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 Roll-out-Plan verwenden, indem Sie die Option --rollout-custom-plan angeben. Weitere Informationen finden Sie unter Roll-out-Pläne.
    • Sie können entweder --rollout-predefined-plan oder --rollout-custom-plan verwenden, aber nicht beide im selben Befehl.

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

    • Sie können die Agent-Konfiguration auch als Inline-String angeben, 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 beide 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 abzielt.

    • Damit eine VM von Ihrer Richtlinie erfasst wird, muss sie alle angegebenen Labels haben.
    • Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die mit einem der angegebenen Selektoren übereinstimmen (logisches OR). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für 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 den Roll-out der globalen Richtlinie neu starten.

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

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

    gcloud 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: ein Universally Unique Identifier (UUID), der die Wiederholungsanfrage identifiziert. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Weitere Informationen finden Sie unter Roll-out wiederholen.

    • ROLLOUT_PLAN_OPTION: die Roll-out-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 Roll-out-Plan verwenden, indem Sie die Option --rollout-custom-plan angeben. Weitere Informationen finden Sie unter Roll-out-Pläne.
      • Sie können entweder --rollout-predefined-plan oder --rollout-custom-plan verwenden, aber nicht beide im selben Befehl.

Globale Richtlinie aktualisieren, um Zonen auszuschließen

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

  • Führen Sie im Terminal oder in Cloud Shell den Befehl gcloud compute global-vm-extension-policies update aus und geben Sie einen benutzerdefinierten Roll-out-Plan an, der die Zonen festlegt, in denen die Richtlinie angewendet werden soll:

    gcloud 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 Roll-out-Plans, der die Zonen identifiziert, in denen die Richtlinie angewendet werden soll. Informationen zum Erstellen benutzerdefinierter Roll-out-Pläne finden Sie unter Informationen zu Roll-out-Plänen.
    • UUID: ein Universally Unique Identifier (UUID), der die Wiederholungsanfrage identifiziert. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Weitere Informationen finden Sie unter Roll-out wiederholen.

Agent von einer VM-Flotte deinstallieren

Wenn Sie den Agent für SAP von Ihrer VM-Flotte deinstallieren möchten, müssen Sie die VM Extension Manager-Richtlinie löschen, die die VM-Flotte verwaltet.

Wenn Sie eine Richtlinie löschen und eine andere aktive Richtlinie mit niedrigerer Priorität für eine VM gilt und den Agent für SAP deklariert, bleibt der Agent auf dieser VM gemäß der Richtlinie mit niedrigerer Priorität 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 Agenten für SAP. Wenn eine solche VM wieder verfügbar ist, entfernt VM Extension Manager den Agent für 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 „VM-Erweiterungsrichtlinien“

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

  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 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 Projekts in Google Cloud , in dem sich die Richtlinie befindet.
  • ZONE: die Google Cloud -Zone, in der sich die Richtlinie befindet.

Global

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies delete, um eine globale VM Extension Manager-Richtlinie zu löschen:

gcloud 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 Projekts in Google Cloud , in dem sich die Richtlinie befindet.

  • ROLLOUT_PLAN_OPTION: die Roll-out-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 Roll-out-Plan verwenden, indem Sie die Option --rollout-custom-plan angeben. Weitere Informationen finden Sie unter Roll-out-Pläne.
    • Sie können entweder --rollout-predefined-plan oder --rollout-custom-plan verwenden, aber nicht beide im selben Befehl.

Agent-Version überprüfen

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

Um sicherzustellen, dass Sie die aktuelle Version des Agents für SAP von Google Cloudverwenden, 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.16 (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.16 (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 für die 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-Bewertungsmesswerte haben, indem Sie den Befehl status des Agents ausführen. Dieser Befehl wird ab Version 3.7 des Agents unterstützt.

So validieren Sie die Einrichtung von Google Cloud :

  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 kann andere Werte als die default-Werte enthalten.

        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 die Ausgabe darauf hindeutet, dass ein Teil der Einrichtung fehlt, lesen Sie die Informationen in den vorherigen Abschnitten, führen Sie die erforderlichen Aktionen aus und führen Sie dann den Befehl status noch einmal aus, um die Einrichtung noch einmal zu validieren.

Beispiel: Konfigurationsdatei

Die folgenden Beispiele sind vollständige Konfigurationsdateien des Agenten für SAP vonGoogle Cloud, der auf einemeiner Compute Engine-Instanzausgeführt wird, wobei die Erfassung von Workload Manager-Bewertungsmesswerten aktiviert ist.

Für die SAP HANA-Authentifizierung verwendet der Agent die folgende Reihenfolge: Falls 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, in der Konfigurationsdatei nur eine Authentifizierungsoption 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 User Store (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 für SAP unterstützt werden, finden Sie unter Konfigurationsparameter.

Nächste Schritte