Backint-basierte Sicherung und Wiederherstellung für SAP HANA konfigurieren

In diesem Leitfaden erfahren Sie, wie Sie den Google Cloud-Agent für SAP so konfigurieren, dass Backint-basierte Sicherungen und Wiederherstellungen für SAP HANA ausgeführt werden.

Konzeptionelle Informationen zu dieser Funktion, die bei der Planung Ihrer Implementierung helfen können, finden Sie unter Sicherung und Wiederherstellung für SAP HANA mit Backint.

Informationen zum Erstellen von Backint-basierten Sicherungen und zur Wiederherstellung von SAP HANA mithilfe dieser Sicherungen finden Sie unter SAP HANA mit Backint sichern und wiederherstellen.

Hinweise

  • Prüfen Sie Ihre Installation von Version 3.6 (aktuell) des Google Cloud-Agents für SAP. Eine Anleitung finden Sie in der Installationsanleitung für Ihr Szenario.
  • Wenn Sie den Agent auf einem Bare-Metal-Lösungsserver installiert haben, prüfen Sie, ob Sie die erforderlichen Voraussetzungen erfüllt und ein Dienstkonto eingerichtet haben. Eine Anleitung finden Sie unter Google Cloud-Agent für SAP unter Linux konfigurieren.
  • Wenn Ihre SAP HANA-Datenbank in einer lokalen Umgebung ausgeführt wird, müssen Sie ein Dienstkonto und den zugehörigen Schlüssel einrichten. Eine Anleitung dazu finden Sie unter Google Cloud-Agent für SAP unter Linux konfigurieren.
  • Wenn Sie diese Funktion für eine Instanz des Google Cloud-Agents für SAP aktivieren möchten, die auf einem anderen Host als einer Compute Engine-Instanz oder einem Bare-Metal-Lösungsserver ausgeführt wird, müssen Sie einen Vorfall mit SAP-Support in der Komponente BC-OP-LNX-GOOGLE erstellen, damit sowohl SAP als auch Google Cloud Ihre Konfiguration auswerten können.
  • SAP HANA installieren:

Cloud Storage-Bucket erstellen

Bevor Sie die Backint-Funktion des Google Cloud-Agents für SAP aktivieren, muss ein Cloud Storage-Bucket zum Speichern Ihrer Sicherungen vorhanden sein. Wenn Sie bereits einen Cloud Storage-Bucket haben, können Sie diesen Abschnitt überspringen.

Weitere Informationen zum Speichern von Sicherungen in Cloud Storage-Buckets finden Sie unter Sicherungen in Cloud Storage-Buckets speichern.

So erstellen Sie einen Cloud Storage-Bucket:

Google Cloud Console

  1. In the Google Cloud console, go to the Cloud Storage Buckets page.

    Go to Buckets page

  2. Click Create bucket.
  3. On the Create a bucket page, enter your bucket information. To go to the next step, click Continue.
    • For Name your bucket, enter a name that meets the bucket naming requirements.
    • For Choose where to store your data, do the following:
      • Select a Location type option.
      • Select a Location option.
    • For Choose a default storage class for your data, select a storage class.
    • For Choose how to control access to objects, select an Access control option.
    • For Advanced settings (optional), specify an encryption method, a retention policy, or bucket labels.
  4. Click Create.

Befehlszeile

    Create a Cloud Storage bucket and configure it as follows:
    • Ersetzen Sie STORAGE_CLASS durch die gewünschte Storage-Klasse.
    • Ersetzen Sie LOCATION durch den gewünschten Standort (ASIA, EU oder US)
    • Ersetzen Sie BUCKET_NAME durch einen Bucket-Namen, der die Anforderungen für Bucket-Namen erfüllt.
    • gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

IAM-Rollen festlegen

Damit der Google Cloud-Agent für SAP Sicherungs- und Wiederherstellungsvorgänge für SAP HANA ausführen kann, müssen Sie dafür sorgen, dass das von Ihrer Compute Engine-Instanz oder dem Bare-Metal-Lösung-Server verwendete Dienstkonto die IAM-Rolle Storage-Objekt-Administrator (storage.objectAdmin) enthält.

So fügen Sie Ihrem Dienstkonto diese Rolle hinzu:

  1. Öffnen Sie in der Google Cloud Console die Seite IAM.

    IAM aufrufen

  2. Wählen Sie Ihr Google Cloud-Projekt aus.

  3. Identifizieren Sie das Dienstkonto, dem Sie die Rolle hinzufügen möchten.

    • Wenn sich das Dienstkonto nicht schon in der Mitgliederliste befindet, sind ihm keine Rollen zugewiesen. Klicken Sie auf Hinzufügen und geben Sie die E-Mail-Adresse des Dienstkontos ein.
    • Wenn sich das Dienstkonto in der Liste der Hauptkonten befindet, sind ihm bereits Rollen zugewiesen. Klicken Sie für das Dienstkonto, das Sie bearbeiten möchten, auf die Schaltfläche Bearbeiten .
  4. Wählen Sie in der Liste der verfügbaren Rollen Storage Object Admin aus.

  5. Klicken Sie auf Hinzufügen oder Speichern, um dem Dienstkonto die Rollen zuzuweisen.

Für eine detaillierte Zugriffsebene können Sie Ihrer benutzerdefinierten Rolle für Ihr Dienstkonto auf Projektebene die folgenden IAM-Berechtigungen zuweisen:

  • storage.objects.list
  • storage.objects.create

Außerdem müssen Sie IAM-Richtlinien für Ihren Bucket festlegen, indem Sie dem Nutzer die folgenden IAM-Berechtigungen gewähren:

  • storage.objects.get
  • storage.objects.update
  • storage.objects.delete

Fügen Sie die folgenden Berechtigungen hinzu, wenn Sie mehrteilige Uploads ausführen möchten:

  • storage.multipartUploads.create
  • storage.multipartUploads.abort

Weitere Informationen zum Erstellen einer benutzerdefinierten Rolle finden Sie unter Benutzerdefinierte Rollen erstellen und verwalten. Weitere Informationen zum Gewähren einer benutzerdefinierten Rolle für den Zugriff auf Bucket-Ebene finden Sie unter Hauptkonto zu einer Richtlinie auf Bucket-Ebene hinzufügen.

Zugriff auf Cloud APIs und Metadatenserver aktivieren

Der Google Cloud-Agent für SAP benötigt während der Sicherungs- und Wiederherstellungsvorgänge Zugriff auf folgende Google Cloud-IP-Adressen und ‑Hosts:

  • Für den Zugriff auf Cloud Storage: storage.googleapis.com
  • Für den Compute Engine-Metadatenserver für Instanzen:
    • oauth2.googleapis.com, für die Authentifizierung
    • 169.254.169.254
    • metadata.google.internal

Wenn der Google Cloud-Agent für SAP und Ihr SAP HANA-System auf einer Compute Engine-Instanz ausgeführt werden, die keinen Zugriff auf das Internet hat, müssen Sie den privaten Google-Zugriff so konfigurieren, dass der Agent mit Cloud Storage interagieren und, falls Sie einen dedizierten Dienstkonto verwenden, sich bei Google Cloud authentifizieren kann. Eine ausführliche Anleitung finden Sie unter Privaten Google-Zugriff konfigurieren.

Backint-Funktion aktivieren

So aktivieren Sie die Backint-Funktion des Google Cloud-Agents für SAP:

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

    Wenn Ihr Host eine Compute Engine-Instanz ist, können Sie in der Google Cloud Console auf der Seite VM-Instanzen auf die Schaltfläche SSH für Ihre Instanz klicken oder Ihre bevorzugte SSH-Methode verwenden.

  2. Wechseln Sie zum SAP HANA-Systemadministrator.

    sudo su - SID_LCadm

    Ersetzen Sie SID_LC durch die SID. Verwenden Sie Kleinbuchstaben für alle Buchstaben.

    Mit diesem Befehl werden auch mehrere Umgebungsvariablen festgelegt, darunter $SAPSYSTEMNAME, die mit der SID Ihrer SAP HANA-Datenbank festgelegt wird.

  3. So aktivieren Sie die Backint-Funktion für den Google Cloud-Agent für SAP:

    /usr/bin/google_cloud_sap_agent installbackint

    Wenn Sie die Backint-Dateien auf einem Host mit einer anderen SID installieren möchten, können Sie das Flag sid verwenden:

    /usr/bin/google_cloud_sap_agent installbackint -sid=DIFFERENT_SID_LC

    Ersetzen Sie DIFFERENT_SID_LC durch die SID der erforderlichen SAP HANA-Instanz. Verwenden Sie Kleinbuchstaben für alle Buchstaben.

    Nachdem der Befehl erfolgreich ausgeführt wurde, werden alle Dateien, die sich auf das Backint-Feature des Google Cloud-Agents für SAP beziehen, im Verzeichnis /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/ installiert. Dazu gehören auch Dateien, die für die Integration des Agents in SAP HANA erforderlich sind. Außerdem wird der Cloud Storage Backint-Agent für SAP HANA auf Ihrem Host erkannt, deaktiviert und seine Dateien in ein wiederherstellbares Verzeichnis auf Ihrem Host kopiert. Weitere Informationen finden Sie unter Upgrade vom Backint-Agent.

  4. Konfigurieren Sie die Backint-Funktion:

    Befehl ausführen

    • Wenn Ihre SAP HANA-Datenbank auf einer Compute Engine-Instanz oder einem Bare-Metal-Lösungsserver ausgeführt wird, führen Sie den Befehl configurebackint aus, um die Backint-Funktion des Agents zu konfigurieren. Wir empfehlen diese Vorgehensweise anstelle der Bearbeitung der Backint-Konfigurationsdatei des Agents.

      /usr/bin/google_cloud_sap_agent configurebackint \
       -f="PATH_TO_PARAMETERS_FILE" \
       -bucket="BUCKET_NAME"
    • Wenn Ihre SAP HANA-Datenbank in einer lokalen Umgebung ausgeführt wird, konfigurieren Sie die Backint-Funktion des Agents mit dem folgenden Befehl:

      /usr/bin/google_cloud_sap_agent configurebackint \
       -f="PATH_TO_PARAMETERS_FILE" \
       -bucket="BUCKET_NAME" \
       -service_account_key="PATH_TO_KEY" \
       -log_to_cloud=false \
       -send_metrics_to_monitoring=false

      Ersetzen Sie Folgendes:

      • PATH_TO_PARAMETERS_FILE: Pfad zur PARAMETERS.json-Backint-Konfigurationsdatei
      • BUCKET_NAME: Der Name des Cloud Storage-Bucket, in dem Sie Ihre SAP HANA-Sicherungen speichern möchten.
      • PATH_TO_KEY: der vollständige Pfad zum JSON-codierten Google Cloud-Dienstkontoschlüssel, den Sie eingerichtet haben

    Optional können Sie beim Ausführen dieses Befehls weitere Parameter festlegen. Weitere Informationen zu diesen Parametern finden Sie unter Konfigurationsparameter.

    Konfigurationsdatei bearbeiten

    Alternativ zum Ausführen des configurebackint-Befehls des Agents können Sie die Backint-Konfigurationsdatei so bearbeiten:

    1. Öffnen Sie die Backint-Konfigurationsdatei:

      /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json

      Ersetzen Sie SID durch die SID des SAP-Systems, in dem Sie die Backint-Dateien installiert haben.

      Hier ein Beispiel für den Inhalt der Konfigurationsdatei:

      {
       "bucket": "",
       "log_to_cloud": true
      }
    2. Damit der Google Cloud-Agent für SAP Backint-basierte Sicherungs- und Wiederherstellungsvorgänge für Ihr SAP HANA-System ausführen kann, bearbeiten Sie die Konfigurationsdatei und geben Sie die folgenden Parameter an:

      • bucket: Geben Sie den Namen des Cloud Storage-Buckets an, in dem Sie Ihre SAP HANA-Sicherungen speichern möchten.
      • service_account_key: Wenn Sie ein Dienstkonto für den Google Cloud-Agent für SAP erstellt haben, geben Sie den absoluten Pfad zum Verzeichnis auf Ihrem Host an, in den Sie den entsprechenden JSON-codierten Dienstkontoschlüssel hochgeladen haben.

      Weitere Informationen finden Sie unter Überlegungen zum Dienstkonto.

    3. Wenn Ihre SAP HANA-Datenbank in einer lokalen Umgebung ausgeführt wird, müssen Sie außerdem Folgendes festlegen:

      • "log_to_cloud": false
      • "send_metrics_to_monitoring": false
    4. Optional können Sie auch andere Konfigurationsparameter ändern. Weitere Informationen zu diesen Parametern finden Sie unter Konfigurationsparameter.

    5. Speichern Sie die Konfigurationsdatei.

Backint-Konfigurationsdatei anpassen

Nachdem Sie die Backint-Funktion des Google Cloud-Agents für SAP aktiviert haben, können Sie optional die folgenden Anpassungen vornehmen:

  • Benennen Sie die Datei parameters.json um.

    Um diese Umbenennung zu verdeutlichen, wird diese Datei in der Dokumentation des Google Cloud-Agents für SAP als PARAMETERS.json bezeichnet.

  • Erstellen Sie eine separate Konfigurationsdatei für Folgendes: SAP HANA-Datenvolume, SAP HANA-Logvolume und SAP HANA-Sicherungskatalog.

    Achten Sie darauf, für jede Konfigurationsdatei einen eindeutigen Namen festzulegen.

  • Verschieben Sie diese Konfigurationsdateien in ein anderes Verzeichnis. Bei einer Bereitstellung mit horizontaler Skalierung können Sie beispielsweise die Backint-bezogenen Konfigurationsdateien aller Knoten in einem freigegebenen Verzeichnis speichern, auf das die Knoten zugreifen können. So lassen sich diese Dateien leichter verwalten.

Wenn Sie eine dieser Anpassungen vornehmen, müssen Sie den Dateinamen und den Pfad für die Parameter in der global.ini-Datei von SAP HANA korrekt angeben. Eine Anleitung finden Sie unter SAP HANA für das Backint-Feature konfigurieren.

SAP HANA für das Backint-Feature konfigurieren

Nachdem Sie die Backint-Funktion des Google Cloud-Agents für SAP aktiviert haben, müssen Sie Ihr SAP HANA-System für die Verwendung dieser Funktion konfigurieren:

  1. Verwenden Sie SAP HANA Studio oder SAP HANA Cockpit, um die Konfigurationsdatei global.ini zu bearbeiten.

  2. Geben Sie im Abschnitt backup der Datei global.ini Werte für die folgenden Parameter an:

    Parameter Wert
    data_backup_parameter_file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_DATA.json.
    parallel_data_backup_backint_channels Geben Sie für Datensicherungen mit Multistreaming die Anzahl der Kanäle unter Berücksichtigung des verwendeten Cloud Storage-Bucket, der erforderlichen Leistung und des Laufwerkdurchsatzes an.
    log_backup_using_backint Wenn Sie eine separate Konfigurationsdatei für das SAP HANA-Sicherungsprotokollvolumen verwenden, geben Sie den Wert true an.
    log_backup_parameter_file

    Wenn Sie eine separate Konfigurationsdatei für das SAP HANA-Sicherungsprotokoll-Volume verwenden, geben Sie den folgenden Wert an: /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_LOG.json.

    Ersetzen Sie PARAMETERS_LOG durch den Namen der Konfigurationsdatei, die Sie für die Sicherungen des SAP HANA-Logvolumes verwenden.

    catalog_backup_using_backint Wenn Sie eine separate Konfigurationsdatei für den SAP HANA-Sicherungskatalog verwenden, geben Sie den Wert true an.
    catalog_backup_parameter_file

    Wenn Sie eine separate Konfigurationsdatei für den SAP HANA-Sicherungskatalog verwenden, geben Sie den folgenden Wert an: /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_CATALOG.json.

    Ersetzen Sie PARAMETERS_CATALOG durch den Namen der Konfigurationsdatei, die Sie für die Sicherungen des SAP HANA-Sicherungskatalogs verwenden.

    Im Folgenden finden Sie ein Beispiel für eine global.ini-Datei, die für die Verwendung des Backint-Features des Google Cloud-Agents für SAP konfiguriert ist:

    [backup]
    log_backup_using_backint = true
    catalog_backup_using_backint = true
    parallel_data_backup_backint_channels = 16
    catalog_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.json
    data_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.json
    log_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.json
  3. Geben Sie im Abschnitt persistence der Datei global.ini Werte für die folgenden Parameter an:

    • basepath_logbackup: Geben Sie das Verzeichnis in Ihrem Dateisystem an, in dem SAP HANA Logsicherungen speichern kann, wenn keine Verbindung zu Ihrem Cloud Storage-Bucket hergestellt werden kann. Achten Sie darauf, dass dieses Verzeichnis genügend Speicherplatz für die Sicherungen hat.
    • basepath_catalogbackup: Geben Sie das Verzeichnis in Ihrem Dateisystem an, in dem SAP HANA Sicherungen des SAP HANA-Sicherungskatalogs speichern kann, wenn keine Verbindung zu Ihrem Cloud Storage-Bucket hergestellt werden kann. Achten Sie darauf, dass dieses Verzeichnis genügend Speicherplatz für die Sicherungen hat.

    Die Parameter basepath_catalogbackup und basepath_logbackup zeigen den gleichen Wert im Abschnitt Persistenz der Datei global.ini an

Sicherung und Wiederherstellung prüfen

Nachdem Sie die Backint-Funktion des Google Cloud-Agents für SAP aktiviert haben, müssen Sie sie validieren, indem Sie eine Sicherung in einem Testsystem erstellen und wiederherstellen.

Zum Testen können Sie das integrierte Tool zur Selbstdiagnose des Agents verwenden. Sie benötigen mindestens 18 GB freien Speicherplatz auf Ihrem Dateisystem, um dieses integrierte Tool auszuführen. Führen Sie den folgenden Befehl aus, um dieses integrierte Tool zur Validierung der Sicherung und Wiederherstellung zu verwenden:

sudo /usr/bin/google_cloud_sap_agent backint -u=IDENTIFIER -p=PATH_TO_PARAMETERS_FILE -f=diagnose

Ersetzen Sie Folgendes:

  • IDENTIFIER: Ein Wert, der die Ausführung des Befehls angibt. Diese Kennung wird zum Benennen des temporären Ordners verwendet, der während der Diagnose im Cloud Storage-Bucket erstellt wird.
  • PATH_TO_PARAMETERS_FILE: Pfad zur Datei PARAMETERS.json

Sie können dabei die optionalen Parameter diagnose_file_max_size_gb und diagnose_tmp_directory verwenden. Weitere Informationen zu diesen Parametern finden Sie in der Beschreibung unter Konfigurationsparameter.

Wenn Sie den Backint-Agent auf Ihrem Host installiert haben, dann erstellt der Google Cloud-Agent für SAP beim ersten Verwenden von Google Cloud-Agent für SAP zur Durchführung eines Sicherungsvorgangs JSON-Versionen der Textkonfigurationsdateien. Weitere Informationen finden Sie unter Upgrade vom Backint-Agent.

Beispiel: Konfigurationsdatei

Im Folgenden finden Sie eine fertige PARAMETERS.json-Konfigurationsdatei für die Backint-Funktion des Google Cloud-Agents für SAP:

{
  "bucket": "example-bucket-backup",
  "recovery_bucket": "example-bucket-recovery",
  "parallel_streams": 8,
  "service_account_key": "path/to/key/file.json",
  "rate_limit_mb": 100,
  "log_to_cloud": true,
  "log_level": "DEBUG"
}

Konfigurationsparameter

In der folgenden Tabelle werden die Konfigurationsparameter des Agents von Google Cloud für SAP erläutert, die für die Backint-Funktion spezifisch sind.

Informationen zur Zuordnung der Konfigurationsparameter des Backint-Agents und des Google Cloud-Agents für SAP finden Sie unter Zuordnung von Konfigurationsparametern.

Informationen zu den Konfigurationsparametern des Google Cloud-Agents für SAP, einschließlich der Parameter für die Messwerterfassung, finden Sie in der Installationsanleitung für Ihr Szenario.

Parameter
bucket

String

Geben Sie den Namen des Cloud Storage-Bucket an, in den der Google Cloud-Agent für SAP schreibt und aus dem er liest. Der Backint-Agent erstellt Sicherungsobjekte mit der Speicherklasse des Buckets und unterstützt alle Speicherklassen. Der Agent verwendet die Compute Engine-Standardverschlüsselung, um inaktive Daten zu verschlüsseln.

recovery_bucket

String

Optional. Geben Sie den Namen des Cloud Storage-Bucket an, aus dem der Agent bei RESTORE-Vorgängen liest. Wenn Sie diesen Parameter nicht angeben, verwendet der Agent den für den Parameter bucket angegebenen Bucket für alle Vorgänge: BACKUP, RESTORE, INQUIRE, DELETE und DIAGNOSE.

Wir empfehlen die Verwendung dieses Parameters, um die Konfigurationsverwaltung für Systemkopien und Systemaktualisierungsvorgänge zu vereinfachen. Er ist jedoch nicht mit dem Argument CHECK ACCESS USING BACKINT bei SAP HANA-Wiederherstellungsvorgängen kompatibel.

log_to_cloud

Boolean

Optional. Geben Sie true an, um die Backint-bezogenen Logs des Agents von Google Cloud für SAP an Cloud Logging weiterzuleiten. Der Standardwert ist true.

Wenn Ihre SAP HANA-Datenbank in einer lokalen Umgebung ausgeführt wird, müssen Sie den Wert dieses Parameters auf false festlegen.

Informationen zur Backint-Logdatei finden Sie unter Logging.

log_level

String

Optional. Geben Sie die Logging-Ebene für die Backint-Funktion des Google Cloud-Agents für SAP an und legen Sie den erforderlichen Wert fest. Folgende Logebenen sind verfügbar:

  • DEBUG
  • INFO
  • WARNING
  • ERROR

Der Standardwert ist INFO. Ändern Sie die Logging-Ebene nur, wenn Sie von Cloud Customer Care angewiesen werden.

compress

Boolean

Optional. Geben Sie an, ob der Google Cloud-Agent für SAP die Komprimierung beim Schreiben von Sicherungen in den Cloud Storage-Bucket aktivieren soll. Der Standardwert ist false.

Wir empfehlen, die Komprimierung nicht zu aktivieren. Durch die Komprimierung werden zwar die Speicherkosten für Sicherungen in Cloud Storage gesenkt, sie erfordert aber während Sicherungsvorgängen mehr CPU-Verarbeitung und verlangsamt den effektiven Sicherungsdurchsatz.

Unabhängig von diesem Parameter unterstützt der Google Cloud-Agent für SAP sowohl komprimierte als auch unkomprimierte Sicherungsdateien während eines Wiederherstellungsvorgangs.

encryption_key

String

Optional. Geben Sie den Pfad zum vom Kunden bereitgestellten Verschlüsselungsschlüssel an, den Sie für die Verschlüsselung von Sicherungen für Ihren Cloud Storage-Bucket konfiguriert haben. Geben Sie einen vollständig qualifizierten Pfad zu einem base64-codierten AES-256-Schlüssel an.

Sie können den Parameter encryption_key nicht mit den Parametern kms_key oder parallel_streams angeben.

kms_key

String

Optional. Geben Sie den Pfad zum vom Kunden verwalteten Verschlüsselungsschlüssel an, den Sie für die Verschlüsselung von Sicherungen für Ihren Cloud Storage-Bucket konfiguriert haben. Geben Sie den Pfad im Format projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_NAME/cryptoKeys/KMS_KEY_NAME an. Dabei gilt:

  • KMS_PROJECT_ID: die ID des Google Cloud-Projekts, in dem sich der KMS-Schlüssel befindet
  • LOCATION: den Cloud KMS-Speicherort, an dem sich Ihr KMS-Schlüssel befindet
  • KEY_RING_NAME: der Name des Schlüsselbunds, der den KMS-Schlüssel enthält
  • KMS_KEY_NAME: der Name des KMS-Schlüssels

Wenn Ihr SAP HANA-System auf einer Compute Engine-Instanz ausgeführt wird, muss der Schlüssel für diese Instanz zugänglich sein. Wenn Ihr SAP HANA-System auf einem anderen Host als einer Compute Engine-Instanz ausgeführt wird, muss das Dienstkonto, das vom Google Cloud-Agent für SAP verwendet wird, auf den Cloud KMS-Schlüssel zugreifen können. Weitere Informationen finden Sie unter Dienstkonten.

Sie können den Parameter kms_key nicht mit den Parametern encryption_key oder parallel_streams angeben.

folder_prefix

String

Optional. Geben Sie an, dass ein Präfix für die Ordner im Cloud Storage-Bucket festgelegt werden soll, in den der Google Cloud-Agent für SAP schreibt und aus dem er liest. Mit diesem Parameter können Sie Sicherungen verschiedener SAP HANA-Instanzen im selben Cloud Storage-Bucket organisieren. Sie können einen einzelnen Ordner wie folder1 oder einen mehrstufigen Ordnerpfad wie folder1/folder2/folder3 angeben.

Dieses Präfix wird als Ordner zwischen den Werten BUCKET_NAME und SID im Pfad für Ihre SAP HANA-Sicherungen in Cloud Storage eingefügt. Weitere Informationen finden Sie unter Unterstützte Anpassungen.

Dieser Parameter ist ab Version 3.1 des Agent verfügbar.

recovery_folder_prefix

String

Optional. Hiermit wird ein Präfix für die Ordner im Cloud Storage-Bucket festgelegt, die der Agent bei RESTORE-Vorgängen liest. Mit diesem Parameter können Sie Sicherungen verschiedener SAP HANA-Instanzen im selben Cloud Storage-Bucket organisieren. Sie können einen einzelnen Ordner wie folder1 oder einen mehrstufigen Ordnerpfad wie folder1/folder2/folder3 angeben. Weitere Informationen finden Sie unter Unterstützte Anpassungen.

Dieser Parameter ist ab Version 3.1 des Agent verfügbar.

Wir empfehlen die Verwendung dieses Parameters, um die Konfigurationsverwaltung für Systemkopien und Systemaktualisierungsvorgänge zu vereinfachen. Er ist jedoch nicht mit dem Argument CHECK ACCESS USING BACKINT bei SAP HANA-Wiederherstellungsvorgängen kompatibel.

shorten_folder_path

Boolean

Optional. Gib an, ob der Objektpfad im Cloud Storage-Bucket, aus dem der Agent bei allen Backint-Vorgängen liest und in den er schreibt, gekürzt werden soll. Weitere Informationen finden Sie unter Unterstützte Anpassungen.

Dieser Parameter ist ab Version 3.3 des Agent verfügbar.

retries

Int

Gibt an, wie oft der Google Cloud-Agent für SAP einen fehlgeschlagenen Versuch, in Cloud Storage zu lesen oder zu schreiben, wiederholt. Der Standardwert ist 5. Dies ist auch der empfohlene Wert.

parallel_streams

Int

Optional. Geben Sie diesen Parameter an, um den parallelen Upload von Sicherungen in Ihren Cloud Storage-Bucket zu aktivieren. Der Wert, den Sie für diesen Parameter angeben, ist die maximale Anzahl paralleler Uploadstreams, die der Google Cloud-Agent für SAP verwenden kann. Der Höchstwert ist 32. Werte darüber werden auf 32 begrenzt.

Der Standardwert ist 1, wodurch parallele Uploads deaktiviert werden.

Wenn Sie den parallelen Upload für Streamingdaten aktivieren möchten oder für Ihren Cloud Storage-Bucket eine Aufbewahrungsrichtlinie gilt, müssen Sie xml_multipart_upload auch auf true festlegen.

Aktivieren Sie in folgenden Fällen keinen parallelen Upload:

  • Der Ziel-Cloud Storage-Bucket verwendet eine Aufbewahrungsrichtlinie.
  • Sie haben die Parameter encryption_key oder kms_key angegeben.

Wenn eine der oben genannten Bedingungen erfüllt ist, wird der Agent mit dem Status 1 beendet. Informationen zu parallelen Uploads finden Sie unter Parallele Uploads.

xml_multipart_upload

Boolean

Optional. Gibt an, ob die Methode Mehrere Uploads mit der XML API beim Schreiben von Sicherungen in den Cloud Storage-Bucket verwendet wird. Der Standardwert ist false.

Dieser Parameter ist ab Version 3.2 des Agent verfügbar.

Damit Sie die mehrteilige XML API-Uploadmethode verwenden können, muss parallel_streams einen Wert haben, der größer als 1 ist. Wenn Sie xml_multipart_upload auf true festlegen, aber parallel_streams nicht angeben, wird parallel_streams automatisch der Wert 16 zugewiesen.

Wir empfehlen, xml_multipart_upload nur zum Parallelisieren von Protokoll- oder Katalogsicherungen zu verwenden. Wenn Sie Datensicherungen parallelisieren möchten, empfehlen wir, in der Datei global.ini im Abschnitt backup den Wert parallel_data_backup_backint_channels festzulegen.

Informationen zum Erstellen separater Parameterdateien für Log- und Datensicherungen oder zum Festlegen eines Werts für parallel_data_backup_backint_channels finden Sie unter SAP HANA für das Backint-Feature konfigurieren.

Bei einem Fehler werden die mehrteiligen XML-Uploads automatisch abgebrochen und die hochgeladenen Daten gelöscht. Wir empfehlen außerdem, Lebenszyklusbedingungen für AbortIncompleteMultipartUpload festzulegen, damit Daten gelöscht werden, wenn der Upload fehlschlägt.

storage_class

String

Optional. Geben Sie die Speicherklasse an, die beim Schreiben von Sicherungen in den Cloud Storage-Bucket verwendet wird. Folgende Speicherklassen sind verfügbar:

  • STANDARD
  • NEARLINE
  • COLDLINE
  • ARCHIVE

Der Standardwert ist STANDARD.

Dieser Parameter ist ab Version 3.2 des Agent verfügbar.

metadata

Map<String, String>

Optional. Geben Sie Schlüssel/Wert-Felder an, die beim Schreiben von Sicherungen in den Cloud Storage-Bucket als Metadaten für Objekte gespeichert werden sollen.

Dieser Parameter ist ab Version 3.3 des Agent verfügbar.

Das Format einer PARAMETERS.json-Beispielkonfigurationsdatei sieht so aus:

{
  "bucket": "example-bucket-backup",
  "metadata": {"key1": "value1", "key2": "value2"},
  "log_to_cloud": true
}

Die standardmäßig geschriebenen Metadaten sind {"X-Backup-Type": "PIPE"} oder {"X-Backup-Type": "FILE"}, je nach Dateityp.

custom_time

String

Optional. Geben Sie ein Datum und eine Uhrzeit an, die Sie für die Custom-Time-Metadaten für die Sicherungen festlegen möchten, die Sie in Cloud Storage hochladen. Sie müssen Datum und Uhrzeit in dem in Custom-Time angegebenen Format angeben.

Dieser Parameter ist ab Version 3.4 des Agents verfügbar.

Sie können diesen Parameter mit dem Wert UTCNow festlegen. Dadurch werden die Custom-Time-Metadaten mit den Datums- und Uhrzeitangaben in UTC festgelegt, zu denen die Sicherung erstellt wird.

Ab Version 3.6 des Agents können Sie mit UTCNow+NUMBERd ein zukünftiges Datum für die Custom-Time-Metadaten festlegen. Wenn Sie Custom-Time beispielsweise auf 30 Tage nach der Erstellung des Back-ups festlegen möchten, konfigurieren Sie die Option so:

{
  "bucket": "example-bucket-backup",
  "custom_time": "UTCNow+30d",
  "log_to_cloud": true
}

Das folgende Beispiel zeigt, wie Sie diesen Parameter in Ihrer PARAMETERS.json-Datei mit einem Datums-/Zeitwert angeben können:

{
  "bucket": "example-bucket-backup",
  "custom_time": "2024-06-25T13:25:00Z",
  "log_to_cloud": true
}
rate_limit_mb

Int

Optional. Geben Sie die Obergrenze in MB für die ausgehende Netzwerkbandbreite der Compute Engine während Sicherungs- oder Wiederherstellungsvorgängen an. Standardmäßig begrenzt Google Cloud die Netzwerkbandbreite für den Google Cloud-Agent für SAP nicht. Wenn Sie diesen Parameter festlegen, kann der Durchsatz variieren, überschreitet jedoch nicht den angegebenen Grenzwert.

service_account_key

String

Wenn der Agent für SAP von Google Cloud nicht auf einer Compute Engine-Instanz ausgeführt wird, geben Sie den vollständig qualifizierten Pfad zum JSON-codierten Google Cloud-Dienstkonto an. Wenn der Google Cloud-Agent für SAP auf einer Compute Engine-Instanz ausgeführt wird, empfehlen wir, diesen Parameter nicht anzugeben und stattdessen die standardmäßige Compute Engine-Authentifizierung zu verwenden.

Wenn Sie diesen Parameter angeben, wird der Google Cloud-Agent für SAP angewiesen, den Dienstkontoschlüssel bei der Authentifizierung bei Cloud Storage zu verwenden.

diagnose_file_max_size_gb

Int

Optional. Geben Sie die Obergrenze für die Größe der temporären Datei in GB an, die vom Selbstdiagnosetool des Kundenservicemitarbeiters erstellt und gelöscht wird. Der Standardwert ist 16 GB.

Dieser Parameter ist ab Version 3.3 des Agent verfügbar.

Damit das Selbstdiagnosetool ordnungsgemäß funktioniert, muss der verfügbare Speicherplatz in Ihrem Dateisystem mindestens 2 bis 3 GB über dem Wert von diagnose_file_max_size_gb liegen.

diagnose_tmp_directory

String

Optional. Geben Sie das Verzeichnis an, in dem temporäre Dateien für das Selbstdiagnosetool des Kundenservicemitarbeiters gelesen und geschrieben werden. Der Standardwert ist /tmp/backint-diagnose.

Dieser Parameter ist ab Version 3.3 des Agent verfügbar.

send_metrics_to_monitoring

Boolean

Optional. Gibt an, ob der Agent Messwerte zum Status und Durchsatz von Dateien erfassen kann, die während Backint-Vorgängen hoch- oder heruntergeladen werden. Der Agent sendet die erfassten Messwerte an Cloud Monitoring.

Dieser Parameter ist ab Version 3.3 des Agent verfügbar.

Der Standardwert ist true. Wenn Ihre SAP HANA-Datenbank in einer lokalen Umgebung ausgeführt wird, müssen Sie den Wert dieses Parameters auf false festlegen. Informationen zu den Backint-bezogenen Messwerten finden Sie unter Backint-Messwerterfassung.

threads

Int

Dies ist ein optionaler Parameter für die erweiterte Abstimmung. Ändern Sie diesen Parameter nur, wenn Sie von Cloud Customer Care dazu aufgefordert werden. Der Standardwert muss nur selten geändert werden.

Geben Sie die Anzahl der Worker-Threads an. Der Standardwert ist die Anzahl der Prozessoren auf dem Host.

file_read_timeout_ms

Int

Dies ist ein optionaler Parameter für die erweiterte Abstimmung. Ändern Sie diesen Parameter nur, wenn Sie von Cloud Customer Care dazu aufgefordert werden. Der Standardwert muss nur selten geändert werden.

Geben Sie die maximale Zeit in Millisekunden an, die der Google Cloud-Agent für SAP wartet, bevor er die Sicherungsdatei öffnet. Der Standardwert beträgt 60000 (60 Sekunden).

buffer_size_mb

Int

Dies ist ein optionaler Parameter für die erweiterte Abstimmung. Ändern Sie diesen Parameter nur, wenn Sie von Cloud Customer Care dazu aufgefordert werden. Der Standardwert muss nur selten geändert werden.

Geben Sie diesen Parameter an, um die Größe von HTTPS-Anfragen an Cloud Storage während Sicherungs- oder Wiederherstellungsvorgängen zu steuern. Die standardmäßige Puffergröße beträgt 100 MB. Dementsprechend bleibt ein einzelner HTTP-Anfragestream zu oder von Cloud Storage geöffnet, bis 100 MB Daten übertragen wurden. Die maximale Puffergröße beträgt 250 MB.

Da der Google Cloud-Agent für SAP fehlgeschlagene HTTPS-Anfragen mehrmals wiederholt, bevor der ganze Vorgang fehlschlägt, führen Puffergrößen unter 100 MB dazu, dass weniger Daten noch einmal übertragen werden müssen, wenn eine Anfrage fehlschlägt. Größere Chunk-Größen können den Durchsatz verbessern, erfordern jedoch eine höhere Speichernutzung und mehr Zeit zum erneuten Senden von Daten im Falle einer fehlgeschlagenen Anfrage.

Wenn Sie den Parameter parallel_streams verwenden, muss die erforderliche Arbeitsspeichernutzung mit diesem Wert multipliziert werden, da jeder Stream einen eigenen Puffer für die Verarbeitung der HTTPS-Anfragen benötigt.

retry_backoff_initial

Int

Dies ist ein optionaler Parameter für die erweiterte Abstimmung. Ändern Sie diesen Parameter nur, wenn Sie von Cloud Customer Care dazu aufgefordert werden. Der Standardwert muss nur selten geändert werden.

Geben Sie den Anfangswert in Sekunden für den Wiederholungszeitraum an, der bei den Netzwerkwiederholungen mit exponentiellem Backoff verwendet wird. Der Standardwert ist 10.

retry_backoff_max

Int

Dies ist ein optionaler Parameter für die erweiterte Abstimmung. Ändern Sie diesen Parameter nur, wenn Sie von Cloud Customer Care dazu aufgefordert werden. Der Standardwert muss nur selten geändert werden.

Geben Sie den maximalen Wert in Sekunden für die Wiederholungsdauer an, die bei den exponentiellen Backoff-Netzwerkwiederholungen verwendet wird. Der Standardwert ist 300.

retry_backoff_multiplier

Float

Dies ist ein optionaler Parameter für die erweiterte Abstimmung. Ändern Sie diesen Parameter nur, wenn Sie von Cloud Customer Care dazu aufgefordert werden. Der Standardwert muss nur selten geändert werden.

Legen Sie den Multiplikator für den Wiederholungszeitraum fest, der bei den Netzwerkwiederholungen mit exponentiellem Backoff verwendet wird. Der Multiplikator muss größer als 1 sein. Der Standardwert ist 2.

log_delay_sec

Int

Dies ist ein optionaler Parameter für die erweiterte Abstimmung. Ändern Sie diesen Parameter nur, wenn Sie von Cloud Customer Care dazu aufgefordert werden. Der Standardwert muss nur selten geändert werden.

Gib die Protokollierungsverzögerung in Sekunden für Fortschrittsaktualisierungen bei Lese- und Schreibvorgängen im Cloud Storage-Bucket an. Der Standardwert ist 60.

client_endpoint

String

Dies ist ein optionaler Parameter für die erweiterte Abstimmung. Ändern Sie diesen Parameter nur, wenn Sie von Cloud Customer Care dazu aufgefordert werden. Der Standardwert muss nur selten geändert werden.

Geben Sie den Endpunkt des Cloud Storage-Clients an. Der Standardwert ist storage.googleapis.com.

Fehlerbehebung

Informationen zur Fehlerbehebung bei Problemen mit Version 3.6 (aktuell) von Google Cloud-Agent für SAP finden Sie in den Tipps zur Fehlerbehebung für den Google Cloud-Agent für SAP.

Support kontaktieren

Wenn Sie Hilfe bei der Behebung eines Problems mit dem Google Cloud-Agent für SAP benötigen, erfassen Sie die erforderlichen Diagnoseinformationen und wenden Sie sich an Cloud Customer Care. Weitere Informationen finden Sie unter Diagnoseinformationen zum Google Cloud-Agent für SAP für SAP HANA.

Nächste Schritte