--- title: "Utiliser OVHcloud Backint Agent avec plusieurs buckets Object Storage" description: "Ce guide fournit des instructions générales pour utiliser OVHcloud Backint Agent pour SAP HANA avec plusieurs buckets Object Storage" url: https://docs.ovhcloud.com/fr/guides/hosted-private-cloud/sap-on-ovhcloud/hana-use-ovhcloud-backint-agent-several-buckets lang: fr lastUpdated: 2024-09-03 --- # Utiliser OVHcloud Backint Agent avec plusieurs buckets Object Storage ## Objectif Ce guide vous détaille les étapes pour utiliser OVHcloud Backint Agent pour SAP HANA avec plusieurs buckets Object Storage. OVHcloud Backint Agent pour SAP HANA vous permet de sauvegarder et de restaurer votre base de données SAP HANA sur un ou plusieurs buckets Object Storage OVHcloud. Utiliser plusieurs buckets Object Storage peut être notamment utile pour : - séparer les sauvegardes de données dites `databackup` des sauvegardes de fichiers de logs dites `log_backup` ; - stocker sur des buckets Object Storage ayant des besoins de rétention différents ; - utiliser des régions différentes. ![two_buckets](/images/hosted-private-cloud/sap-on-ovhcloud/cookbook-configure-ovhcloud-backint-agent-several-buckets/two_buckets.png) OVHcloud Backint Agent pour SAP HANA a été certifié par SAP, vous pouvez retrouver les informations de la certification à ces adresses : - [SAP Certified Solutions Directory](https://www.sap.com/dmc/exp/sap-certified-solutions/#/solutions?filters=v:1108\&id=s:c5927e8a-cf79-40c1-84ad-cdd354554389) - [SAP Note 2031547](https://me.sap.com/notes/0002031547) - [SAP Note 3344150](https://me.sap.com/notes/3344150) *** ### Accès à l'espace client OVHcloud - **Lien direct :** [Projets Public Cloud](https://manager.eu.ovhcloud.com/#/public-cloud/pci/projects) - **Pour accéder à vos services :** Public Cloud > Sélectionnez votre projet *** ## Prérequis - Être connecté à l’espace client OVHcloud. - [Un projet Public Cloud](/fr/guides/public-cloud/cross-functional/create-a-public-cloud-project.md) dans votre compte OVHcloud avec : - [Deux buckets Object Storage](/fr/guides/storage-and-backup/object-storage/s3-getting-started-with-object-storage.md) et [un utilisateur Object Storage](/fr/guides/storage-and-backup/object-storage/s3-identity-and-access-management.md#creation-dun-utilsateur) avec le droit de lecture et d'écriture. - Une base de données SAP HANA installée. - [OVHcloud Backint Agent pour SAP HANA installé](/fr/guides/hosted-private-cloud/sap-on-ovhcloud/cookbook-install-ovhcloud-backint-agent.md). ## En pratique ### Object Storage Le versioning du bucket Object Storage doit être activé afin d'assurer le bon fonctionnement d'OVHcloud Backint Agent. Le versioning permet de garder plusieurs versions d'un même objet dans votre bucket Object Storage. Dans le cas des sauvegardes SAP HANA, le versioning vous permet de réaliser plusieurs sauvegardes avec le même nom (comme par exemple « COMPLETE\_DATA\_BACKUP ») et de garder la possibilité de restaurer une version spécifique de la sauvegarde « COMPLETE\_DATA\_BACKUP ». Si le versioning n'est pas activé, seule la dernière version de la sauvegarde « COMPLETE\_DATA\_BACKUP » peut être restaurée. Vous pouvez vérifier le statut du versioning de votre bucket Object Storage en suivant ces étapes : 1. Accédez à l'espace client OVHcloud. 2. Cliquez sur l'univers Public Cloud et sélectionnez votre projet Public Cloud. Puis cliquez sur Object Storage. 3. Cliquez sur les buckets Object Storage qui accueilleront les sauvegardes de votre base de données SAP HANA. 4. Vérifiez la valeur du paramètre Versioning, ce dernier doit avoir pour valeur Activé. Si la valeur de ce paramètre est Désactivé, cliquez sur Activer le versioning. | Versioning activé | Versioning désactivé | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | versioning_enabled | versioning_disabled | ### Configuration Éditez le contenu du fichier `hdbbackint.cfg` et remplacez les valeurs entre chevrons par les informations liées à votre premier bucket Object Storage. Ci-dessous, un exemple de son contenu. ```ini [trace] default = INFO destination = outputfile [ovhcloud] endpoint_url = https://s3.rbx.io.cloud.ovh.net bucket = mon-bucket-sap-hana-data region = rbx access_key = 12345678901234567890123456789012 secret_key = 12345678901234567890123456789012 max_concurrency = 10 multipart_chunksize = 1GB multipart_threshold = 1GB ``` Les paramètres `multipart_chunksize` et `multipart_threshold` acceptent les valeurs en bytes (exemple : 52428800 équivaut à 50MB), en KB, en GB et en TB. Si l'unité de mesure n'est pas indiquée, l'unité par défaut est le byte. - Le paramètre `multipart_threshold` permet le déclenchement de l'envoi de l'objet en plusieurs parties (multipart). - Le paramètre `multipart_chunksize` spécifie la taille des parties de l'objet à envoyer. Les valeurs fournies par défaut des paramètres `multipart_chunksize` et `multipart_threshold` dans le fichier `hdbbackint.cfg` offrent une performance optimale dans de nombreux cas, mais elles peuvent être augmentées ou diminuées en fonction de votre environnement. Copiez le fichier `hdbbackint.cfg` sous un autre nom, par exemple `hdbbackint-log.cfg`, et remplacez les paramètres par les informations de votre second bucket Object Storage. ```ini [trace] default = INFO destination = outputfile [ovhcloud] endpoint_url = https://s3.rbx.io.cloud.ovh.net bucket = mon-bucket-sap-hana-log region = rbx access_key = 12345678901234567890123456789012 secret_key = 12345678901234567890123456789012 max_concurrency = 10 multipart_chunksize = 1GB multipart_threshold = 1GB ``` :::warning Les commandes qui vont suivre vont modifier la configuration de sauvegarde de votre base de données SAP HANA, veillez à exécuter ces commandes avec précaution. Il est également conseillé de réaliser une sauvegarde complète de votre base de données SAP HANA après la modification de la configuration, dans le but de valider cette dernière. ::: Veuillez exécuter ces commandes SQL suivante afin de mettre à jour la configuration de sauvegarde de votre base de données SAP HANA. _Remplacez, dans les commandes SQL ci-dessous, les caractères_ `` _par le SID de votre base de données SAP HANA._ ```sql ALTER SYSTEM ALTER CONFIGURATION('global.ini','SYSTEM') SET('backup','catalog_backup_parameter_file')='/usr/sap//SYS/global/hdb/opt/hdbbackint.cfg' WITH RECONFIGURE; ALTER SYSTEM ALTER CONFIGURATION('global.ini','SYSTEM') SET('backup','catalog_backup_using_backint')='true' WITH RECONFIGURE; ALTER SYSTEM ALTER CONFIGURATION('global.ini','SYSTEM') SET('backup','data_backup_parameter_file')='/usr/sap//SYS/global/hdb/opt/hdbbackint.cfg' WITH RECONFIGURE; ALTER SYSTEM ALTER CONFIGURATION('global.ini','SYSTEM') SET('backup','log_backup_parameter_file')='/usr/sap//SYS/global/hdb/opt/hdbbackint-log.cfg' WITH RECONFIGURE; ALTER SYSTEM ALTER CONFIGURATION('global.ini','SYSTEM') SET('backup','log_backup_using_backint')='true' WITH RECONFIGURE; ``` :::info Pour connaître l'exhaustivité des paramètres liés à la sauvegarde SAP HANA, nous vous recommandons la [documentation SAP](https://help.sap.com/docs/SAP_HANA_PLATFORM/009e68bc5f3c440cb31823a3ec4bb95b/e28fbdf1024c40e1a97fca48380aad98.html?locale=en-US). Dans la colonne « Section », indiquez « Backup ». ::: ### Sauvegarde Afin de valider les fichiers de configuration précédemment créés, vous pouvez réaliser des sauvegardes manuelles depuis un accès SSH, via les commandes suivantes : _Remplacez, dans les commandes ci-dessous, les caractères_ `` _par le SID de votre base de données SAP HANA et les caractères_ `` _par le numéro d'instance de votre base de données SAP HANA._ ```bash # Sauvegarde du SYSTEMDB /usr/sap//HDB/exe/hdbsql -u SYSTEM -d SYSTEMDB "BACKUP DATA USING BACKINT ('MANUAL_COMPLETE_BACKUP');" # Sauvegarde du TENANTDB /usr/sap//HDB/exe/hdbsql -u SYSTEM -d SYSTEMDB "BACKUP DATA FOR USING BACKINT ('MANUAL_COMPLETE_BACKUP');" ``` Vous pouvez également réaliser ces sauvegardes via SAP HANA Cockpit, en sélectionnant `Backint ` dans la catégorie `Destination Type `. ![backup_hana_cockpit](/images/hosted-private-cloud/sap-on-ovhcloud/cookbook-configure-ovhcloud-backint-agent-several-buckets/backup_hana_cockpit.png) Suite à la réalisation de ces sauvegardes, plusieurs fichiers nommés `_databackup_` sont présents sur votre premier bucket Object Storage, ils correspondent aux sauvegardes de votre base de données SAP HANA via OVHcloud Backint Agent. Deux fichiers nommés `log_backup_0_0_0_0` ayant pour préfixe `DB_` et `SYSTEMDB` se trouvent également dans votre premier bucket Object Storage. Ces fichiers correspondent aux sauvegardes du catalogue de sauvegardes SAP HANA, vous permettant de lister les sauvegardes connues par SAP HANA. ![bucket_data_backup](/images/hosted-private-cloud/sap-on-ovhcloud/cookbook-configure-ovhcloud-backint-agent-several-buckets/bucket_data_backup.png) Dans votre second bucket Object Storage, sont présents les fichiers nommés `log_backup` qui correspondent aux sauvegardes des fichiers de logs. ![bucket_log_backup](/images/hosted-private-cloud/sap-on-ovhcloud/cookbook-configure-ovhcloud-backint-agent-several-buckets/bucket_log_backup.png) Si les sauvegardes ne sont pas effectuées comme attendu, vous avez la possibilité de démarrer votre diagnostic en étudiant le contenu de deux fichiers : - backint.log - backup.log Ces deux fichiers se trouvent dans le répertoire `/usr/sap//HDB//trace` pour la sauvegarde du SYSTEMDB et dans le répertoire `/usr/sap//HDB//trace/DB_` pour la sauvegarde du TENANTDB. Le fichier `backint.log` vous apportera des informations relatives à l'exécution d'OVHcloud Backint Agent, comme un problème de permissions sur le bucket Object Storage par exemple : ```log 2024-02-08 14:10:41.266 backint started: command: /usr/sap/HDB/SYS/global/hdb/opt/hdbbackint -f backup -p /usr/sap/HDB/SYS/global/hdb/opt/hdbbackint.cfg -i /var/tmp/hdbbackint_HDB.kwu3jY -o /var/tmp/hdbbackint_HDB.N1KX90 -u HDB -s 1707397841205 -c 2 -l COMPLETE pid: 3702 input: #SOFTWAREID "backint 1.04" "HANA HDB server 2.00.071.00.1687900751" #PIPE "/usr/sap/HDB/SYS/global/hdb/backint/SYSTEMDB/FULL_BACKUP_databackup_0_1" 2024-02-08 14:10:41.967 backint terminated: pid: 3702 exit code: 1 output: exception: exception 1: no.110507 (Backup/Destination/Backint/impl/BackupDestBackint_Executor.cpp:250) Backint exited with exit code 1 instead of 0. console output: Bucket information error in hdbbackint.cfg - 403 Forbidden ``` Le fichier `backup.log` vous apportera des informations relatives à l'exécution même de la sauvegarde à travers SAP HANA, sa progression et ses erreurs rencontrées. ```log INFO BACKUP state of service: nameserver, :30001, volume: 0, BackupExecuteTopologyAndSSFSBackupInProgress INFO BACKUP state of service: nameserver, :30001, volume: 0, BackupError INFO BACKUP state of service: nameserver, :30001, volume: 1, BackupAbortSavepointInProgress INFO BACKUP state of service: nameserver, :30001, volume: 1, BackupAbortSavepointFinished ERROR BACKUP SAVE DATA finished with error: [447] backup could not be completed ``` Vous pouvez créer et utiliser plusieurs buckets Object Storage pour y appliquer des paramètres supplémentaires comme une politique de rétention ou encore la gestion de l'immutabilité. ### Planification Pour la planification de vos sauvegardes SAP HANA, veuillez vous référer à notre guide [Installer et utiliser OVHcloud Backint Agent pour SAP HANA](/fr/guides/hosted-private-cloud/sap-on-ovhcloud/cookbook-install-ovhcloud-backint-agent.md#planification). ### Restauration Pour la restauration de votre base de données SAP HANA, veuillez vous référer à notre guide [Installer et utiliser OVHcloud Backint Agent pour SAP HANA](/fr/guides/hosted-private-cloud/sap-on-ovhcloud/cookbook-install-ovhcloud-backint-agent.md#restauration). Les étapes sont identiques, même si vous utilisez des buckets Object Storage différents pour vos sauvegardes `DATA` et `LOG`. ## Aller plus loin Afin d'améliorer la sécurité de vos sauvegardes, nous vous conseillons de mettre en place la [gestion de l'immutabilité](/fr/guides/storage-and-backup/object-storage/s3-managing-object-lock.md). Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur [ce lien](https://www.ovhcloud.com/fr/professional-services/) pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services. Échangez avec notre [communauté d'utilisateurs](https://community.ovhcloud.com/community/fr).