Skip to main content

Renommer le FQDN et passer en HTTPS sur Medulla

S'applique à : Medulla
Version : Toutes
Environnement : On-Premise
Catégorie : Administration serveur

Contexte

Cette procédure permet de modifier le FQDN (nom DNS complet) d’une instance Medulla.

Exemple :

medulla.ancien-domaine.lan → medulla.nouveau-domaine.fr

Le script rename_fqdn_and_protocol.py permet également :

    De modifier automatiquement les fichiers de configuration Medulla De mettre à jour les URLs stockées en base de données De migrer de http vers https De configurer automatiquement Apache pour SSL De re-générer les agents Medulla avec le nouveau FQDN

    Important :
    Avant d’exécuter le script, le nouveau FQDN doit être résolvable par DNS et pointer vers votre serveur Medulla.

    Pré-requis

      Le nouveau FQDN doit exister dans le DNS Le nouveau FQDN doit pointer vers l’adresse IP du serveur Medulla Le script doit être exécuté en root Le module Python mysql-connector doit être installé Pour HTTPS : disposer d’un certificat SSL au format PEM ainsi que de sa clé privée non chiffrée

      Recommandation :
      Effectuer une sauvegarde des fichiers de configuration ainsi qu’un backup de la base xmppmaster avant exécution.

      Téléchargement du script

      Récupérer le script àdepuis cel’URL liensuivante :

      https://dl.medulla-tech.io/nc/ma/rename_fqdn_and_protocol.py

      Télécharger le script :

      wget https://dl.medulla-tech.io/ma/rename_fqdn_and_protocol.py

      Rendre ensuite le script exécutable :

      chmod +x rename_fqdn_and_protocol.py

      PourAfficher voir les optionsl’aide du script :

      ./rename_fqdn_and_protocolrename_fqdn_and_protocol.py --help

      Modifier le FQDN du serveur

      Pour modifier un FQDN existant :

      medulla.mondomaine.lan en→ medulla.mondomaine.fr
      voici l'exemple d'utilisation de la commande

      Commande :

      ./rename_fqdn_and_protocolrename_fqdn_and_protocol.py \
--old-fqdn medulla.mondomaine.lan \
--new-fqdn medulla.mondomaine.fr

      Cette commande met automatiquement à jour :

        Les fichiers de configuration Medulla Les URLs Guacamole Les paramètres Apache La base de données xmppmaster Le script d’installation Windows install-agent.ps1 Les URLs utilisées par les services Medulla

        Propagation vers les postes clients

        L’URL Guacamole de chaque machine est mise à jour en base avec un marquage de reconfiguration (need_reconf). La nouvelle URL est ensuite transmise à chaque poste lors de son prochain check-in auprès du serveur Medulla.

        Information :
        Le changement de FQDN n’est donc pas instantané côté clients : la propagation peut prendre un certain temps selon la fréquence de connexion des agents. Il est normal que certains postes pointent encore temporairement vers l’ancienne URL Guacamole.

        Modifier le protocol

        protocole HTTP → HTTPS

        Il est également possible de changermigrer le procotol http à https danssimultanément les URLURLs ende mêmehttp tempsvers https.

        Commande :

        ./rename_fqdn_and_protocolrename_fqdn_and_protocol.py \
--old-fqdn medulla.mondomaine.lan \
--new-fqdn medulla.mondomaine.fr \
--new-protocol https

        Le protocole sera automatiquement remplacé dans les URLs gérées par Medulla. Si l’option --new-protocol n’est pas spécifiée, le protocole existant est conservé.

        Attention :
        Pour une configuration HTTPS complète, il est recommandé de fournir un certificat SSL valide.

        Exemple complet avec certificat SSL

        ./rename_fqdn_and_protocol.py \
--old-fqdn medulla.ancien.fr \
--new-fqdn medulla.nouveau.fr \
--new-protocol https \
--ssl-pem-chain-filename /root/fullchain.pem \
--ssl-pem-key-filename /root/privkey.pem

        Le script réalisera automatiquement :

          L’activation SSL d’Apache La configuration des VirtualHosts HTTPS La redirection HTTP → HTTPS L’installation des certificats

          Re-générer l'agentles agents avec le nouveau FQDN

          Si les postes doiventclients également communiquercommuniquent directement vers lesMedulla nouveauvia FQDN,le FQDN public, il est possiblerecommandé de re-générer l'agentles avecagents afin qu’ils utilisent automatiquement le nouveau FQDNnom DNS.

          Commande :

          ./rename_fqdn_and_protocolrename_fqdn_and_protocol.py \
--old-fqdn medulla.mondomaine.lan \
--new-fqdn medulla.mondomaine.fr \
--update-agent-conf

          Information :
          Cette option :

            Met à jour le fichier agentconf.ini Met à jour le fichier .generation_options Re-génère automatiquement les agents Medulla

            Remarque :
            Le script d’installation Windows install-agent.ps1 est quant à lui mis à jour systématiquement, que l’option --update-agent-conf soit utilisée ou non.

            PourAttention plus:
            Après d'informationsre-génération des agents, il sera nécessaire de déployer la nouvelle configuration sur les postes afin qu’ils puissent continuer à communiquer avec le serveur Medulla.

            Options disponibles du script

            Argument Obligatoire Description --old-fqdn Oui FQDN actuel à remplacer --new-fqdn Oui Nouveau FQDN Medulla --new-protocol Non http ou https. Si absent, le protocole existant est conservé --ssl-pem-chain-filename Non Certificat SSL PEM (chaîne complète). Nécessite --new-protocol https --ssl-pem-key-filename Non Clé privée PEM non chiffrée --update-agent-conf Non Re-génère les agents avec le nouveau FQDN

            Que modifie exactement le script ?

            Élément Action réalisée relayconf.ini.local Mise à jour de l’URL Guacamole xmppmaster.ini.local Mise à jour des URLs Guacamole / Graph / Render assessor_agent.ini.local Mise à jour de l’URL Guacamole Base xmppmaster Mise à jour des URLs Guacamole des tables machines et querelayserver, vousavec possédezmarquage need_reconf Apache Mise à jour ProxyPass / Referer / SSL Agents Medulla Reconfiguration et re-génération (uniquement avec --update-agent-conf) Script Windows install-agent.ps1 Mise à jour de l’URL de téléchargement (systématique)

            Services automatiquement redémarrés

            Pendant l’exécution du script, les services suivants sont automatiquement redémarrés :

              pulse-xmpp-agent-relay mmc-agent pulse-xmpp-master-substitute-assessor apache2

              Attention :
              Une courte interruption de service peut être observée pendant l’exécution du script.

              Cas particulier : assessor distant

              Si le serveur assessor est hébergé sur un contratserveur distant, le script ne pourra pas mettre à jour automatiquement le fichier suivant :

              /etc/pulse-xmpp-agent-substitute/assessor_agent.ini.local

              Dans ce cas, la modification devra être réalisée manuellement sur le serveur concerné. Cet échec n’interrompt pas l’exécution du script : les étapes suivantes sont réalisées normalement.

              Gestion des erreurs

              En cas d’échec, le script s’arrête immédiatement (à l’exception du cas de supportl’assessor Medulla,distant contactezci-dessus).

              support@medulla-tech.io

              Important :
              Le script n’effectue aucun rollback automatique.

              Les modifications déjà appliquées restent présentes. Une fois le problème corrigé, le script peut être relancé sans risque : les opérations sont idempotentes, un remplacement déjà effectué est sans effet (les services concernés seront toutefois redémarrés à nouveau).

              Valeurs par défaut

              Élément Valeur Hôte SQL localhost Port SQL 3306 Utilisateur SQL mmc Protocole Conservé si non spécifié HTTPS Optionnel Re-génération agent Désactivée sans --update-agent-conf

              Information :
              Les paramètres de connexion SQL sont lus depuis /etc/mmc/plugins/xmppmaster.ini (et .local s’il existe). Les valeurs ci-dessus s’appliquent uniquement si elles n’y sont pas définies.

              Back to top