Fehlerbehebung für Backint-Agent für SAP HANA

Wenn während der Ausführung einer Sicherung oder einer Wiederherstellung Fehler auftreten, werden in SAP HANA Studio oder SAP HANA Cockpit Fehlermeldungen angezeigt. Überprü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 „Log-Explorer“ in der Google 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 Google 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 Google Cloud Console, ob das Backint-Agent-Dienstkonto aufgeführt ist und die Rolle Storage-Objekt-Administrator 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 in der Google Cloud CLI 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.