Faire évoluer l’installation
Ce guide explique comment ajouter des composants à une plateforme déjà installée, par exemple White Pages que vous n’aviez pas choisi, sans refaire l’installation. L’installeur rejoue son assistant sur la configuration de la dernière installation réussie. Vous cochez les ajouts, puis il rejoue l’installation. Ce qui est en place reste en place.
Ce qu’une évolution permet
| Possible | Impossible |
|---|---|
| ajouter un composant disponible | retirer un composant installé |
| attribuer un rôle manquant à un serveur déjà déclaré (« Plusieurs serveurs »), puis le tester | changer le domaine ou la base de l’annuaire |
| ajouter un serveur (« Plusieurs serveurs », paquets natifs) pour un rôle qu’aucun serveur installé ne porte et qu’un composant ajouté exige, puis le tester | changer le mode (paquets natifs, Docker Compose) ou la topologie |
| retirer ou modifier un serveur installé, ou ajouter un serveur pour un rôle déjà porté | |
| créer une machine chez un fournisseur de l’installation. Son jeton a été effacé à « Terminer », et aucun écran ne permet de le ressaisir |
Les écrans de l’assistant affichent en lecture seule ce qui est fixé à l’installation. L’installeur refuse aussi toute modification envoyée autrement.
Relancer l’installeur, sur la même machine
Lancez l’installeur sur la machine et avec le répertoire d’état de l’installation. Ils portent la configuration, la clé SSH de l’installeur et les empreintes des serveurs. L’installeur annonce que la plateforme est installée et donne, comme à l’installation, une adresse d’accès à usage unique :
$ open-iam-installer
Répertoire d'état : /home/alice/.local/state/open-iam
Open IAM est déjà installé : l'assistant est verrouillé. Pour faire évoluer l'installation :
Open IAM — ouvrez cette adresse dans votre navigateur (valable 30 minutes, usage unique) :
http://127.0.0.1:7070/acces?jeton=…
Si vous aviez installé en root sur le serveur lui-même, relancez-le de la même façon et rouvrez le
tunnel SSH (voir Installer sur le serveur lui-même). Pour
remplacer un jeton expiré, lancez open-iam-installer nouveau-jeton.
Depuis une autre machine ou un autre répertoire d’état, l’installeur ne trouve pas de verrou et
propose une installation neuve, sans évolution possible. Relancez-le alors avec
--etat <répertoire d'état de l'installation>.
Ajouter des composants
- L’adresse d’accès ouvre la page Faire évoluer l’installation. Elle présente l’installation actuelle : composants, serveurs, date de la dernière exécution réussie et version de l’installeur. Cliquez « Commencer l’évolution ».
- À l’écran Composants, les composants installés sont cochés et marqués « Déjà installé ». Cochez les ajouts.
- L’assistant rouvre seulement les étapes que ces ajouts exigent : le nom DNS d’un nouveau
service, la première messagerie si un ajout envoie des e-mails, les réglages de la supervision
si vous l’ajoutez. Deux cas reviennent à chaque évolution :
- Certificats fournis : l’installeur a effacé la clé privée à la fin de l’installation. Déposez de nouveau la chaîne et la clé, qui doivent couvrir tous les noms.
- Messagerie authentifiée : ressaisissez le mot de passe du compte d’envoi, effacé lui aussi.
- Le récapitulatif sépare « Déjà installé » et « À ajouter ». Faites la vérification préalable, puis « Lancer l’évolution ».
Après l’évolution
- L’installeur écrit un nouveau fichier récapitulatif à côté du premier, qu’il ne modifie pas. Ce fichier donne les adresses de tous les services et les nouveaux mots de passe des comptes de service. Ces mots de passe sont renouvelés à chaque évolution, y compris ceux des outils déjà installés. Les liens de réinitialisation de Self Service Password en cours deviennent donc invalides. Le mot de passe d’urgence et celui du premier administrateur ne changent pas. Ils restent dans le premier récapitulatif.
- « Terminer » efface les secrets de l’évolution, comme à l’installation, y compris le jeton des fournisseurs de machines. L’assistant est alors de nouveau verrouillé.
Mettre à jour les composants installés
La même page propose Mettre à jour les composants. Cette action n’ajoute rien et ne change pas la configuration. Après confirmation, l’installeur effectue ces opérations sur tous les serveurs de l’installation :
- Une sauvegarde de l’annuaire, si les sauvegardes sont installées. Elle ajoute un fichier dans
/var/backups/open-iam. - La mise à jour des paquets des composants installés vers leur dernière version publiée : OpenLDAP LTB, Self Service Password, White Pages et Service Desk, supervision, LemonLDAP::NG.
- Le redémarrage des seuls services dont les paquets ont changé, puis une vérification que l’annuaire et les outils répondent. L’annuaire ne redémarre que si ses propres paquets ont changé.
Aucun mot de passe n’est redemandé ni réécrit, et aucun fichier récapitulatif n’est produit. Avant de lancer, l’installeur vérifie qu’il joint chaque serveur en SSH. S’il en manque un, il le nomme et ne lance rien. L’écran de fin indique combien de tâches ont changé quelque chose et donne le journal complet. L’assistant ne propose pas la mise à jour pendant une évolution en préparation. Terminez-la ou abandonnez-la d’abord.
En cas de problème
- « Installation Open IAM : aucune installation Open IAM sur ce serveur » ou « ce serveur porte
une autre installation Open IAM » : le serveur ne porte plus l’installation que décrit
l’installeur. Il a été remis à blanc, ou réinstallé depuis une autre configuration ou un autre
installeur. Rien n’a été modifié. Pilotez-le depuis l’installeur qui l’a installé. Sinon,
remettez le serveur à blanc, mettez de côté l’état de l’installeur et faites une installation
neuve, en important le
openiam.yamlde l’installation. - « Une évolution est déjà en préparation » : reprenez-la, ou abandonnez-la. L’abandon efface les choix et les secrets de l’évolution, sans rien modifier sur les serveurs.
- Échec de l’exécution : « Relancer » reprend sans risque. Après un abandon, les serveurs peuvent garder une partie des ajouts. Une nouvelle évolution avec les mêmes composants termine leur installation.
- Installation précédente non terminée (« Terminer » jamais cliqué) : conservez d’abord le fichier récapitulatif. « Effacer ces secrets et continuer » applique les purges de « Terminer ».
- Version de l’installeur : une installation faite avec une version plus récente de l’installeur ne peut pas évoluer avec une version plus ancienne.
- Docker Compose : l’appliance garde la configuration de l’annuaire dans un volume. L’installeur ne propose pas d’évolution pour une appliance installée par un installeur antérieur à cette fonction.