Restaurer une sauvegarde de l’annuaire
Ce guide sert quand l’annuaire a perdu des données : suppression par erreur, disque défaillant ou serveur réinstallé. Comptez 10 minutes. L’annuaire est interrompu de quelques secondes à quelques minutes, selon sa taille.
Ce que vous avez
Chaque nuit à 02 h 30, le serveur de l’annuaire écrit deux fichiers dans /var/backups/open-iam/.
Ils sont chiffrés avec age et conservés 30 jours :
AAAAMMJJ-HHMMSS-donnees.ldif.gz.age: toutes les entrées de l’annuaire (utilisateurs, groupes, comptes de service, politiques de mots de passe).AAAAMMJJ-HHMMSS-config.ldif.gz.age: la configuration du serveur (cn=config).
La clé de déchiffrement se trouve dans /etc/open-iam/sauvegarde/age.key sur le serveur, et dans
le fichier récapitulatif remis à la fin de l’installation. Sans cette clé, une sauvegarde est
illisible. Si vous perdez le serveur, seule la copie du récapitulatif vous permet de la
déchiffrer.
Chaque dimanche à 04 h 00, open-iam-test-restauration vérifie que la dernière sauvegarde se
restaure, dans un annuaire temporaire, sans toucher au service. La supervision, si elle est
installée, lève une alerte quand une sauvegarde échoue.
Restaurer les données
Sur le serveur de l’annuaire, en root :
-
Listez les sauvegardes disponibles :
open-iam-restaurationSans argument, le script affiche son usage et la liste des fichiers
-donnees. -
Lancez la restauration en donnant l’horodatage choisi (ou le chemin complet du fichier) :
open-iam-restauration 20261103-023000Le script procède dans cet ordre :
- Il déchiffre la sauvegarde et compte ses entrées.
- Il fait une sauvegarde préalable de l’annuaire en service, pour pouvoir revenir en arrière.
- Il arrête
slapd-ltb, écarte les bases actuelles dans/usr/local/openldap/var/avant-restauration-<date>, et recharge les données avecslapadd. - Il redémarre
slapd-ltbet vérifie que le nombre d’entrées en service est celui de la sauvegarde.
Résultat attendu :
Restauration de 20261103-023000-donnees.ldif.gz.age : 42 entrées. Sauvegarde préalable de l'annuaire en service… Sauvegarde 20261103-171205 terminée. Restauration réussie : 42 entrées. Les bases précédentes sont conservées dans /usr/local/openldap/var/avant-restauration-20261103-171205 (à supprimer après vérification). -
Vérifiez depuis un poste qu’une connexion fonctionne (changement de mot de passe sur
https://mdp.<domaine>, ouldapwhoamien LDAPS), puis supprimez le dossieravant-restauration-<date>une fois rassuré.
Si une étape échoue après l’arrêt du service, le script remet les bases écartées en place et
redémarre slapd-ltb. L’annuaire revient dans l’état d’avant la restauration.
Ce que la restauration ne fait pas
- La configuration du serveur (
cn=config) n’est pas restaurée, parce que l’installeur la produit. Pour un serveur réinstallé, rejouez l’installation avec le mêmeopeniam.yaml, puis restaurez avec ce guide. - Le journal d’accès (
accesslog) repart à vide. Il sert à compter les échecs de connexion pour verrouiller les comptes. - Les outils web et la supervision n’ont pas de données à restaurer : leur état est dans l’annuaire ou se reconstruit.
Restaurer sur un serveur neuf
- Rejouez l’installation sur le serveur neuf avec le
openiam.yamltéléchargé au récapitulatif (bouton « Télécharger openiam.yaml ») : même domaine, même base, mêmes composants. - Copiez la clé
age.keydu récapitulatif dans/etc/open-iam/sauvegarde/age.keysur ce serveur (droits0600). Elle remplace la clé générée par l’installation. Copiez aussi le fichier de sauvegarde dans/var/backups/open-iam/. - Suivez « Restaurer les données » ci-dessus.
La sauvegarde contient les mots de passe des utilisateurs. Les comptes de service des outils (changement de mot de passe, pages blanches, support, supervision) posent un problème : ils reprennent les mots de passe de l’ancienne installation, alors que les outils du serveur neuf ont été configurés avec de nouveaux. Ce cas est prévu avec « Faire évoluer l’installation », qui rejouera l’installation et réinstallera ces mots de passe. D’ici là, restaurez de préférence sur le serveur d’origine, ou reportez à la main les mots de passe de l’ancien récapitulatif dans les outils.