Installationsanleitung für den Cloud Storage-Backint-Agent in SAP HANA

In dieser Anleitung erfahren Sie, wie Sie den Cloud Storage Backint-Agent für SAP HANA (Backint-Agent) installieren und konfigurieren.

Informationen zu den Konfigurationsoptionen des Backint-Agents finden Sie unter Cloud Storage Backint-Agent für SAP HANA Übersicht.

Vorbereitung

Bevor Sie den Backint-Agent installieren können, müssen Sie zuerst SAP HANA installieren. Informationen zum Installieren von SAP HANA in Google Cloud finden Sie in der Bereitstellungsanleitung für SAP HANA.

Informationen zur Installation von SAP HANA für eine Bare-Metal-Lösung finden Sie im Planungsleitfaden für SAP HANA in der Bare-Metal-Lösung.

Wenn die Host-VM keinen Zugriff auf das Internet hat, müssen Sie den privaten Google-Zugriff konfigurieren, damit der Backint-Agent auf die Google Cloud APIs zugreifen kann. Informationen zum Konfigurieren des privaten Google-Zugriffs finden Sie unter Privaten Google-Zugriff konfigurieren.

Cloud Storage-Bucket für Sicherungen erstellen

Bevor Sie den Backint-Agent konfigurieren können, müssen Sie einen Cloud Storage-Bucket erstellen, in dem die Sicherungen gespeichert werden.

Verwenden Sie zum Erstellen eines Cloud Storage-Buckets die Cloud Console.

Weitere Informationen zu Bucket-Optionen finden Sie unter Back-ups in Cloud Storage-Buckets speichern.

  1. Öffnen Sie den Cloud Storage-Browser in der Cloud Console.

    Zur Seite "Storage-Browser"

  2. Klicken Sie auf BUCKET ERSTELLEN.

  3. Benennen Sie den Bucket und klicken Sie dann auf Weiter.

  4. Folgen Sie den Anweisungen, um die Bucket-Optionen auszuwählen.

  5. Klicken Sie auf Erstellen.

  6. Klicken Sie zum Konfigurieren der Bucket-Berechtigungen auf den Tab Berechtigungen. Als Eigentümer des Buckets haben Sie standardmäßig Lese-/Schreibzugriff auf den Bucket. Sie können auch anderen Mitgliedern Ihrer Gruppe oder einzelnen Nutzern Zugriff auf Ihren Bucket gewähren.

Backint-Agent auf dem SAP HANA-Host installieren

Der Backint-Agent wird in demselben freigegebenen Dateisystem wie die SAP HANA-Datenbank installiert.

Installieren Sie in einer SAP HANA-Bereitstellung mit horizontaler Skalierung den Backint-Agent auf jedem Knoten des SAP HANA-Systems. Um die Verwaltung zu vereinfachen, können Sie Ihre Konfigurationsdateien an einem freigegebenen Speicherort speichern, der für alle Knoten in Ihrer Bereitstellung zugänglich ist, z. B. /hana/shared.

  1. Stellen Sie eine SSH-Verbindung zu Ihrem SAP HANA-Host her. Wenn es sich bei Ihrem Host um eine Compute Engine-VM handelt, können Sie auf der Seite "VM-Instanzen" auf die SSH-Schaltfläche für Ihre VM-Instanz klicken oder Ihre bevorzugte SSH-Methode verwenden.

  2. Wechseln Sie zum SAP HANA-Systemadministrator.

    sudo su - sidadm
    
  3. Laden Sie den Backint-Agent herunter und installieren Sie ihn.

    curl https://storage.googleapis.com/cloudsapdeploy/backint-gcs/install.sh | bash
    

    Das Skript install.sh führt die folgenden Aktionen aus:

    • Installiert den Backint-Agent als JAR-Datei in /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
    • Lädt eine kompatible Version der Java-Laufzeitumgebung herunter.
    • Richtet das Skript backint ein, das den Backint-Agent aufruft Ändern Sie das backint-Skript nur, wenn Sie von der Cloud-Kundenbetreuung dazu aufgefordert werden.
    • Bei Abschluss wird eine Meldung ausgegeben, in der Sie aufgefordert werden, die Datei parameters.txt zu aktualisieren und die Authentifizierung einzurichten. Weitere Informationen finden Sie unter Backint-Agent und SAP HANA konfigurieren.
  4. Wenn eines der folgenden Szenarien auf Sie zutrifft, müssen Sie ein Dienstkonto für den Backint-Agent erstellen:

    • Sie benötigen den Backint-Agent, um einen anderen Satz von Ressourcenberechtigungen zu verwenden als Ihre Host-VM in Compute Engine verwendet.
    • SAP HANA läuft auf der Bare-Metal-Lösung.
    • SAP HANA wird nicht in Google Cloud ausgeführt.

    So erstellen Sie ein Dienstkonto für den Backint-Agent:

    1. Rufen Sie in der Cloud Console die Seite Dienstkonten auf.

      Zur Seite „Dienstkonten“

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

    3. Klicken Sie auf Dienstkonto erstellen.

    4. Geben Sie einen Namen für das Dienstkonto und optional eine Beschreibung an.

    5. Klicken Sie auf Erstellen und fortfahren.

    6. Klicken Sie auf Weiter, um das Dienstkonto ohne Berechtigungen zu erstellen.

    7. Gewähren Sie Nutzern gegebenenfalls Zugriff auf das Dienstkonto.

    8. Klicken Sie auf Fertig.

    9. Klicken Sie in der Cloud Console auf der Seite Dienstkonten auf die E-Mail-Adresse des Dienstkontos, das Sie gerade erstellt haben.

    10. Klicken Sie unter dem Namen des Dienstkontos auf den Tab Schlüssel.

    11. Klicken Sie auf das Drop-down-Menü Schlüssel hinzufügen und wählen Sie Neuen Schlüssel erstellen, um einen Dienstkontoschlüssel zu erstellen.

    12. Verwenden Sie als Schlüsseltyp JSON und klicken Sie auf ERSTELLEN. Ein privater Schlüssel wird auf Ihrem Computer gespeichert.

  5. Laden Sie die JSON-Schlüsseldatei auf den SAP HANA-Host hoch.

    • Speichern Sie die JSON-Datei in einem Verzeichnis, auf das der sidadm-Nutzer zugreifen kann, z. B. /usr/sap/SID/home.
    • Prüfen Sie, ob der Nutzer sidadm zum Lesen der Datei berechtigt ist.
  6. Aktualisieren Sie Ihren Cloud Storage-Bucket, um dem Dienstkonto die Berechtigung zur Verwendung des Buckets zu gewähren:

    1. Klicken Sie im Cloud Storage-Browser auf den Bucket-Namen.

      Cloud Storage-Browser öffnen

    2. Klicken Sie auf den Tab Berechtigungen.

    3. Klicken Sie auf Mitglieder hinzufügen.

    4. Geben Sie im Feld Neue Mitglieder die vollständige E-Mail-Adresse des Dienstkontos ein. Beispiele:

      backint-test@my-project.iam.gserviceaccount.com

    5. Klicken Sie auf das Drop-down-Menü Rolle auswählen und geben Sie die Rolle "Storage-Objekt-Administrator" ein.

    6. Klicken Sie auf Speichern.

Backint-Agent und SAP HANA konfigurieren

Sie konfigurieren den Backint-Agent, indem Sie Parameter in einer Klartext-Konfigurationsdatei angeben.

Sie können dieselbe Konfiguration für alle Sicherungstypen (Daten, Log und Katalog) verwenden oder Sie können für jeden Sicherungstyp eine andere Konfiguration verwenden. Dazu erstellen Sie eine eigene Konfigurationsdatei für die einzelnen Typen.

Sie geben den Pfad zu jeder Backint-Agent-Konfigurationsdatei in SAP HANA an, indem Sie Parameter in der Datei global.ini festlegen.

  1. Konfigurieren Sie den Backint-Agent, indem Sie Parameter in der Datei parameters.txt festlegen. Sie können die Datei nach Bedarf umbenennen.

    1. Verwenden Sie Ihre bevorzugte Methode, um die Datei parameters.txt zu bearbeiten. Die Datei wird im folgenden Verzeichnis installiert.

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

      Sie können die Datei parameters.txt umbenennen und verschiedene Konfigurationsdateien für Daten-, Log- und Katalogsicherungen verwenden.

      Beschreibungen der Konfigurationsparameter sowie Empfehlungen zur Leistung finden Sie unter Konfigurationsoptionen für den Backint-Agent.

    2. Geben Sie den Namen des Cloud Storage-Buckets an, der für die Sicherungen verwendet werden soll.

      #BUCKET bucket-name
      
    3. Wenn Sie ein Dienstkonto und einen privaten Schlüssel für den Backint-Agent erstellt haben, geben Sie den Pfad zur JSON-Schlüsseldatei an.

      #SERVICE_ACCOUNT /path/key-file-name.json

    Das folgende Beispiel zeigt den Inhalt einer gültigen parameters.txt-Datei.

    #BUCKET hana-backups
    #DISABLE_COMPRESSION
    #SERVICE_ACCOUNT /usr/sap/ABC/home/example-project-123456-d591d63bba6f.json
  2. Optional: Konfigurieren Sie den Backint-Agent, um für das Sichern und Wiederherstellen von Daten einen Proxy zu umgehen oder zu verwenden. Standardmäßig umgeht der Backint-Agent HTTP-Proxys.

    Abfragen an den Metadatenserver der Instanz müssen immer den HTTP-Proxyserver umgehen. Verwenden Sie je nach Bedarf den Proxyparameter http oder https.

    Um die Proxyserver-Einstellungen für den Backint-Agent festzulegen, bearbeiten Sie die Datei /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/jre/conf/net.properties.

    Folgende Konfiguration gibt beispielsweise einen HTTPS-Proxy-Server an:

    http.proxyHost=proxy-host
    http.proxyPort=proxy-port
    http.nonProxyHosts=localhost|127.*|[::1]|169.254.169.254|metadata.google.internal
    https.proxyHost=proxy-host
    https.proxyPort=proxy-port
    

    Weitere Informationen zur Verwendung des Backint-Agents mit einem Proxy finden Sie unter Proxys und der Backint-Agent.

  3. Konfigurieren Sie SAP HANA für die Verwendung des Backint-Agents:

    1. Verwenden Sie SAP HANA Studio oder SAP HANA Cockpit, um die folgenden Parameter im Bereich backup der Konfigurationsdatei global.ini auf die in der Tabelle angegebenen Werte zu setzen. Nach diesen Änderungen müssen Sie SAP HANA nicht neu starten.

      Wenn Sie für jede andere Art von Sicherung eine andere Konfigurationsdatei verwenden, geben Sie die verschiedenen Konfigurationsdateien wie in der folgenden Tabelle gezeigt an. Andernfalls geben Sie für alle Typen dieselbe Konfigurationsdatei an.

      Parameter Wert
      catalog_backup_parameter_file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.txt
      catalog_backup_using_backint true
      data_backup_parameter_file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.txt
      log_backup_parameter_file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.txt
      log_backup_using_backint true
    2. Verwenden Sie SAP HANA Studio, um den gleichen Wert sowohl für basepath_catalogbackup als auch für basepath_logbackup im Bereich persistence der Datei global.ini anzugeben. Beispiel:

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

  4. Testen Sie die Installation, indem Sie eine Sicherung im Cloud Storage-Bucket erstellen und aus der Sicherung wiederherstellen.

  5. Damit die automatische Updatefunktion des Backint-Agents unterstützt wird, aktivieren Sie HTTP-Remote-Anfragen von der SAP HANA-VM an https://www.googleapis.com/.

  6. Optional können Sie Cloud Logging aktivieren.

    • Wenn SAP HANA auf einer Compute Engine-VM ausgeführt wird, fügen Sie dem Attribut com.google.cloud.partners.handlers in der Datei /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logging.properties den Handler com.google.cloud.logging.LoggingHandler hinzu.
    • Wenn SAP HANA außerhalb von Google Cloud ausgeführt wird, installieren Sie das Cloud SDK und konfigurieren Sie die Standardanmeldung für Anwendungen mithilfe des Befehls gcloud auth application-default login.

Backint-Agent auf eine neue Version aktualisieren

So aktualisieren Sie den Backint-Agent auf eine neue Version:

  1. Aktivieren Sie Remote-HTTP-Anfragen vom SAP HANA-Host an https://www.googleapis.com/.

  2. Installieren Sie als sidadm auf dem SAP HANA-Host die neue Version:

    curl https://storage.googleapis.com/cloudsapdeploy/backint-gcs/update.sh | bash

Das Skript update.sh führt die folgenden Aktionen aus:

  • Installiert die neue Version des Backint-Agents unter /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
  • Aktualisiert das Skript backint, um die neue Backint-Agent-Version aufzurufen.
  • Aktualisiert die Versionsnummer in VERSION.txt.
  • Speichert das update.sh-Skript lokal unter /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
  • Eine Nachricht wird ausgegeben, wenn der Vorgang abgeschlossen ist.

Durch die Aktualisierung wird Ihre vorhandene Datei parameters.txt weder geändert noch ersetzt. Wenn Sie neue Optionen in der neuen Version verwenden möchten, müssen Sie die entsprechenden Parameter in Ihre vorhandene Datei parameters.txt einfügen.

Im Rahmen des Aktualisierungsprozesses wird die alte Version des Backint-Agents im Verzeichnis /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs belassen. Sie können dann bei Bedarf auf die alte Version zurückgreifen.

Vorherige Version aufrufen

Wenn bei einer neuen Version des Backint-Agents Probleme auftreten und der Support von Google Cloud oder SAP raten, die vorherige Version zu nutzen, können Sie die Skriptdatei backint bearbeiten.

Sie müssen keine Parameter entfernen, die Sie möglicherweise für die neue Version in der Datei parameters.txt hinzugefügt haben. In der vorherigen Version des Backint-Agents werden die Parameter der neueren Version ignoriert.

So wechseln Sie zu einer früheren Version:

  1. Öffnen Sie als sidadm das Skript backint zur Bearbeitung. Beispiele:

    vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/backint
  2. Ändern Sie den Namen der JAR-Datei des Backint-Agents in den Namen der JAR-Datei der vorherigen Version.

    Wenn Sie beispielsweise von Version 1.0.6 wieder auf Version 1.0.4 wechseln, würden Sie Folgendes ändern:

    -jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.6.jar
    An:

    -jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.4.jar

  3. Öffnen Sie die Datei VERSION.txt zur Bearbeitung und geben Sie die vorherige Versionsnummer an. Dies ist erforderlich, damit der Aktualisierungsmechanismus weiß, welche Version Sie ausführen.

    vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/VERSION.txt
  4. Testen Sie den Backint-Agenten. Lösen Sie dazu ein Back-up aus.

Fehlerbehebung

Wenn während der Ausführung einer Sicherung oder einer Wiederherstellung Fehler auftreten, werden in SAP HANA Studio oder SAP HANA Cockpit Fehlermeldungen angezeigt. Prüfen Sie deshalb dort zuerst die Fehlerursache. Diese Informationen werden möglicherweise in den Trace-Dateien backup.log und backint.log angezeigt. Achten Sie darauf, dass Sie den relevanten Datenbanknamen auswählen, wenn mehrinstanzenfähige Datenbankcontainer (MDC) verwendet werden.

Prüfen Sie, ob Sie den Backint-Agent als sidadm-Nutzer installiert haben.

Protokolldateien

Wenn Fehler auftreten, prüfen Sie die folgenden Logs:

  • SAP HANA-backup.log, das Informationen zu Sicherungs- und Wiederherstellungsvorgänge in SAP HANA enthält
  • SAP HANA-backint.log, das die Aufrufe der Sicherungsschnittstelle enthält, die vom Backint-Agent und anderen externen Sicherungstools verwendet wird.
  • Backint-Agent-Logdateien, die die Installation des Backint-Agents und Betriebsereignisse enthalten. Die Backint-Agent-Logdateien befinden sich in /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logs. Die Backint-Agent-Logs können Hinweise auf Kommunikationsfehler mit Cloud Storage und damit verbundene Konfigurations- oder Berechtigungsprobleme enthalten.
  • Die Google Cloud-Logs, die Fehler im Zusammenhang mit dem vom Backint-Agenten verwendeten Dienstkonto enthalten können. Die Google Cloud-Logs finden Sie auf der Seite „Loganzeige“ in der Cloud Console.

Prüfen Sie außerdem die E/A-Informationen zu Laufwerk und Netzwerk auf dem SAP HANA-Host, um die Aktivität zu prüfen.

Weitere Informationen zum Logging des Backint-Agents finden Sie unter Logging für den Backint-Agent.

Verbindungsprobleme

Wenn der Backint-Agent keine Verbindung zum Cloud Storage-Bucket herstellen kann, prüfen Sie die Konfigurationsschritte. Untersuchen Sie insbesondere die folgenden Elemente:

  • Wiederholen Sie die fehlgeschlagene Sicherung, um sicherzugehen, dass der Fehler nicht nur ein vorübergehendes Verbindungsproblem war.
  • Wenn Sie das Dienstkonto der Host-VM mit dem Backint-Agent verwenden, wird der Zugriffsbereich für Speicher auf der Seite mit den VM-Instanzdetails in der Cloud Console unter Zugriffsbereiche für Cloud API als Lesen Schreiben aufgeführt. Ist dies nicht der Fall, stoppen Sie die Instanz und bearbeiten Sie den Zugriffsbereich.
  • Wenn Sie ein Dienstkonto für den Backint-Agent erstellt haben:
    • Bestätigen Sie im Tab Berechtigungen der Bucket-Details-Seite in der Cloud Console, ob das Backint-Agent-Dienstkonto aufgeführt ist und die Storage-Objekt-Administrator Rolle hat.
    • Bestätigen Sie, dass Sie einen privaten Schlüssel erstellt, ihn auf dem SAP HANA-Host gespeichert und den Pfad zur JSON-Schlüsseldatei in der Backint-Agent-Konfigurationsdatei /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt korrekt angegeben haben.
  • Alle Parameter sowohl in der Backint-Agent-Konfigurationsdatei parameters.txt als auch in der SAP HANA-Datei global.ini sind korrekt angegeben.

Sie können den Zugriff auf den Cloud Storage-Bucket vom SAP HANA-Host mit dem Cloud Storage-Tool gsutil testen, das im Cloud SDK enthalten ist. Verwenden Sie das gsutil-Tool, um eine Textdatei im Cloud Storage-Bucket zu speichern und darauf zuzugreifen:

  1. Wenn Sie das Standarddienstkonto nicht verwenden, authentifizieren Sie sich bei Google Cloud als Nutzer, der entweder für den Cloud Storage Bucket oder für das Backint Agent-Dienstkonto autorisiert ist:

    gcloud auth login user-account
    oder:
    gcloud auth activate-service-account --key-file=/path/key-file-name.json
    Weitere Informationen zur Cloud Storage-Authentifizierung eines Dienstkontos finden Sie unter gsutil-Authentifizierung.

  2. Bestätigen Sie, dass Sie die im Bucket gespeicherten Objekte auflisten können:

    gsutil ls gs://bucket/

  3. Erstellen Sie eine Testdatei:

    touch test.txt

  4. Prüfen Sie, ob die Testdatei in den Bucket geschrieben werden kann:

    gsutil cp test.txt gs://bucket/test.txt

  5. Prüfen Sie, ob Sie die Testdatei im Bucket lesen können:

    gsutil cp gs://bucket/test.txt

Niedriger Durchsatz

Ist der Durchsatz niedriger als erwartet, prüfen Sie, ob die Komprimierung deaktiviert ist.

Zur Deaktivierung der Komprimierung fügen Sie der Datei parameters.txt des Backint-Agents das Flag #DISABLE_COMPRESSION hinzu.

Multistreaming-Fehler

Wenn beim Multistreaming Fehler auftreten, ändern Sie die Anzahl der Streams zu eins (1), um zu sehen, ob der Fehler mit der Anzahl der Streams zusammenhängt.

Weitere Informationen zum Logging des Backint-Agents finden Sie unter Multistreaming-Datensicherungen mit dem Backint-Agent.

Support für den Backint-Agent erhalten

Wenn Sie Hilfe bei der Behebung eines Problems mit SAP HANA-Sicherungen benötigen, das den Backint-Agent verwendet, erstellen Sie einen Vorfall im SAP-Vorfallverarbeitungssystem mit der Komponente HAN-DB-BAC (siehe SAP-Hinweis 2705632), um die Option zu aktivieren.

Wenn SAP feststellt, dass die Ursache in der Google Cloud-Software liegt, leitet der SAP-Entwicklungssupport den Vorfall an die Komponente BC-OP-LNX-GOOGLE weiter, die von Google Cloud jederzeit überwacht wird.

Ergänzen Sie die folgenden Diagnoseinformationen mit den Diagnoseinformationen, die im SAP-Hinweis 2705632 angefordert wurden:

  • Relevante Auszüge des /var/log/messages auf dem HANA-System, die etwa zum Zeitpunkt des Problems betroffen waren.
  • Die Dateien backup.log und backint.log für SAP HANA. Sofern das Problem nicht auch bei der SYSTEM-Datenbank auftritt, benötigen Sie die Dateien nur für die Mandantendatenbank.
  • Die Datei parameters.txt des Backint-Agents und die Logdateien im Verzeichnis backint-gcs oder ein Export von Cloud Logging-Logs, sofern Sie Logging aktiviert haben.
  • Die global.ini-Einträge für das Back-up:
    • backint_response_timeout
    • data_backup_buffer_size
    • parallel_data_backup_backint_channels
  • Die Softwareversionen von SAP HANA, des Betriebssystems und des Backint-Agents, die Sie verwenden. Die Version des Backint-Agents ist in der Datei installation.log aufgelistet.
  • Die Größe Ihres Back-ups.
  • Informationen über das IAM-Dienstkonto, mit dem der Backint-Agent auf Cloud Storage zugreift, einschließlich des Kontonamens und der ihm zugewiesenen Rollen.
  • Informationen darüber, ob vorherige Back-up- oder Wiederherstellungsversuche von dieser Host-VM erfolgreich waren.
  • Eine Beschreibung Ihrer SAP HANA-Landschaft, einschließlich der Hosts und ihrer Rollen.

Weitere Informationen von SAP zum Support für SAP HANA finden Sie im Abschnitt "Support erhalten" im Administratorhandbuch für SAP HANA.