Skip to main content

Comment changer l'entité GLPI d'un serveur Imaging Medulla ?

S'applique à : Medulla Serveur
Version : Medulla 5.6.x
Environnement : On-Premise / Debian
Catégorie : Imaging / Administration

Présentation

Cette procédure permet de changer l'entité GLPI à laquelle un serveur Imaging Medulla est associé, sans avoir à supprimer ni recréer ce serveur.

Le script change_entite_imaging.sh automatise la préparation de cette opération.

Il permet de :

  • Afficher les entités GLPI disponibles.
  • Sélectionner la nouvelle entité de destination.
  • Afficher les serveurs Imaging existants et leur association actuelle.
  • Sélectionner le serveur Imaging à déplacer.
  • Préparer automatiquement la nouvelle association.
  • Détecter les situations dans lesquelles aucune modification n'est nécessaire.
  • Enregistrer les opérations dans un journal.

La réassociation est ensuite finalisée depuis l'interface d'administration Medulla.

1. Prérequis

Avant de commencer, vérifier que vous disposez :

  • D'un accès SSH au serveur principal Medulla.
  • Des droits root ou sudo.
  • D'un accès à l'interface d'administration Medulla.
  • D'une entité GLPI de destination existante.
  • D'un serveur Imaging déjà déclaré dans Medulla.

Le serveur doit également disposer d'un accès fonctionnel à ses bases de données et d'une version de MariaDB compatible avec le script.

Attention : cette procédure modifie la configuration d'association d'un serveur Imaging. Il est recommandé de réaliser une sauvegarde avant l'intervention et d'effectuer l'opération pendant une période de maintenance.

2. Télécharger le script

Se connecter en SSH au serveur principal Medulla.

Télécharger le script depuis le serveur de téléchargement officiel Medulla :

wget https://dl.medulla-tech.io/change_entite_imaging.sh

Rendre le script exécutable :

chmod +x change_entite_imaging.sh

Le script est maintenant prêt à être utilisé.

3. Simuler le changement d'entité

Avant de lancer une modification réelle, il est recommandé d'effectuer une simulation.

sudo bash change_entite_imaging.sh --dry-run

Le script affiche automatiquement la liste des entités GLPI disponibles.

Exemple :

=== Entités ===
ID    ENTITÉ
0     Entité racine
2     Collectivité A
5     Collectivité B
ID de l'entité destination :

Saisir l'identifiant de la nouvelle entité.

Le script affiche ensuite les serveurs Imaging existants :

=== Imaging Servers ===
ID    NOM                 ENTITÉ ACTUELLE       ÉTAT
1     imaging-server-01    Collectivité A        associé
2     imaging-server-02    Collectivité B        associé
ID de l'Imaging Server à basculer :

Saisir l'identifiant du serveur Imaging concerné.

Le script présente alors les opérations prévues et indique qu'il fonctionne en mode simulation.

Mode simulation : aucune modification n'est effectuée dans les bases de données. Cette étape permet de vérifier les informations sélectionnées avant de procéder au changement réel.

4. Changer l'entité du serveur Imaging

Une fois la simulation vérifiée, exécuter le script sans paramètre :

sudo bash change_entite_imaging.sh

Le script demande successivement :

  1. De sélectionner l'entité GLPI de destination.
  2. De sélectionner le serveur Imaging à déplacer.
  3. De confirmer l'opération.

Un récapitulatif du changement est affiché avant confirmation.

Pour valider, saisir o lorsque le script affiche :

Confirmer ? (o/N) :

Pour annuler, saisir N ou appuyer sur Entrée.

Après confirmation, le script prépare automatiquement la réassociation du serveur Imaging.

Lorsque l'opération réussit, il affiche :

Bascule effectuée.
>>> Finaliser dans l'interface Medulla :
    Menu Imaging > entité de destination > valider en bas de page > recharger.

Important : l'exécution du script ne suffit pas à terminer le changement d'entité. La validation dans l'interface Medulla est indispensable.

5. Finaliser la réassociation dans Medulla

Après l'exécution du script :

  1. Se connecter à l'interface d'administration Medulla.
  2. Ouvrir le menu Imaging.
  3. Sélectionner la nouvelle entité GLPI.
  4. Cliquer sur le bouton de validation situé en bas de page.
  5. Recharger la page.
  6. Vérifier que le serveur Imaging est désormais associé à la nouvelle entité.

Résultat : le serveur Imaging est désormais rattaché à la nouvelle entité GLPI, sans qu'il ait été nécessaire de le supprimer ou de le recréer.

6. Cas particuliers

Le serveur est déjà associé à la bonne entité

Si le serveur Imaging est déjà associé à l'entité sélectionnée, le script le détecte automatiquement et ne réalise aucune modification.

Le serveur est déjà dissocié

Si le serveur Imaging est déjà dissocié, le script vérifie si l'entité de destination est disponible.

Si elle existe déjà, il indique qu'aucune modification supplémentaire n'est nécessaire et invite à terminer l'opération directement dans Medulla.

Si elle n'existe pas encore dans Imaging, le script prépare sa création avant la validation dans l'interface.

L'entité ou le serveur sélectionné n'existe pas

Le script vérifie les identifiants saisis et interrompt l'opération si l'entité ou le serveur Imaging n'existe pas.

Une autre exécution est déjà en cours

Le script empêche deux exécutions simultanées.

Si une autre opération est en cours, attendre sa fin avant de recommencer.

7. Consulter le journal des opérations

Les opérations réalisées sont enregistrées dans le fichier :

/var/log/medulla_change_entite_imaging.log

Pour consulter les dernières opérations :

sudo tail -n 50 /var/log/medulla_change_entite_imaging.log

Ce journal permet de retrouver les informations relatives aux changements effectués et de faciliter un éventuel diagnostic.

8. Recommandations

  • Effectuer systématiquement une simulation avant le changement réel.
  • Vérifier attentivement l'entité de destination et le serveur Imaging sélectionné.
  • Éviter les opérations Imaging simultanées pendant l'intervention.
  • Finaliser la réassociation dans l'interface Medulla immédiatement après l'exécution du script.
  • Vérifier que le serveur Imaging fonctionne correctement dans sa nouvelle entité.

9. Récapitulatif des commandes

Action Commande
Télécharger le script wget https://dl.medulla-tech.io/change_entite_imaging.sh
Rendre le script exécutable chmod +x change_entite_imaging.sh
Afficher l'aide sudo bash change_entite_imaging.sh --help
Effectuer une simulation sudo bash change_entite_imaging.sh --dry-run
Changer l'entité sudo bash change_entite_imaging.sh
Consulter le journal sudo tail -n 50 /var/log/medulla_change_entite_imaging.log

À retenir : le changement d'entité d'un serveur Imaging Medulla s'effectue en deux étapes : exécution du script sur le serveur principal, puis validation de la nouvelle association dans l'interface Medulla.

Back to top