---
title: "Installer et utiliser OVHcloud Backint Agent pour SAP HANA"
description: "Ce guide fournit des instructions générales pour l'installation d'OVHcloud Backint Agent pour SAP HANA et son utilisation"
url: https://docs.ovhcloud.com/fr/guides/hosted-private-cloud/sap-on-ovhcloud/cookbook-install-ovhcloud-backint-agent
lang: fr
lastUpdated: 2024-09-03
---
# Installer et utiliser OVHcloud Backint Agent pour SAP HANA
## Objectif
Ce guide vous détaille les étapes d'installation d'OVHcloud Backint Agent pour SAP HANA et son utilisation.
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.
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?search=backint\&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 :
- [un bucket Object Storage](/fr/guides/storage-and-backup/object-storage/s3-getting-started-with-object-storage.md) ;
- [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.
## En pratique
:::info
[**Accès rapide à l'URL de téléchargement d'OVHcloud Backint Agent**](#ovhcloud-backint-agent-pour-sap-hana)
:::
### 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 le bucket Object Storage qui accueillera 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é |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 
| 
|
### OVHcloud Backint Agent pour SAP HANA
Depuis votre serveur hébergeant la base de données SAP HANA, accédez au répertoire `/usr/sap//SYS/global/hdb/opt/` et [téléchargez l'archive d'OVHcloud Backint Agent pour SAP HANA](https://ovhcloud-backint-agent.s3.rbx.io.cloud.ovh.net/ovhcloud-backint-agent.zip) contenant :
- la licence d'utilisation d'OVHcloud Backint Agent pour SAP HANA
- le fichier NOTICE incluant les copyrights
- le fichier VERSION
- un modèle de fichier de configuration
- l'exécutable d'OVHcloud Backint Agent pour SAP HANA
Pour télécharger l'archive, vous pouvez utiliser la commande suivante :
```bash
wget https://ovhcloud-backint-agent.s3.rbx.io.cloud.ovh.net/ovhcloud-backint-agent.zip -P /usr/sap//SYS/global/hdb/opt/
```
L'archive `ovhcloud-backint-agent.zip` doit être décompressée, vous pouvez utiliser la commande suivante :
```bash
unzip /usr/sap//SYS/global/hdb/opt/ovhcloud-backint-agent.zip -d /usr/sap//SYS/global/hdb/opt/
```
À présent, cinq fichiers sont présents dans le répertoire `/usr/sap//SYS/global/hdb/opt/` :
- LICENSE
- NOTICE
- VERSION
- hdbbackint.cfg
- hdbbackint
:::info
Veuillez prendre connaissance du contenu du fichier LICENSE. En utilisant ou en téléchargeant OVHcloud Backint Agent pour SAP HANA, vous acceptez les termes de la licence.
:::
Le fichier `hdbbackint.cfg` doit posséder les droits de lecture et d'écriture, le fichier `hdbbackint` doit posséder les droits de lecture et d'exécution. Ces droits doivent s'appliquer à l'utilisateur SAP HANA (sid)adm.
```bash
chown adm:sapsys /usr/sap//SYS/global/hdb/opt/hdbbackint.cfg
chown adm:sapsys /usr/sap//SYS/global/hdb/opt/hdbbackint
chmod 600 /usr/sap//SYS/global/hdb/opt/hdbbackint.cfg
chmod 500 /usr/sap//SYS/global/hdb/opt/hdbbackint
```
Vérifiez que vous pouvez exécuter OVHcloud Backint Agent avec l'utilisateur SAP HANA.
```bash
su - adm -c "/usr/sap//SYS/global/hdb/opt/hdbbackint -v"
```
Sortie attendue :
```console
"Backint 1.04" "OVHcloud Backint Agent version 1.0 for SAP HANA"
```
### Configuration
Éditez le contenu du fichier `hdbbackint.cfg` et remplacez les valeurs entre chevrons par les informations liées à votre bucket Object Storage. Ci-dessous, un exemple de son contenu après édition.
```ini
[trace]
default = INFO
destination = outputfile
[ovhcloud]
endpoint_url = https://s3.rbx.io.cloud.ovh.net
bucket = mon-bucket-sap-hana
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.
:::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 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.cfg' WITH RECONFIGURE;
ALTER SYSTEM ALTER CONFIGURATION('global.ini','SYSTEM') SET('backup','log_backup_using_backint')='true' WITH RECONFIGURE;
```
Si votre base de données SAP HANA a une taille supérieure à 128GB, il est possible d'optimiser les performances de sauvegarde et de restauration en activant le multi-streaming. Pour cela, veuillez exécuter les commandes SQL suivantes :
```sql
ALTER SYSTEM ALTER CONFIGURATION('global.ini','SYSTEM') SET('backup','parallel_data_backup_backint_channels')='4' WITH RECONFIGURE COMMENT 'SAP NOTE 2458043';
ALTER SYSTEM ALTER CONFIGURATION('global.ini','SYSTEM') SET('backup','data_backup_buffer_size')='2048' WITH RECONFIGURE COMMENT 'SAP NOTE 2458043';
```
La valeur du paramètre `data_backup_buffer_size` est dépendante de celle du paramètre `parallel_data_backup_backint_channels`.\
Sa valeur est le résultat de l'opération « 512 x `parallel_data_backup_backint_channels` ».
:::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 la configuration, 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
`.
Suite à la réalisation de ces sauvegardes, plusieurs fichiers nommés `_databackup_` sont présents sur votre 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 bucket Object Storage. Ces fichiers correspondent aux sauvegardes du catalogue de sauvegardes SAP HANA, vous permettant de lister les sauvegardes connues par SAP HANA.
Les fichiers nommés `log_backup` correspondent aux sauvegardes des fichiers de logs de SAP HANA.
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 par exemple un problème de permissions sur le bucket Object Storage :
```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
```
### Planification
La planification de vos sauvegardes de votre base de données SAP HANA doit être modifiée.
Nous vous conseillons de vous référer à la SAP Note [2782059](https://launchpad.support.sap.com/#/notes/2782059), qui présente quatre options pour planifier les sauvegardes sur une base de données SAP HANA.
Voici un exemple de planification quotidienne de sauvegardes du TENANTDB SAP HANA via SAP HANA Cockpit :
1. Sélectionnez le TENANTDB sur lequel vous souhaitez planifier les sauvegardes. Cliquez sur `\+
` pour ajouter une planification.
2. Sélectionnez l'option `Schedule a Series of Backups
`.
3\. Donnez un nom à votre planification.
4. Sélectionnez l'option `Complete
` puis `Backint
`. Vous avez la possibilité de configurer un préfixe à vos sauvegardes. Par défaut, la date et l'heure sont préfixées.
5. Sélectionnez l'option `Weekly
`.
6\. Sélectionnez votre fuseau horaire, l'heure du déclenchement de votre sauvegarde et les jours de déclenchement. Dans cet exemple de sauvegardes quotidiennes, nous cochons tous les jours de la semaine.
7\. Veuillez vérifier les paramètres de votre planification avant de valider.
8\. La planification quotidienne est à présent opérationnelle pour votre TENANTDB.
Retrouvez ci-dessous la même planification quotidienne de sauvegardes du TENANTDB SAP HANA via crontab :
_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 complète du TENANTDB - Tous les jours
30 1 * * * /usr/sap//HDB/exe/hdbsql -U BACKUP "BACKUP DATA FOR USING BACKINT ('$(date +\%d\%m\%Y_\%H\%M\%S\%s)_COMPLETE_BACKUP');"
```
:::info
L'option `-U` permet d'appeler une clé stockée dans le hdbuserstore. Pour en savoir plus sur l'ajout d'une clé dans le hdbuserstore, nous vous invitons à prendre connaissance de la documentation SAP disponible à [cette adresse](https://help.sap.com/docs/SAP_HANA_PLATFORM/b3ee5778bc2e4a089d3299b82ec762a7/ddbdd66b632d4fe7b3c2e0e6e341e222.html?version=2.0.02\&locale=en-US).
Dans cet exemple, la clé `BACKUP` a été créée contenant le couple identifiant / mot de passe d'un utilisateur sur la base de données SAP HANA ayant le rôle de sauvegarde. La liste des rôles devant être associés à cet utilisateur est disponible à [cette adresse](https://help.sap.com/docs/SAP_HANA_PLATFORM/6b94445c94ae495c83a19646e7c3fd56/c4b71703bb571014810ebb38dc59cf51.html).
:::
### Restauration
Pour restaurer de votre base de données SAP HANA depuis une sauvegarde réalisée avec OVHcloud Backint Agent, vous pouvez réaliser les étapes suivantes depuis SAP HANA Cockpit :
1. Dans l'onglet `Database Management
`, sélectionnez votre TENANTDB. Cliquez sur `Tenant Actions
` puis sélectionnez `Recover Tenant
`.
2\. Le TENANTDB doit être éteint pour réaliser sa restauration.
Veillez à arrêter votre système SAP lié à cette base de données SAP HANA avant de démarrer la restauration.
3\. Sélectionnez l'option souhaitée :
- Data and logs backups vous permet de revenir à une date et une heure précise.
- Full data backup only vous permet de revenir à un état d'une sauvegarde complète.
Dans notre exemple, nous choisissons l'option `Data and logs backups
`.
4. Si vous avez sélectionné l'option précédente `Data and logs backups
`, vous avez deux possibilités :
- Recover to the most recent state vous permet de revenir à l'état le plus récent possible.
- Recover to a specific point in time vous permet de revenir à une date et une heure précise.
Dans notre exemple, nous choisissons l'option `Recover to the most recent state
`.
5. Si vous n'avez pas modifié la localisation du catalogue de sauvegardes, l'option `Backint location only
` est correcte.
Dans le cas contraire, veuillez indiquer le chemin.
6\. Après quelques secondes, les sauvegardes complètes inscrites dans le catalogue de sauvegardes de votre base de données SAP HANA sont listées.
7. Vous pouvez laisser l'option `Yes (recommended)
` sélectionnée.
8\. Si vous n'avez pas modifié la localisation des sauvegardes et des sauvegardes de logs, laissez les champs vides.
Dans le cas contraire, veuillez indiquer le chemin.
9. Nous vous recommandons de sélectionner l'option `Yes
` pour la catégorie `Backint
`. Cette option permet de vérifier la disponibilité des sauvegardes avant de déclencher la restauration.
10. Dans notre exemple, nous sélectionnons l'option `No
` pour l'étape `Initialize the log area
`.
11\. Veuillez vérifier les paramètres de restauration avant de valider.
12\. La restauration des services du TENANTDB démarre.
13\. Une fois la restauration réalisée avec succès, votre base de données SAP HANA est démarrée et disponible.
## 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)
- Vous pouvez également [réaliser les sauvegardes SAP HANA avec OVHcloud Backint Agent pour SAP HANA avec plusieurs buckets Object Storage](/fr/guides/hosted-private-cloud/sap-on-ovhcloud/hana-use-ovhcloud-backint-agent-several-buckets.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/).