Dépanner l'agent Backint pour SAP HANA

Si des erreurs surviennent lors d'une sauvegarde ou d'une récupération, les messages d'erreur s'affichent dans SAP HANA Studio ou SAP HANA Cockpit. Ces informations peuvent également s'afficher dans les fichiers de suivi backup.log et backint.log. Si vous utilisez des conteneurs de base de données à architecture mutualisée, veillez à bien sélectionner le nom de la base de données appropriée.

Assurez-vous d'avoir installé l'agent Backint en tant qu'utilisateur sidadm.

Fichiers journaux

Si des erreurs se produisent, consultez les journaux suivants :

  • SAP HANA backup.log, qui contient des informations sur les opérations de sauvegarde et de récupération SAP HANA.
  • SAP HANA backint.log, qui contient les appels à l'interface de sauvegarde utilisée par l'agent Backint et d'autres outils de sauvegarde externe.
  • Des fichiers journaux de l'agent Backint, qui contiennent l'installation de l'agent Backint et des événements opérationnels. Les fichiers journaux de l'agent Backint se trouvent dans /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logs. Les journaux de l'agent Backint peuvent inclure des indications des erreurs de communication avec Cloud Storage, et des problèmes de configuration ou d'autorisation associés.
  • Les journaux Google Cloud, qui peuvent contenir des erreurs liées au compte de service utilisé par l'agent Backint. Pour consulter les journaux Google Cloud, consultez la page Visionneuse de journaux dans la console Google Cloud.

Vérifiez également les informations relatives aux E/S du disque et du réseau sur l'hôte SAP HANA pour vérifier l'activité.

Pour en savoir plus sur la journalisation pour l'agent Backint, consultez la section Journalisation pour l'agent Backint.

Problèmes de connectivité

Si l'agent Backint ne parvient pas à se connecter au bucket Cloud Storage, examinez les étapes de configuration. Vérifiez notamment les éléments suivants :

  • Effectuez une nouvelle tentative de sauvegarde ou de restauration pour vous assurer que l'erreur n'est pas simplement un problème de connectivité passager.
  • Si vous utilisez le compte de service de la VM hôte avec l'agent Backint, le niveau d'accès à Storage est répertorié sous Lecture/Écriture, sous niveaux d'accès des API Cloud, sur la page Informations sur l'instance de VM de la console Google Cloud. Si ce n'est pas le cas, arrêtez l'instance et modifiez le niveau d'accès.
  • Si vous avez créé un compte de service pour l'agent Backint :
    • Sur l'onglet Autorisations de la page Détails du bucket dans la console Google Cloud, vérifiez que le compte de service de l'agent Backint est répertorié et qu'il dispose du rôle Administrateur des objets Storage.
    • Vérifiez que vous avez créé une clé privée, que vous l'avez stockée sur l'hôte SAP HANA et que vous avez correctement spécifié le chemin d'accès au fichier de clé JSON dans le fichier de configuration de l'agent Backint, /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt.
  • Tous les paramètres sont correctement spécifiés dans le fichier de configuration parameters.txt de l'agent Backint et dans le fichier SAP HANA global.ini.

Vous pouvez tester l'accès au bucket Cloud Storage à partir de l'hôte SAP HANA à l'aide de la Google Cloud CLI. À l'aide de gcloud CLI, enregistrez et accédez à un fichier texte sur le bucket Cloud Storage:

  1. Si vous n'utilisez pas le compte de service par défaut, authentifiez-vous auprès de Google Cloud en tant qu'utilisateur autorisé au bucket Cloud Storage ou au compte de service de l'agent Backint :

    gcloud auth login user-account
    Ou:
    gcloud auth activate-service-account --key-file=/path/key-file-name.json
    Pour en savoir plus sur l'authentification Cloud Storage d'un compte de service, consultez la page Authentification gcloud CLI.

  2. Confirmez que vous pouvez répertorier les objets stockés dans le bucket :

    gcloud storage ls gs://bucket/

  3. Créez un fichier de test :

    touch test.txt

  4. Vérifiez que vous pouvez écrire le fichier de test dans le bucket :

    gcloud storage cp test.txt gs://bucket/test.txt

  5. Vérifiez que vous pouvez lire le fichier de test dans le bucket :

    gcloud storage cp gs://bucket/test.txt

Débit faible

Si votre débit est inférieur à celui attendu, vérifiez que la compression est désactivée.

Pour désactiver la compression, ajoutez l'option #DISABLE_COMPRESSION au fichier parameters.txt de l'agent Backint.

Erreurs de multistreaming

Si vous obtenez des erreurs lors du multistreaming, remplacez le nombre de flux par un (1) pour voir si l'erreur est liée au nombre de flux.

Pour en savoir plus sur la journalisation de l'agent Backint, consultez la section Multistreaming des sauvegardes de données avec l'agent Backint.