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.

Informationen zu dieser Funktion finden Sie unter Sicherung und Wiederherstellung für SAP HANA mit Backint.

Informationen zum Ausführen von Sicherungs- und Wiederherstellungsvorgängen für SAP HANA mit Backint finden Sie unter SAP HANA mit Backint sichern und wiederherstellen.

Hinweise

  • Prüfen Sie Ihre Installation von Version 3.5 (aktuell) des Google Cloud-Agent 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 Sie dieses Feature für eine Instanz des Google Cloud-Agents für SAP aktivieren müssen, die auf einem anderen Host als einer Compute Engine-VM-Instanz oder einem Bare-Metal-Lösungsserver ausgeführt wird, dann 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 bewerten können.
  • Installieren Sie SAP HANA:

Cloud Storage-Bucket erstellen

Bevor Sie das Backint-Feature des Google Cloud-Agents für SAP aktivieren, muss ein Cloud Storage-Bucket zum Speichern Ihrer Sicherungen vorhanden sein. Wenn Sie 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-VM 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 aus der Liste der verfügbaren Rollen Storage-Objekt-Administrator aus.

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

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 die folgenden Google Cloud-IP-Adressen und -Hosts:

  • Für den Zugriff auf Cloud Storage: storage.googleapis.com
  • Für den Metadatenserver der Compute Engine-VM-Instanz:
    • 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-VM ausgeführt werden, die keinen Zugriff auf das Internet hat, müssen Sie den privaten Google-Zugriff konfigurieren, damit der Agent mit Cloud Storage interagieren und sich bei Verwendung eines dedizierten Dienstkontos bei Google Cloud authentifizieren kann. Eine ausführliche Anleitung finden Sie unter Privaten Google-Zugriff konfigurieren.

Backint-Funktion aktivieren

Führen Sie die folgenden Schritte aus, um das Backint-Feature des Google Cloud-Agents für SAP zu aktivieren:

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

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

  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, einschließlich $SAPSYSTEMNAME, die mit der SID Ihrer SAP HANA-Datenbank festgelegt werden.

  3. Aktivieren Sie das Backint-Feature für den Google Cloud-Agent für SAP:

    /usr/bin/google_cloud_sap_agent installbackint

    Alternativ können Sie das Flag sid einfügen, um die Backint-bezogenen Dateien auf einem Host mit einer anderen SID zu installieren:

    /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-Agent für SAP beziehen, im Verzeichnis /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/ installiert. Dies gilt auch für Dateien, die zum Einbinden des Agents in SAP HANA erforderlich sind. Außerdem wird der Cloud Storage Backint-Agent für SAP HANA auf Ihrem Host erkannt, dieser Agent 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

    Führen Sie den Befehl configurebackint aus, um das Backint-Feature des Agents zu konfigurieren. Wir empfehlen diesen Ansatz gegenüber dem Bearbeiten der Backint-Konfigurationsdatei.

    /usr/bin/google_cloud_sap_agent configurebackint \
  -f="PATH_TO_PARAMETERS_FILE" \
  -bucket="BUCKET_NAME"

    Ersetzen Sie Folgendes:

    • PATH_TO_PARAMETERS_FILE: Pfad zur Backint-Konfigurationsdatei PARAMETERS.json

    • BUCKET_NAME: Geben Sie den Namen des Cloud Storage-Buckets an, in dem Sie Ihre SAP HANA-Sicherungen speichern möchten.

      Optional können Sie weitere Parameter festlegen, während Sie diesen Befehl ausführen. Weitere Informationen zu diesen Parametern finden Sie unter Konfigurationsparameter.

    Konfigurationsdatei bearbeiten

    Statt den Befehl configurebackint des Agents auszuführen, bearbeiten Sie die Backint-Konfigurationsdatei so:

    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, auf dem Sie die Backint-Dateien installiert haben.

      Im Folgenden finden Sie ein Beispiel für die Inhalte 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 dann 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. Optional können Sie andere Konfigurationsparameter ändern. Weitere Informationen zu diesen Parametern finden Sie unter Konfigurationsparameter.

    4. Speichern Sie die Konfigurationsdatei.

Backint-Konfigurationsdatei anpassen

Optional können Sie die folgenden Anpassungen vornehmen, nachdem Sie das Backint-Feature des Google Cloud-Agents für SAP aktiviert haben:

  • Benennen Sie die Datei parameters.json um.

    Um diese Umbenennung anzugeben, wird diese Datei in der Dokumentation von Google Cloud-Agent für SAP als PARAMETERS.json bezeichnet.

  • Erstellen Sie eine separate Konfigurationsdatei für jedes der folgenden Elemente: SAP HANA-Datenvolume, SAP HANA-Log-Volume und SAP HANA-Sicherungskatalog.

    Legen Sie für jede Konfigurationsdatei einen eindeutigen Namen fest.

  • 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. Das erleichtert Ihnen die Verwaltung dieser Dateien.

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

SAP HANA für das Backint-Feature konfigurieren

Nachdem Sie das Backint-Feature des Google Cloud-Agents für SAP aktiviert haben, müssen Sie Ihr SAP HANA-System für die Verwendung dieses Features 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 Multistreaming-Datensicherungen die Anzahl der Kanäle an. Berücksichtigen Sie dabei den Typ des verwendeten Cloud Storage-Buckets, die erforderliche Leistung und den Laufwerkdurchsatz.
    log_backup_using_backint Wenn Sie eine separate Konfigurationsdatei für das SAP HANA-Sicherungslog-Volume verwenden, geben Sie den Wert true an.
    log_backup_parameter_file

    Wenn Sie eine separate Konfigurationsdatei für das SAP HANA-Sicherungslog-Volume verwenden, geben Sie 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.

    Das folgende Beispiel zeigt 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 zum Speichern von 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 zum Speichern von 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 das Backint-Feature des Google Cloud-Agents für SAP aktiviert haben, müssen Sie es validieren, indem Sie eine Sicherung in einem Testsystem erstellen und wiederherstellen.

Zu Testzwecken können Sie das integrierte Selbstdiagnosetool 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 zum Validieren 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 identifiziert. Diese Kennzeichnung wird verwendet, um den temporären Ordner zu benennen, der während der Diagnose im Cloud Storage-Bucket erstellt wird.
  • PATH_TO_PARAMETERS_FILE: Pfad zur Datei PARAMETERS.json

Bei der Verwendung dieses Tools können Sie die optionalen Parameter diagnose_file_max_size_gb und diagnose_tmp_directory verwenden. Weitere Informationen zu diesen Parametern finden Sie in den Beschreibungen 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 vollständige PARAMETERS.json-Konfigurationsdatei des Backint-Features 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 das Backint-Feature spezifisch sind.

Informationen zur Zuordnung zwischen den Konfigurationsparametern 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-Buckets 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-Buckets an, den der Agent während 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 Systemkopier- und Systemaktualisierungsvorgänge zu vereinfachen. Er ist jedoch während SAP HANA-Wiederherstellungsvorgängen nicht mit dem Argument CHECK ACCESS USING BACKINT 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.

Informationen zur Backint-bezogenen Logdatei finden Sie unter Logging.
log_level

String

Optional. Geben Sie die Logging-Ebene für das Backint-Feature des Google Cloud-Agent 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 während eines Wiederherstellungsvorgangs sowohl komprimierte als auch nicht komprimierte Sicherungsdateien.
encryption_key

String

Optional. Geben Sie den Pfad zum vom Kunden bereitgestellten Verschlüsselungsschlüssel an, den Sie für den Cloud Storage-Bucket zum Verschlüsseln von Sicherungen 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 Ihren Cloud Storage-Bucket für die Verschlüsselung von Sicherungen 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 ist der Cloud KMS-Standort, an dem sich Ihr KMS-Schlüssel befindet.
  • KEY_RING_NAME ist 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-VM ausgeführt wird, muss der Schlüssel für die VM zugänglich sein. Wenn Ihr SAP HANA-System auf einem anderen Host als einer Compute Engine-VM ausgeführt wird, muss der Cloud KMS-Schlüssel auf das Dienstkonto zugänglich sein, das vom Google Cloud-Agent für SAP verwendet wird. 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, ein Präfix für die Ordner im Cloud Storage-Bucket festzulegen, 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 Pfad für Ordner 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. Geben Sie an, ein Präfix für die Ordner im Cloud Storage-Bucket festzulegen, die der Agent während 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 Pfad für Ordner 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. Geben Sie an, um den Objektpfad im Cloud Storage-Bucket zu kürzen, den der Agent während aller Backint-Vorgänge liest und schreibt. 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. Jeder Wert, der diesen Wert überschreitet, ist auf 32 begrenzt.

Der Standardwert ist 1, wodurch der parallele Upload deaktiviert wird.

Wenn Sie den parallelen Upload für Streamingdaten aktivieren möchten oder wenn Ihr Cloud Storage-Bucket eine Aufbewahrungsrichtlinie hat, müssen Sie auch xml_multipart_upload auf true setzen.

Aktivieren Sie den parallelen Upload nicht, wenn eine der folgenden Bedingungen zutrifft:

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

Wenn eine der vorherigen 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 mehrteilige XML API-Uploadmethode 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 nicht parallel_streams angeben, wird parallel_streams automatisch der Wert 16 zugewiesen.

Wir empfehlen die Verwendung von xml_multipart_upload nur zum Parallelisieren von Log- oder Katalogsicherungen. Zum Parallelisieren von Datensicherungen empfehlen wir, parallel_data_backup_backint_channels im Abschnitt backup der Datei global.ini 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 werden gelöscht. Wir empfehlen außerdem, Lebenszyklusbedingungen für AbortIncompleteMultipartUpload festzulegen, damit Daten gelöscht werden, wenn der Uploadvorgang 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. Beispiele:

{
  "bucket": "example-bucket-backup",
  "custom_time": "UTCNow",
  "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 von 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 Google Cloud-Agent für SAP nicht auf einer Compute Engine-VM 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-VM ausgeführt wird, empfehlen wir, diesen Parameter nicht anzugeben und stattdessen die Compute Engine-Standardauthentifizierung 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 Agents 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 Self-Diagnose-Tool des Agents 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. Informationen zu den Backint-bezogenen Messwerten finden Sie unter Backint-Messwerterfassung.
threads

Int

Dies ist ein optionaler erweiterter Abstimmungsparameter. Ä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 im Host.
file_read_timeout_ms

Int

Dies ist ein optionaler erweiterter Abstimmungsparameter. Ä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 erweiterter Abstimmungsparameter. Ä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 von weniger als 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 Speichernutzung mit diesem Wert multipliziert werden, da jeder Stream einen eigenen Zwischenspeicher zur Verarbeitung der HTTPS-Anfragen benötigt.
retry_backoff_initial

Int

Dies ist ein optionaler erweiterter Abstimmungsparameter. Ä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 exponentiellen Backoff-Netzwerkwiederholungen verwendet wird. Der Standardwert ist 10.
retry_backoff_max

Int

Dies ist ein optionaler erweiterter Abstimmungsparameter. Ä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 Höchstwert in Sekunden für den Wiederholungszeitraum an, der bei den exponentiellen Backoff-Netzwerkwiederholungen verwendet wird. Der Standardwert ist 300.
retry_backoff_multiplier

Float

Dies ist ein optionaler erweiterter Abstimmungsparameter. Ä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 Multiplikator für den Wiederholungszeitraum an, der bei den exponentiellen Backoff-Netzwerkwiederholungen verwendet wird. Der Multiplikator muss größer als 1 sein und der Standardwert ist 2.
log_delay_sec

Int

Dies ist ein optionaler erweiterter Abstimmungsparameter. Ä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 Logging-Verzögerung in Sekunden für die Aktualisierung des Fortschritts bei Lese- und Schreibvorgängen in den Cloud Storage-Bucket an. Der Standardwert ist 60.
client_endpoint

String

Dies ist ein optionaler erweiterter Abstimmungsparameter. Ä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.5 (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 anfordern

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.