Dépanner l'agent Backint pour SAP HANA

Important : Pour les nouvelles installations, au lieu d'utiliser l'agent Backint de Cloud Storage pour SAP HANA, nous vous recommandons d'utiliser son successeur, l'agent Google Cloud pour SAP. À partir de la version 3.0, l'agent Google Cloud pour SAP combine la collecte de métriques de l'agent hôte SAP avec d'autres fonctionnalités, telles que la sauvegarde et la récupération basées sur Backint pour SAP HANA.

Si vous utilisez l'agent Backint, nous vous recommandons de passer à la version 3.2 (la plus récente) de l'agent Google Cloud pour SAP dès que possible, et avant l'arrêt de la compatibilité de l'agent Backint. Pour obtenir des instructions de mise à niveau, consultez Passer à l'agent Google Cloud pour SAP à partir d'autres agents Google Cloud.

La compatibilité de Backint ne sera plus assurée à compter de février 2025. Cet agent n'est pas compatible avec les types de machines Compute Engine accessibles à tous depuis février 2024.

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 l'outil Cloud Storage gsutil fourni avec le Google Cloud CLI. À l'aide de l'outil gsutil, enregistrez et accédez à un fichier texte sur le bucket Cloud Storage :

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 gsutil.
Confirmez que vous pouvez répertorier les objets stockés dans le bucket :
```
gsutil ls gs://bucket/
```
Créez un fichier de test :
```
touch test.txt
```
Vérifiez que vous pouvez écrire le fichier de test dans le bucket :
```
gsutil cp test.txt gs://bucket/test.txt
```
Vérifiez que vous pouvez lire le fichier de test dans le bucket :
```
gsutil 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.