Présentation
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
Pré-requis
Version avant mise à jour
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.
Connecteurs Outlook
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.
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 :
- 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. - La modification peut aussi se faire en ligne de commande :
Procédure
Info |
---|
title | À propos des sauvegardes |
---|
|
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. |
Remarque |
---|
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 :
- bm-setup-wizard : version spéciale de l'assistant d'installation et mise à jour
- bm-plugin-core-lic : outil d'affichage des informations de souscription dans l'application
- apt-transport-https : permet l'accès https aux dépôts logiciels (en 3.0 ce paquet n'était pas nécessaires, les dépôts étant accessibles en http, ce qui n'est pas le cas en 3.5)
Tabs group |
---|
|
Debian/UbuntuRedHat/CentOS |
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 :
Bloc de code |
---|
bmctl restart |
- Mettre à jour la souscription avec la nouvelle souscription en version 3.5 depuis la console d'administration :
- connecté en admin0, se rendre dans Gestion du système > Installer une souscription
- Au moyen du bouton "Mettre à jour la souscription", rechercher le fichier contenant la clé de souscription fourni par BlueMind et l'ouvrir.
BlueMind installe la souscription.
La prise en compte est immédiate et ne nécessite pas de redémarrage de BlueMind.
Effectuer une mise à jour des paquets sur le serveur (à appliquer sur toutes les machines concernées) :
Bloc de code |
---|
aptitude update
aptitude dist-upgrade |
Les nouveaux paquets suivants sont disponibles :
- bm-plugin-core-subscription : gestion de la souscription
- bm-connector-outlook* et bm-plugin-core-outlook* : connecteur Outlook
- bm-plugin-core-ad-import* : outil d'import ActiveDirectory
* paquets optionnels, à installer suivant vos besoins
Sur la machine principale, installer les nouveaux paquets et redémarrer le service BlueMind :
Tabs group |
---|
|
Debian/UbuntuRedHat/CentOS |
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
- Lorsque la mise à jour est terminée, l'accès à BlueMind est rouvert et l'assistant propose les liens d'accès à l'application :
Actions post-installation
Indexation des emails
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 :
Sauvegarde
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.
Paramétrage Cyrus
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 :
Ancre |
---|
| migration-connecteur-outlook |
---|
| migration-connecteur-outlook |
---|
|
Mise à jour du connecteur Outlook
Préambule : à propos de la version 3.0 avant mise à jour
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.
Vérifier la version du connecteur sur un poste
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.
Astuce |
---|
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/ |
Ordres des opérations lors d'une mise à jour
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.
- On passe tout d'abord le serveur de 3.0.36 à 3.0.39.
- Les versions anciennes du connecteur (la 3.0.36 en fait partie) ne commencent la vérification des mises à jour qu'à la fin d'une première synchronisation réussie. Il faut donc que le serveur reste en 3.0.39 jusqu'à ce que tous les postes clients utilisateurs d'Outlook aient récupéré la version 3.0.39 du connecteur et surtout de son nouveau service de mise à jour.
Le service du connecteur ne vérifiant les mises à jour que toutes les heures, il faudra donc attendre au moins 1h complète afin de s'assurer qu'un maximum de postes aient un connecteur correctement passé en 3.0.39. - Si ce temps n'est pas atteint ou si tous les postes ne sont pas allumés et opérationnels, il faudra par la suite installer manuellement le connecteur 3.5 sur les Outlooks qui n'auraient pas atteint la version 3.0.39 avant le passage du serveur en 3.5.
L'ordre des opérations, de façon générale, est donc :
- Mise à jour de BlueMind dans la dernière version 3.0.x disponible
- Attente (ou forçage) des synchronisations et mises à jour des connecteurs Outlooks des postes clients en 3.0.x
- Mise à jour de BlueMind en 3.5 (voir ci-dessus)
- Attente des synchronisations et mises à jour des connecteurs Outlooks en 3.5
- Si nécessaire, mise à jour manuelle des connecteurs pour lesquels la mise à jour automatique n'a pas eu lieu
Superviser / Vérifier les états de mise à jour
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 :
Bloc de code |
---|
|
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 :
Bloc de code |
---|
|
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 :
Bloc de code |
---|
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 :
Bloc de code |
---|
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 :
Bloc de code |
---|
title | BlueMind 3.5 seulement |
---|
|
$ curl -k https://localhost/settings/settings/download/outlookx64?file=VERSION
3.1.23247 |
Bloc de code |
---|
|
$ curl -k https://localhost/settings/settings/download/outlookx64?file=BUILD_NUMBER
23247 |
Bugs connus et contournements
Serveur redhat / centos en version bluemind < 3.5.5-5
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 :
Bloc de code |
---|
/usr/share/bm-connector-outlook/repack-cert.sh |