Aller au contenu principal

Mise à jour de BlueMind

La souscription BlueMind apporte un système de mise à jour simplifié et testé.

La mise à jour de BlueMind vers une version supérieure corrective ou évolutive est alors simplifiée, plus sûre et plus rapide grâce aux outils intégrés.

Mise à jour de BlueMind 4 vers BlueMind 5

Dans le cas d'un changement de version, consulter la procédure de Mise à jour de version majeure de BlueMind afin de valider les points de vigilance particuliers, en complément des prérequis décrits ci-dessous.

Vérifier les prérequis​

Sauvegarde de l'ensemble du système​

BlueMind consacre beaucoup d'efforts à assurer la fiabilité des mises à jour. Cependant, nul n'est à l'abri de cas particuliers non testés ou de facteurs externes pouvant conduire à des pertes de données. BlueMind n'est pas responsable en cas d'échec de mise à jour qui pourrait corrompre un système installé.

Il est donc de votre responsabilité de vous prémunir de ce risque en effectuant une sauvegarde complète de votre système.

Mise à jour de la distribution Linux​

La mise à jour de votre distribution Linux vers une version majeure supérieure (Debian 10 vers Debian 11 par exemple) ne doit pas être réalisée avec les mécanismes automatiques de mise à jour des distributions (changement des sources de paquet et utilisation de la commande aptitude dist-upgrade). En effet, les dépendances de BlueMind peuvent être modifiées et le bon fonctionnement des services BlueMind risque d'être impacté.

Pour une mise à jour de version majeure de la distribution, veuillez contacter votre prestataire intégrateur ou nous contacter via notre service de Support.

Pour plus d'informations sur le changement de distribution, consulter la page dédiée : Changer de distribution.

Souscription​

Pour accéder aux outils de mise à jour de BlueMind, il est nécessaire de posséder et d'avoir installé une souscription en cours de validité.

Accès à l'assistant d'installation​

Afin d'effectuer la mise à jour, l'accès à l'assistant d'installation doit être effectif.

⇒ Vérifier l'accès en se connectant à l'adresse http://votre.serveur.com/setup avec le login admin et le mot de passe fourni lors de l'installation de BlueMind.

En cas de perte, ce mot de passe peut être réinitialisé de deux façons : via la console d'administration ou en ligne de commande.

Réinitialisation via la console d'administration​

  • se connecter en tant qu'administrateur global admin0
  • aller dans Gestion du système > Configuration Système > onglet « Serveur Mandataire »
  • remplir le nouveau mot de passe
  • enregistrer

Réinitialisation en ligne de commande​

  • se connecter au serveur BlueMind en tant que root et taper la commande suivante : 
    bm-cli sysconf set sw_password -v MyAdminSetupWizardP@sswordAndMustBeChanged
    NB : le mot de passe est ici indiqué à titre d'exemple, il doit être personnalisé
  • se connecter à l'URL http://votre.serveur.com/setup
    • login : admin
    • mot de passe MyAdminSetupWizardP@sswordAndMustBeChanged (ou autre si personnalisé à l'étape précédente)

      ❗ Cette étape est impérative, même si vous n'en êtes pas encore à l'étape de mise à jour de BlueMind.

Signature des dépôts​

Les dépôts sont signés pour toutes les distributions Ubuntu/Debian supportées. Il est possible, si nécessaire ou désiré, d'importer manuellement la clé sur l'ensemble de celles-ci via la commande suivante :

curl https://pkg.bluemind.net/bluemind-deb.asc -o /etc/apt/trusted.gpg.d/bluemind.gpg

Sans cela, un message d'avertissement peut survenir lors de la mise à jour sans que cela ne la gêne pour autant.

Lancer la procédure de mise à jour​

Les dépôts logiciels étant pris en compte par le système dès l'installation de la souscription, BlueMind pourra être mis à jour automatiquement lors de la mise à jour du système.

remarque

Si vous avez modifié les fichiers de configuration manuellement, assurez-vous d'en faire une sauvegarde.
Pour en savoir plus, voir en Annexes : note sur les fichiers de configuration

Préparer la mise à jour​

Pour une mise à jour d'un BlueMind déjà en version 5, le processus de mise à jour doit être initié par un administrateur.
Cela permet une plus grande maîtrise des versions et limite le risque d'erreur : la version cible peut désormais être ouverte, afin de toujours mettre à jour dans la dernière version publiée, ou au contraire figée, afin d'empêcher les mises à jour involontaires.
Cela permet aussi de sécuriser le respect de la version majeure du serveur ainsi que l'installation des paquets additionnels : ils seront installés dans la version du serveur.

Cette préparation peut se faire de deux façons : via la console d'administration ou en ligne de commande.

Préparation via la console d'administration​

  • se rendre dans Gestion du système > Mise à jour de BlueMind
  • Cliquer sur le bouton "Configurer" : la dernière version disponible sera installée.

Préparation en ligne de commande​

Contrairement à la console d'administration, l'outil en ligne de commande permet de cibler la version vers laquelle mettre à jour l'installation :

Pour mettre à jour dans la dernière version disponible utiliser latest :

bm-cli setup version latest
Disponibilité des commandes bm-cli

Les commandes de l'outil bm-cli doivent avoir été installées lors de la mise en œuvre de la souscription.

Mettre à jour les paquets​

Installation multi-serveurs

Le processus de mise à jour de BlueMind commence par la mise à jour des paquets sur tous les serveurs de l'installation. Ensuite, la phase de mise à jour proprement dite sera jouée une seule fois.

  1. Se connecter en tant que root sur chacun des serveurs de l'installation

  2. Mettre à jour les paquets sur chacun d'eux :

    💡 Limiter le temps d'interruption des services
    La commande de mise à jour peut être lancée avec l'option download-only afin de seulement télécharger les paquets sans provoquer d'interruption ni de ralentissement des services. Cette action peut donc être réalisée à n'importe quel moment.
    La commande upgrade de mise à jour effective des paquets pourra ensuite être lancée au moment le plus opportun.

    aptitude update
aptitude --download-only upgrade
    aptitude update
aptitude upgrade

Mettre à jour BlueMind​

La mise à jour de BlueMind peut être effectuée soit en ligne de commande grâce au Client CLI pour l'administration soit en utilisant l'interface graphique du Setup Wizard.

En ligne de commande avec bm-cli​

Une fois les paquets mis à jour sur le(s) serveur(s) (voir ci-dessus), lancer la commande de mise à jour :

bm-cli setup upgrade

Mettre à jour BlueMind avec l'assistant graphique​

Une fois les paquets mis à jour sur le(s) serveur(s) (voir ci-dessus) :

  1. Se rendre avec un navigateur sur l'interface de gestion des mises à jour http://votre.serveur.com/setup :

    💡 Cette étape nécessite le mot de passe d'accès à l'assistant d'installation - voir Accès à l'assistant d'installation ci-dessus

  2. Lancer la procédure automatique de configuration de BlueMind en cliquant sur le bouton « Update this installation » ("Mettre à jour cette installation")

  3. Une fois la procédure finie, un message vous informe du bon déroulement : ⇒ L'accès à BlueMind est dès lors possible à son URL habituelle

Journaux d'erreurs

En cas de problèmes, les erreurs sont écrites dans les journaux de bm-core et bm-webserver. Pour plus d'informations, voir la page Logs - Fichiers journaux.

Annexes​

Notes sur les fichiers de configuration​

Postfix​

La configuration Postfix est écrasée uniquement lors de la phase d'installation. Par la suite, cette configuration est mise à jour via la commande postconf. Il est possible de personnaliser les fichiers de configuration comme souhaité, à l'exception de :

  • Enlever les maps de BlueMind : des maps peuvent en revanche être ajoutées.
  • Modifier mynetwork depuis la console d'administration.
  • Modifier relayhost depuis la console d'administration.

Nginx​

Le virtual host est écrasé à chaque mise à jour.
L'ensemble des VHost sont désactivés lors d'une mise à jour et seuls ceux de BlueMind (bm-client-acces et bm-webmail) sont réactivés. D'autres peuvent être réactivés en suivant, mais cela doit être prévu par les administrateurs dans le cadre d'une procédure de mise à jour personnalisée, qui complète celle prévue par BlueMind.

Il est aussi possible d'étendre le virtual host de BlueMind via les fichiers /etc/nginx/bm-local.d/*.conf.

Dernière mise à jour le