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

Diese Anleitungen führen Sie durch die Installation und Konfiguration eines Cloud Storage-Backint-Agents für SAP HANA ("Backint-Agent") auf einer Compute Engine-VM, auf der SAP HANA installiert ist.

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

Vorbereitung

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

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 Sicherungen in Cloud Storage-Buckets speichern.

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

    Cloud Storage-Browser öffnen

  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 Ihrer SAP HANA-VM 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 mithilfe von SSH eine Verbindung zur VM her. Klicken Sie dazu in Compute Engine auf der Seite "VM-Instanzen" auf die SSH-Schaltfläche für Ihre VM-Instanz. Alternativ stellen Sie die Verbindung mit Ihrer bevorzugten SSH-Methode her.

  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 Skript backint nur, wenn Sie vom Google Cloud-Support dazu aufgefordert werden.
    • Es wird eine Fehlermeldung ausgegeben, in der Sie aufgefordert werden, die Datei parameters.txt zu aktualisieren und die Authentifizierung einzurichten.
  4. Wenn SAP HANA nicht in Google Cloud ausgeführt wird oder wenn der Backint-Agent andere Ressourcenberechtigungen als die Host-VM verwenden soll, erstellen Sie ein Dienstkonto für den Backint-Agent.

    1. Öffnen Sie in der Google Cloud Console unter "IAM & Verwaltung" die Seite "Dienstkonten".

      Zur Seite "Dienstkonten"

    2. Klicken Sie auf + DIENSTKONTO ERSTELLEN.

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

    4. Klicken Sie auf ERSTELLEN.

    5. Klicken Sie im Steuerfeld Dienstkontoberechtigungen auf Weiter, um das Dienstkonto ohne Berechtigungen zu erstellen.

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

    7. Klicken Sie auf Fertig.

    8. Klicken Sie in der Cloud Console auf der Seite Dienstkonten auf das Dienstkonto, das Sie gerade erstellt haben.

    9. Klicken Sie auf der Seite Dienstkontodetails unter Schlüssel auf SCHLÜSSEL HINZUFÜGEN > Neuen Schlüssel erstellen, um einen Dienstkontoschlüssel zu erstellen.

    10. 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 sidadm-Nutzer 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. Beispiel:

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

Backint-Agent und SAP HANA konfigurieren

Zum Konfigurieren des Backint-Agents konfigurieren Sie die Datei parameters.txt. SAP HANA wird durch Aktualisieren der Datei global.ini konfiguriert.

  1. Konfigurieren Sie den Backint-Agent.

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

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

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

    2. Fügen Sie in der Datei parameters.txt den Namen des Cloud Storage-Buckets hinzu, 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, fügen Sie den Pfad zur JSON-Schlüsseldatei zu parameters.txt hinzu.

      #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 #SERVICE_ACCOUNT /usr/sap/ABC/home/example-project-123456-d591d63bba6f.json
  2. 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.

      Parameter Wert
      catalog_backup_parameter_file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt
      catalog_backup_using_backint true
      data_backup_parameter_file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt
      log_backup_parameter_file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.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

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

  4. 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/.

  5. Optional können Sie Cloud Logging aktivieren.

    • Wenn SAP HANA auf Google Cloud 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 HTTP-Remoteanfragen 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 in /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 in /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 parameters.txt-Datei 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 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. Beispiel:

    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 auf Version 1.0.4 zurückgreifen, 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-Agent mit einer Sicherung.

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 auf Hinweise auf Kommunikationsfehler bei Cloud Storage hinweisen sowie auf zugehörige Konfigurations- oder Berechtigungsprobleme.
  • Die Google Cloud-Logs, die Fehler im Zusammenhang mit dem vom Backint-Agent verwendeten Dienstkonto enthalten können. Die Google Cloud-Logs finden Sie auf der Seite "Loganzeige" in der Cloud Console.

Prüfen Sie auch die E/A-Informationen zu Laufwerk und Netzwerk auf der Host-VM, 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, ist der Zugriffsbereich für Speicherplatz aufgeführt als Lesen/Schreiben unter Zugriffsbereiche für Cloud API im VM-Instanzdetails in der Cloud Console. 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 der SAP HANA-VM 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 nicht das Standarddienstkonto verwenden, müssen Sie sich bei Google Cloud als Nutzer authentifizieren, der für den Cloud Storage-Bucket oder 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.

Multi-Stream-Sicherungen gelten außerdem nur für Datensicherungen, die größer als 128 GB sind.

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

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, das von der Zeit des Problems betroffen ist.
  • Die Dateien backup.log und backint.log für SAP HANA. Sofern das Problem auch mit 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 die Sicherung:
    • 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 Ihrer Sicherung.
  • Informationen über das IAM-Dienstkonto, das der Backint-Agent für den Zugriff auf Cloud Storage verwendet.
  • Informationen darüber, ob vorherige Sicherungs- oder Wiederherstellungsversuche von dieser Host-VM erfolgreich waren.

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