Présentation

La souscription BlueMind apporte un système de mise à jour simplifié et testé permettant d'éviter une procédure avec migration.

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 à l'outil graphique d'administration.

Note sur les fichiers de configuration

Procédure de mise à jour de BlueMind

Pré-requis : accès à l'assistant d'installation

Afin d'effectuer la mise à jour, il est nécessaire d'accéder à l'assistant d'installation (url http://<votre.serveur.com>/setup ) pour lequel le mot de passe a été fourni lors de l'installation de BlueMind.

En cas de perte, ce mot de passe peut être réinitialiser de 2 façons :

1. Avant toute opération d'installation, en accédant à la console d'administration en tant qu'administrateur global admin0 > Gestion du système > Configuration Système > onglet «Serveur Mandataire» :
   remplir le nouveau mot de passe et enregistrer.
2. La modification peut aussi se faire en ligne de commande :
   

   • se connecter au serveur BlueMind en tant que root et taper la ligne suivante :

     rm -f /etc/nginx/sw.htpasswd; htpasswd -b -c /etc/nginx/sw.htpasswd admin admin

   • se connecter à l'URL /setup et utiliser le login et mot de passe admin/admin
     Cette étape est impérative, même si vous n'en êtes pas encore à l'étape de mise à jour de BlueMind.

Procédure

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

Quel que soit son type (version mineure ou majeure), la mise à jour de BlueMind se fait au moyen des commandes déjà utilisées lors de l'installation (à appliquer sur toutes les machines concernées) :

1. se connecter sur le serveur à mettre à jour en tant que root

2. lancer les commandes suivantes en fonction du système d'exploitation :

   Debian/Ubuntu

   aptitude update
   aptitude upgrade
   

   Changement de version majeure

   Dans le cas d'une mise à jour de version majeure de BlueMind il faut utiliser les commandes suivantes :

   Debian/Ubuntu

   aptitude update
   aptitude dist-upgrade
   

   RedHat

   yum makecache
   yum upgrade

3. se rendre avec un navigateur sur l'interface de gestion des mises à jour http://<votre.serveur.com>/setup :
   

   L'ouverture du gestionnaire de mise à jour requiert un mot de passe, il s'agit du mot de passe "Assistant d'installation" donné à la fin de la procédure initiale d'installation de BlueMind.

   En cas de perte du mot de passe, il peut être repositionné par l'administrateur dans la console d'administration à la rubrique Gestion du Système > Serveur Mandataire

    

   Cliquer sur le bouton «Mise à jour» afin de lancer la procédure automatique de configuration de BlueMind :
   Une fois que cette procédure est finie, un message vous informe du bon déroulement de la procédure :
   
   L'accès à BlueMind est dès lors possible à son url habituelle

Migration vers BlueMind 3.5

Mise à jour de la souscription

Afin de pouvoir migrer vers BlueMind 3.5, votre souscription doit être à jour.

Pour cela, il vous faut reprendre la procédure de Mise en œuvre de la souscription afin d'installer les nouveaux paquets : un paquet dédié est désormais nécessaire et la liste des paquets à installer par la suite est modifiée.

Mise à jour de BlueMind

La procédure de mise à jour est la même que celle décrite au chapitre précédent.

Actions post-installation

Indexation des mails

Une fois la mise à jour effectuée, il est nécessaire d'effectuer les tâches d'indexations des mails.

Pour cela, connecté en tant qu'admin0 :

• se rendre dans la gestion des tâches planifiées de la console d'administration > Gestion Système > Tâches planifiées

• sélectionner la tâche planifiée ReconstructMailSpoolIndexJob, chargée de l'indexation, des messages et elle seule puis cliquer sur "Exécuter maintenant" :
  

  La tâche d'archivage des messages peut s'avérer de très longue durée. En effet, celle-ci s'effectue au rythme de 4600 secondes (soit 1h12) pour 16Go de données.
  Cependant elle reste transparente pour les utilisateurs qui peuvent utiliser BlueMind normalement pendant toute sa durée.

  Au fur et à mesure de l'indexation des messages des utilisateurs, ceux-ci verront apparaître dans leur webmail le nouveau moteur de recherche. Tous les utilisateurs ne le verront donc pas dès la fin de la mise à jour système ni tous en même temps.

Paramétrage Cyrus

Après la migration, il est nécessaire de re-paramétrer le nombre maximal de processus imap permis par Cyrus.

Pour cela, vous pouvez éditer directement le fichier /etc/cyrus.conf en ligne de commande ou faire désormais cette modification dans la console d'administration BlueMind :

• se connecter en admin0 à la console d'administration
• se rendre dans Gestion du système > Configuration système > onglet Messagerie

• dans la section Cyrus, renseigner le champs "max child" avec la valeur souhaitée :
  

  Estimation du nombre de processus nécessaires

  En général, il faut compter environ 1.5 fois le nombre d'utilisateurs pour une utilisation mixte webmail/client lourds. Sur les installations où beaucoup d'utilisateurs utilisent des clients lourds on comptera environ 3x le nombre d'utilisateurs.

  Compter le nombre de processus utilisés actuellement :

  pgrep -c imap
• cliquer sur « Enregistrer » pour prendre en compte les modifications.
  Cyrus est automatiquement relancé.