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 :

     Bloc de code
     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 :

   Bloc de code
   language bash title Debian/Ubuntu
   aptitude update aptitude upgrade

   Remarque
   title Changement de version majeure
   Dans le cas d'une mise à jour de version majeure de BlueMind il faut utiliser les commandes suivantes : Bloc de code language bash title Debian/Ubuntu aptitude update aptitude dist-upgrade

   Bloc de code
   language bash title RedHat
   yum makecache yum upgrade

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

   Info
   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" :
  

  Info
  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.

  Astuce
  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 :
  

  Info
  title 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é.

Introduction

The BlueMind subscription provides a simplified update system which has been tested and saves having to perform a migration procedure.

Updating BlueMind to a corrective or adaptive version is made easier, safer and faster thanks to the graphic admin tool.

About configuration files

Update procedure

Prerequisite: access to the setup wizard

In order to perform updates, you must have access to the setup wizard (https://<your.server.com>/setup) for which you were provided a password at the end of the post-installation process.

In case you lost this password, there are two ways of recovering it:

1. Before any installation operation: Access the administration console as global administrator admin0 and go to System management > System configuration > "Reverse proxy" tab: enter the new password and save.
2. Using command line in console mode:
   

   • connect to the BlueMind server as root and type the following command:

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

   • connect to the /setup URL using admin/admin as username/password
     This step is necessary even if you have not reached the update step yet.

Update instructions

The BlueMind subscription enables software updates via software repositories when a new release is available.

Repositories are registered as soon as the subscription is installed, as a result, BlueMind will be updated automatically when the system is updated.

Updates, whether minor or major, are performed using the same command lines as for installation and must be applied to all the devices concerned:

1. connect to the server as root

2. enter the commands below, depending on your OS:

   Bloc de code
   language bash title Debian/Ubuntu
   aptitude update aptitude upgrade

   Remarque
   title Major release
   For a major update, use the following: Bloc de code language bash title Debian/Ubuntu aptitude update aptitude dist-upgrade

   Bloc de code
   language bash title RedHat
   yum makecache yum upgrade

3. Using your web browser, go to the setup wizard https://<votre.serveur.com>/setup:
   

   Click "Update" to start the automatic update process:
   

   Once this is done, a message informs you that configuration was successful:
   
   BlueMind is then available at its usual url.

Migrating to BlueMind 3.5

Updating the BlueMind subscription

To be able to migrate to BlueMind 3.0, your subscription must be up to date.

To do this, you must go over the Setting up Subscriptions procedure in order to install the new packets: a dedicated packet is now needed and the list of packets to install subsequently has been modified.

Updating BlueMind

The update procedure is the same as described in the previous chapter.

Post-installation actions

Email indexation

Once the update is complete, you must perform an email indexation.

Log into BlueMind as global administrator admin0:

• go to System Management > Scheduled jobs

• select ReconstructMailSpoolIndexJob (responsible for indexing emails), making sure you select this job only, and click "Start now":
  

  Info
  Email indexation may take a while – 16Gb of data processed every 4600 seconds (1h12). However, it is transparent for users who can continue using BlueMind as usual in the meantime.

  Astuce
  As their messages are indexed, users will see the new search engine appear in their webmail interface. This means that all users will not see the new search engine immediately when the update is completed nor all at the same time.

Cyrus Configuration

After a migration, you must set the maximum the number of imap processes allows by Cyrus again.

To do this, you can either edit the /etc/cyrus.conf file directly on the command line or, you can now edit it in the BlueMind admin console:

• connect to the admin console as admin0
• go to System Management > System Configuration > Mail tab

• In the Cyrus section, enter the value you want in the "max child" box:
  

  Info
  title Estimating the number of processes required
  Typically, allow 1.5 times the number of users for a mixed webmail/thick client use. On installations where many users use thick clients, allow for approximately 3 times the number of users. To count the current number of processes used: pgrep -c imap

• click "Save" sur to apply the changes.
  Cyrus restarts automatically.