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

Wichtig: Wir empfehlen für neue Installationen anstelle des Cloud Storage Backint-Agents für SAP HANA deren Nachfolger – Google Cloud Agent für SAP. Ab Version 3.0 kombiniert der Google Cloud-Agent für SAP die Erfassung von SAP-Host-Agent-Messwerten mit anderen Features wie der Backint-basierten Sicherung und Wiederherstellung für SAP HANA.

Wenn Sie den Backint-Agent verwenden, empfehlen wir, so bald wie möglich zu Version 3.6 (aktuell) des Google Cloud-Agents für SAP zu wechseln, jedoch bevor der Support für den Backint-Agent eingestellt wird. Upgrade-Anleitungen finden Sie unter Upgrade auf den Google Cloud-Agent für SAP von anderen Google Cloud-Agents.

Der Backint-Agent wird im Februar 2025 nicht mehr unterstützt. Dieser Agent wird nicht auf Compute Engine-Maschinentypen unterstützt, die nach Februar 2024 allgemein verfügbar wurden.

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.

Hinweis: Wenn Sie den Backint-Agent auf einem Host installieren müssen, der weder eine Compute Engine-VM noch eine Bare-Metal-Lösung Bare-Metal-Maschine ist, erstellen Sie einen Vorfall mit SAP-Unterstützung in der Komponente BC-OP-LNX-GOOGLE, damit SAP und Google Cloud Ihre Konfiguration auswerten können.

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 Google 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 Google 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.

   Hinweis: Die Verschlüsselungsoptionen, die während der Bucket-Erstellung in der Google Cloud Console angezeigt werden, gelten im Allgemeinen für inaktive Objekte im Bucket. Der Backint-Agent bietet zusätzliche Verschlüsselungsoptionen für Ihre Sicherungen, die von den Bucket-Verschlüsselungsoptionen unabhängig sind.

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 Hauptkonten den 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 - SID_LCadm
   

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

   curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/install.sh
   chmod +x install.sh
   ./install.sh
   

   Hinweis: Wenn Sie eine vorhandene Instanz des Backint-Agents auf eine neue Version aktualisieren, folgen Sie der Anleitung unter Backint-Agent auf eine neue Version aktualisieren.

   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-Script nur, wenn Sie von Cloud Customer Care 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 Google 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 Google Cloud Console auf der Seite Dienstkonten auf die E-Mail-Adresse des gerade erstellten Dienstkontos.

   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 SID_LCadm-Nutzer zugreifen kann, z. B. /usr/sap/SID/home.
   • Prüfen Sie, ob der Nutzer SID_LCadm 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 Hauptkonten hinzufügen.

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

      [e-mail]

   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. Beachten Sie, dass die Datei # in diesem Beispiel Teil der Syntax ist und nicht bedeutet, dass die Zeile ein Kommentar ist.

   #BUCKET hana-backups
   #DISABLE_COMPRESSION
   #SERVICE_ACCOUNT /usr/sap/ABC/home/example-project-123456-d591d63bba6f.json

2. Optional: Konfigurieren Sie den Backint-Agent so, dass er einen Proxy für Sicherungen und Wiederherstellungen umgeht oder verwendet. Standardmäßig umgeht Backint-Agent HTTP-Proxys.

   Warnung: Das Routing von Back-ups über einen Proxy wirkt sich negativ auf die Leistung und Zuverlässigkeit des gesamten Proxy-Traffics beim Senden oder Abrufen von Back-ups aus Cloud Storage aus. Google Cloud empfiehlt dringend eine Konfiguration, bei der der Backint-Agent HTTP-Proxys umgeht.

   Abfragen an den Metadatenserver der Instanz müssen immer den HTTP-Proxyserver umgehen. Verwenden Sie entweder die http- oder https-Proxyparameter, je nach Erfordernis durch Ihren Proxyserver.

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

   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:

      

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 die Google Cloud CLI und konfigurieren Sie die Standardanmeldung für Anwendungen mithilfe des Befehls gcloud auth application-default login.

Backint-Agent auf eine neue Version aktualisieren

Testen Sie die neue Version in einer Nicht-Produktionsumgebung, bevor Sie den Backint-Agent auf eine neue Version in Ihrer Produktionsumgebung aktualisieren. Informationen zu den Versionen eines Backint-Agents finden Sie in den Versionshinweisen für diese Version.

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

1. Achten Sie darauf, dass für den Zeitraum, der sich mit dem Update überschneidet, keine Datensicherungen ausgeführt werden oder geplant sind.

2. Deaktivieren Sie automatische Logsicherungen. Setzen Sie dazu den Parameter enable_auto_log_backup von SAP HANA auf no. Eine Anleitung hierzu finden Sie im SAP HANA-Dokument Automatische Logsicherung aktivieren und deaktivieren.

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

4. Installieren Sie als SID_LCadm auf dem SAP HANA-Host die neue Version:

   curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/update.sh
   chmod +x update.sh
   ./update.sh

   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 frühere 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 frühere Version zurückgreifen.

5. Aktivieren Sie automatische Logsicherungen. Setzen Sie dazu den Parameter enable_auto_log_backup von SAP HANA auf yes. Eine Anleitung hierzu finden Sie im SAP HANA-Dokument Automatische Logsicherung aktivieren und deaktivieren.

6. Überwachen Sie Ihr System auf erfolgreiche Sicherungen.

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 SID_LCadm 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 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

   zu:

   -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

Informationen zur Fehlerbehebung bei Problemen mit dem Backint-Agent für SAP HANA finden Sie unter Fehlerbehebung beim Backint-Agent für SAP HANA.

Support für den Backint-Agent erhalten

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