La mise à jour de BlueMind d'une version majeure à une autre est une opération de mise à jour particulière : en effet, d'une version à l'autre les souscriptions et paquets nécessaires diffèrent et, par conséquent, la version inférieure ne sait pas prendre en compte les nouveaux éléments.
C'est pourquoi cette page détaille ici les opérations à réaliser lors d'une mise à jour permettant de mettre à jour BlueMind 3.0 en BlueMind 3.5. Prenez le temps de lire l'intégralité de la procédure afin de bien maîtriser l'ordre des opérations, notamment si votre parc informatique comporte des postes utilisant le connecteur Outlook.
Pour toute autre opération de mise à jour simple, veuillez vous reporter à la page dédiée : Mise à jour de BlueMind
Avant de migrer BlueMind, il est nécessaire que celui-ci soit dans la version la plus récente de 3.0. Pour connaître la dernière version disponible, consulter notre page de téléchargement : https://download.bluemind.net/bm-download/3.0
Si BlueMind n'est pas dans la dernière version, alors procéder à une Mise à jour de BlueMind.
Des opérations sont nécessaires au préalable à la mise à jour vers BlueMind 3.5, si votre parc informatique comporte des postes utilisant le connecteur Outlook consulter le paragraphe dédié en fin de la présente page : Mise à jour du connecteur Outlook.
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 :
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 |
Les sauvegardes de BlueMind 3.0 ne sont pas utilisables en 3.5, il devient donc inutile de les conserver sur la machine. Assurez-vous de les supprimer du serveur avant la mise à jour ou juste après avoir effectué celle-ci afin de libérer de l'espace en vue des sauvegardes 3.5 à venir. |
Assurez-vous, avant la mise à jour, que votre souscription 3.5 correspond aux nombre d'utilisateurs de votre BlueMind |
Dans le cas d'une mise à jour, l'ordre des étapes d'installation de la souscription est particulier : afin de pouvoir migrer vers BlueMind 3.5, votre souscription doit être à jour et dans la future version AVANT de pouvoir installer le nouveau paquet dédié à la souscription elle-même.
Installer les paquets nécessaires :
|
NB : si vous avez déjà réalisé une opération de mise à jour sur votre installation (par exemple pour passer du BlueMind 3.0.39 à 3.0.40), ces paquets peuvent être déjà installés. Dans ce cas vous pouvez simplement passer aux étapes suivantes.
Redémarrer BlueMind :
bmctl restart |
Effectuer une mise à jour des paquets sur le serveur (à appliquer sur toutes les machines concernées) :
aptitude update aptitude dist-upgrade |
Les nouveaux paquets suivants sont disponibles :
* paquets optionnels, à installer suivant vos besoins
Sur la machine principale, installer les nouveaux paquets et redémarrer le service BlueMind :
|
Se connecter à l'url de gestion des mises à jour : https://<votre serveur>/setup et suivre l'assistant de mise à jour :
NB : les numéros de versions peuvent varier
Une fois la mise à jour effectuée, il est nécessaire d'effectuer les tâches d'indexations des messages.
Pour cela, connecté en tant qu'admin0 :
sélectionner la tâche planifiée ConsolidateMailSpoolIndexJob, 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. |
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. |
Les anciennes sauvegardes n'étant plus utilisables, il convient de les supprimer du serveur si cela n'a pas été déjà fait en début de procédure.
Afin d'avoir une sauvegarde à jour utilisable, lancez dès la fin de la procédure de mise à jour la tâche DataProtect.
Après la mise à jour, 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 :
dans la section Cyrus, renseigner le champs "max child" avec la valeur souhaitée :
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 |
Le connecteur Outlook utilise un service Windows dédié à sa propre mise à jour : AutoUpdateService
Afin d'être capable de télécharger une nouvelle version majeure du connecteur telle que la 3.5, le connecteur (et surtout son service de mise à jour) doit être dans une version suffisante pour savoir effectuer correctement le téléchargement et l'installation de la version suivante. Ainsi, seuls les connecteurs installés en version 3.0.39 (version technique 3.0.14366) ou supérieures sont capables de télécharger une version 3.5 et se mettre à jour correctement.
Pour connaître la version du connecteur installée, placer la souris sur le logo de synchronisation de BlueMind dans Outlook, sans cliquer : une infobulle apparaît au survol, indiquant la version du connecteur :
Si le numéro est égal ou supérieur à 3.0.14366 ou commence par 3.1 alors le connecteur est compatible.
Le numéro de version indiqué correspond au numéro de build (construction) ou "version technique" de BlueMind. S'il commence par "3.0" alors il s'agit de BlueMind 3.0.x, s'il commence par 3.1 alors il s'agit de BlueMind 3.5.x. Ce numéro peut être retrouvé sur la page de téléchargement de BlueMind afin de s'assurer de la version correspondante : https://download.bluemind.net/bm-download/ |
Il est courant, voire nécessaire (cf. ci-dessus) lors d'un passage de 3.0.x à 3.5.x de mettre d'abord à jour BlueMind vers la dernière 3.0.x avant de passer sur la dernière 3.5.x.
Il faut alors faire très attention à l’enchaînement des opérations afin que les connecteurs de version antérieures à 3.0.39 puissent être mis à jour.
Par exemple : on désire migrer de 3.0.36 en 3.5.5-4.
L'ordre des opérations, de façon générale, est donc :
Le fichier /var/log/nginx/access.log
permet de voir les requêtes http effectuées par le service de mise à jour du connecteur.
Les requêtes de la 3.0 se présentent comme ceci :
10.1.100.135 - - [19/Jul/2017:08:41:56 +0200] "GET /settings/settings/download/outlookx86?file=BUILD_NUMBER HTTP/1.1" 200 6 "-" "-" |
ou comme ceci :
10.1.100.135 - - [19/Jul/2017:08:41:56 +0200] "GET /settings/settings/download/outlookx64?file=BUILD_NUMBER HTTP/1.1" 200 6 "-" "-" |
L'ip présentée (10.1.100.135) est normalement celle du poste client. Si des équipements ou proxys sont placés entre les postes et le serveur nginx de BlueMind, il est possible que l'adresse ip présentée soit celle de ces équipements. C'est alors aux administrateurs réseau de savoir où trouver l'info pour ré-associer les requêtes avec les postes clients.
La requête en exemple est celle d'un connecteur qui vérifie si une mise à jour est disponible pour lui. Si c'est le cas, une seconde requête suit, correspondant au téléchargement du nouveau connecteur :
10.1.100.135 - - [19/Jul/2017:08:41:57 +0200] "GET /settings/settings/download/outlookx86?file=SetupAddin.msi HTTP/1.1" 200 8037888 "-" "-" |
Après cette requête, vous pouvez considérer le connecteur du poste à l'ip 10.1.100.135 comme à jour.
Les requêtes d'un connecteur / service de mise à jour 3.5.x sont légèrement différentes, elles comportent le mot clef VERSION à la place de BUILD_NUMBER :
10.1.101.137 - - [19/Jul/2017:09:08:56 +0200] "GET /settings/settings/download/outlookx86?file=VERSION HTTP/1.1" 200 9 "-" "-" |
En se plaçant sur le serveur, il est possible de vérifier la version renvoyée par le service de mise à jour :
$ curl -k https://localhost/settings/settings/download/outlookx64?file=VERSION 3.1.23247 |
$ curl -k https://localhost/settings/settings/download/outlookx64?file=BUILD_NUMBER 23247 |
Le paquet du connecteur outlook est incomplet sur les versions 3.5 inférieures à 3.5.5-5
Il est possible de contourner le problème en lançant sur le serveur bluemind la commande suivante :
/usr/share/bm-connector-outlook/repack-cert.sh |