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

Une fois la mise à jour effectuée, il est nécessaire d'effectuer les tâches d'indexations des mails et de l'archivage afin que le nouveau moteur de recherche puisse être accessible.

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 MailSpoolIndexJob, 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.

• Une fois la tâche d'indexation des mails terminée exécuter de la même façon la tâche ArchiveSpoolIndexJob, chargée de l'indexation des messages archivés.

  Astuce
  Au fur et à mesure de l'indexation des messages archivés, les utilisateurs auront accès à la recherche complète au sein des messages archivés, il se peut donc qu'une fois le moteur de recherche apparu (tâche précédente) tous les messages ne figurent pas encore dans les résultats.

BlueMind update process

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

Process

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

Once the update is complete, you must perform email and archive indexation for the new search engine to be available.

Log into BlueMind as global administrator admin0:

• go to System Management > Scheduled jobs

• select MailSpoolIndexJob, in charge of indexing emails, and this one 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. As a result, all users will not see the new search engine immediately when the update is completed nor all at the same time.

• When the email indexation job is complete, proceed the same way with the ArchiveSpoolIndexJob, in charge of archived emails indexation.

  Astuce
  As archived messages are indexed, users will have full access to search archived messages. So even if the new search engine appears (previous job), users may not see all messages in the results. This will be effective when all their messages are indexed.