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
• SAP Note 2031547
• SAP Note 3344150

Prérequis

• Être connecté à l’espace client OVHcloud.
• Un projet Public Cloud dans votre compte OVHcloud avec :
  • un bucket Object Storage ;
  • un utilisateur Object Storage avec le droit de lecture et d'écriture.
• Une base de données SAP HANA installée.

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 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/<SID>/SYS/global/hdb/opt/ et téléchargez l'archive d'OVHcloud Backint Agent pour SAP HANA 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 :

wget https://ovhcloud-backint-agent.s3.rbx.io.cloud.ovh.net/ovhcloud-backint-agent.zip -P /usr/sap/<SID>/SYS/global/hdb/opt/

L'archive ovhcloud-backint-agent.zip doit être décompressée, vous pouvez utiliser la commande suivante :

unzip /usr/sap/<SID>/SYS/global/hdb/opt/ovhcloud-backint-agent.zip -d /usr/sap/<SID>/SYS/global/hdb/opt/

À présent, cinq fichiers sont présents dans le répertoire /usr/sap/<SID>/SYS/global/hdb/opt/ :

• LICENSE
• NOTICE
• VERSION
• hdbbackint.cfg
• hdbbackint

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.

chown <sid>adm:sapsys /usr/sap/<SID>/SYS/global/hdb/opt/hdbbackint.cfg
chown <sid>adm:sapsys /usr/sap/<SID>/SYS/global/hdb/opt/hdbbackint
chmod 600 /usr/sap/<SID>/SYS/global/hdb/opt/hdbbackint.cfg
chmod 500 /usr/sap/<SID>/SYS/global/hdb/opt/hdbbackint

Vérifiez que vous pouvez exécuter OVHcloud Backint Agent avec l'utilisateur SAP HANA.

su - <sid>adm -c "/usr/sap/<SID>/SYS/global/hdb/opt/hdbbackint -v"

Sortie attendue :

"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.

[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.

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 <SID> par le SID de votre base de données SAP HANA.

ALTER SYSTEM ALTER CONFIGURATION('global.ini','SYSTEM') SET('backup','catalog_backup_parameter_file')='/usr/sap/<SID>/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/<SID>/SYS/global/hdb/opt/hdbbackint.cfg' WITH RECONFIGURE;
ALTER SYSTEM ALTER CONFIGURATION('global.ini','SYSTEM') SET('backup','log_backup_parameter_file')='/usr/sap/<SID>/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 :

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 ».

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 <SID> par le SID de votre base de données SAP HANA et les caractères <NI> par le numéro d'instance de votre base de données SAP HANA.

# Sauvegarde du SYSTEMDB
/usr/sap/<SID>/HDB<NI>/exe/hdbsql -u SYSTEM -d SYSTEMDB "BACKUP DATA USING BACKINT ('MANUAL_COMPLETE_BACKUP');"

# Sauvegarde du TENANTDB
/usr/sap/<SID>/HDB<NI>/exe/hdbsql -u SYSTEM -d SYSTEMDB "BACKUP DATA FOR <SID> 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_<SID> 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/<SID>/HDB<NI>/<hostname>/trace pour la sauvegarde du SYSTEMDB et dans le répertoire /usr/sap/<SID>/HDB<NI>/<hostname>/trace/DB_<SID> 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 :

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.

INFO    BACKUP   state of service: nameserver, <hostname>:30001, volume: 0, BackupExecuteTopologyAndSSFSBackupInProgress
INFO    BACKUP   state of service: nameserver, <hostname>:30001, volume: 0, BackupError
INFO    BACKUP   state of service: nameserver, <hostname>:30001, volume: 1, BackupAbortSavepointInProgress
INFO    BACKUP   state of service: nameserver, <hostname>: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, 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 <SID> par le SID de votre base de données SAP HANA et les caractères <NI> par le numéro d'instance de votre base de données SAP HANA.

# Sauvegarde complète du TENANTDB - Tous les jours
30 1 * * * /usr/sap/<SID>/HDB<NI>/exe/hdbsql -U BACKUP "BACKUP DATA FOR <SID> USING BACKINT ('$(date +\%d\%m\%Y_\%H\%M\%S\%s)_COMPLETE_BACKUP');"

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é
• Vous pouvez également réaliser les sauvegardes SAP HANA avec OVHcloud Backint Agent pour SAP HANA avec plusieurs buckets Object Storage

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 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.