Sauvegarde SAP HANA avec Veeam : snapshot et plugin Backint
Installer et configurer la sauvegarde SAP HANA sous Linux avec Veeam : scripts pre-freeze/post-thaw, plugin SAP HANA, rétention et mise à jour via Ansible.
Cet article décrit comment sauvegarder une base SAP HANA sous Linux avec Veeam Backup & Replication : sauvegarde par snapshot de la machine virtuelle (scripts pre-freeze / post-thaw) et plugin Veeam pour SAP HANA (Backint). Références officielles : Configurer le plugin SAP HANA et garbage collector du plugin SAP HANA.
Prérequis
- Le serveur Veeam (
veeamserver01) dispose des scriptshana-pre-freeze.shethana-post-thaw.shdans un dossier accessible aux jobs (par exempleC:\tools\Database\Scripts\). - Un compte Linux dédié (
veeam_svc) est déclaré dans Veeam pour accéder à la machine HANA. - Un compte pour le plugin (
hana_veeam) a accès aux dépôts de sauvegarde (repository) concernés, avec les permissions correspondantes dans Veeam. - Le paquet RPM du plugin (
VeeamPluginforSAPHANA-<version>.x86_64.rpm) est disponible. - Pour la sauvegarde par snapshot, la machine virtuelle doit se trouver dans le dossier ou la balise vSphere prévu pour les jobs HANA.
Sauvegarde par snapshot : préparation du serveur HANA
- Créer l'utilisateur utilisé par Veeam, avec un uid fixe et les groupes SAP :
sudo useradd veeam_svc -g sapsys -G sapsys,hhdshm -u 8502
sudo passwd veeam_svc
Le groupe hhdshm est celui de votre SID HANA (<sid>shm) ; adapter le nom.
- Déposer la clé publique SSH dans les clés autorisées de l'utilisateur :
sudo su - veeam_svc
mkdir -p ~/.ssh
touch ~/.ssh/authorized_keys
chmod 700 ~/.ssh
# copier la clé publique autorisée, par exemple depuis un autre hôte
scp adminhost:~/.ssh/authorized_keys ~/.ssh/
- Autoriser l'utilisateur dans sudoers :
sudo visudo -f /etc/sudoers.d/veeam_svc
veeam_svc ALL=(ALL) NOPASSWD:ALL
- Créer le fichier de configuration lu par les scripts pre-freeze / post-thaw :
sudo mkdir -p /etc/veeam
sudo vim /etc/veeam/hana.conf
# Config file for HANA pre-freeze/post-thaw scripts
# To use standard username/password, set values here
username="SYSTEM"
password=<PASSWORD>
# To use key-based authentication, enter a key prefix here (default is HDB)
keyprefix="HDB"
# Log purge options
purgelogs="false"
purgedays="3"
sudo chmod 775 /etc/veeam
sudo chmod 664 /etc/veeam/hana.conf
- Dans Veeam, créer le job de sauvegarde de la machine virtuelle en activant le traitement applicatif et en référençant les scripts
hana-pre-freeze.shethana-post-thaw.sh.
Installation du plugin
- Copier le RPM dans
/tmp(par exemple avec WinSCP), puis l'installer en root :
sudo rpm -i /tmp/VeeamPluginforSAPHANA-<version>.x86_64.rpm
- Identifier l'utilisateur
<sid>admpropriétaire des processus HANA :
ps -ef | grep hdb
Le propriétaire du processus hdb... (par exemple hhdadm) est l'utilisateur SAP concerné. Il est mentionné dans la configuration et sert aux étapes de post-installation.
- Lancer l'assistant de configuration du plugin :
sudo SapBackintConfigTool --wizard
L'assistant demande :
- le nom ou l'adresse du serveur de sauvegarde (par exemple
veeamserver01.example.com) ; - le port du serveur de sauvegarde (par exemple
10006) ; - le nom d'utilisateur et son mot de passe ;
- le dépôt de sauvegarde à utiliser.
À la fin, le message SID <sid> has been configured doit apparaître.
- Vérifier le fichier de configuration :
cat /opt/veeam/VeeamPluginforSAPHANA/veeam_config.xml
Exemple de contenu, avec la rétention (backupExpiredTimeDays) et un seuil d'alerte d'espace libre sur le dépôt (repositoryFreeSpacePercentWarning) ajoutés dans PluginParameters :
<Config>
<CAVerificationParameters />
<AdditionalCertificatePaths />
<ProxyConfig />
<VBRConnectionParams vbrHostName="veeamserver01.example.com" vbrPort="10006" vbrUser="hana_veeam" vbrDomain="" vbrPassword="<PASSWORD>" />
<Certificate />
<BackupForRestoreParams />
<AgentParams />
<RepositoryParams>
<Repository repositoryName="Backup Repository" repositoryID="00000000-0000-0000-0000-000000000000" />
</RepositoryParams>
<PluginParameters backupExpiredTimeDays="365" repositoryFreeSpacePercentWarning="3" />
<ClusterParams isCluster="false" />
<SourceServerParams />
</Config>
Pour le plugin Oracle RMAN, le même principe s'applique dans /opt/veeam/VeeamPluginforOracleRMAN/veeam_config.xml.
Script de sauvegarde planifié
Pour piloter la sauvegarde depuis un ordonnanceur (par exemple un job planifié) :
- Copier le script de sauvegarde (full / différentielle) dans un répertoire dédié, par exemple
/home/<user>/scripts/backupFullDiff_hana.sh. - Donner à l'utilisateur les droits d'accès à la base HANA.
- Rendre le script exécutable :
chmod 775 /home/<user>/scripts/backupFullDiff_hana.sh. - Le tester manuellement, puis dans l'ordonnanceur.
Vérifier que le service SAP est actif :
systemctl status sapinit
Post-installation
- Créer les répertoires nécessaires au
failbackint(repli local du Backint) sous le dossier de sauvegarde HANA et en donner la propriété à l'utilisateur<sid>adm:
sudo chown <sid>adm:sapsys -R /hana/backup/
ls -altr /hana/backup/
- Activer la suppression forcée des sauvegardes expirées (voir le lien du garbage collector ci-dessus) :
./SapBackintConfigTool --set-force-delete
avec une durée de conservation de 365 jours dans l'exemple.
- Vérifier que le mode de journalisation (log mode) de la base est
normal. - Vérifier que le catalogue de sauvegarde SAP HANA indique bien les sauvegardes Backint.
Déploiement et mise à jour avec Ansible
Si vous gérez le parc avec Ansible, le plugin et son fichier de configuration peuvent être déployés ou mis à jour par des playbooks dédiés :
ansible-playbook -i inventory/hana.yml playbooks/update_veeam_hana_plugin.yml
ansible-playbook -i inventory/hana.yml playbooks/update_hana_config.yml
Remarques
- Ne jamais écrire un mot de passe réel dans un article ou un dépôt : conserver les secrets dans un gestionnaire de mots de passe.
- Les noms d'hôtes, comptes, SID et chemins ci-dessus sont des exemples génériques.
- Les noms de playbooks Ansible sont indicatifs.