Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Commentaire: Published by Scroll Versions from space DA and version BM-3.5
Sv translation
languagefr
Avertissement
titleEffectuer une sauvegarde de l'ensemble du système

BlueMind porte beaucoup d'efforts pour assurer la fiabilité des mises à jour. Cependant nul n'est à l'abri de cas particuliers non testés, ou de facteurs externes pouvant conduire à des pertes de données. BlueMind n'est pas responsable en cas d'échec de mise à jour qui pourrait corrompre un système installé.

Il est de votre responsabilité de vous assurer de ce risque en effectuant une sauvegarde complète de votre système.

Avertissement
titleMise à jour de la distribution Linux

Le changement de distribution Linux vers une version majeure supérieure (Debian 7 vers Debian 8 par exemple) ne doit pas être réalisée avec les mécanismes automatiques de mise à jour des distributions (changement des sources de paquet et utilisation de la commande aptitude dist-upgrade). En effet, les dépendances de BlueMind peuvent être modifiées et le bon fonctionnement des services BlueMind risque d'être impacté.

Pour un changement de version majeure de la distribution, il est nécessaire de passer par une migration de serveur. Veuillez contacter votre prestataire intégrateur ou nous contacter via notre plate-forme de tickets.

Volet
borderWidth3

Sur cette page :

Sommaire
maxLevel2

En rapport :
Installation
Mise en œuvre de la souscription

Mise à jour de BlueMind

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 :

  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.

Signature des dépôts

Les dépôts sont désormais signés pour toutes les distributions Ubuntu/Debian supportées.

Cette signature est obligatoire pour Ubuntu 18.04 et Debian 9 dont le support est apporté par BlueMind 3.5.9.

Il est possible, si nécessaire ou désiré, d'importer manuellement la clé sur l'ensemble de nos distributions supportées via la commande suivante :

Bloc de code
curl https://pkg.bluemind.net/bluemind-deb.asc | apt-key add -

Sans cela, un warning peut survenir lors de la mise à jour de certaines versions précédentes sans que cela gêne pour autant la mise à jour.

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
    borderall-sides
    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
    borderall-sides
    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 :

  • se rendre dans la gestion des tâches planifiées de la console d'administration > Gestion Système > Tâches planifiées
  • sélectionner le domaine "global.virt" dans la liste déroulante en haut à droite de la page
  • sélectionner la tâche planifiée ConsolidateMailSpoolIndexJob, chargée de l'indexation, des messages et elle seule puis cliquer sur "Exécuter maintenant" :

    Info

    La tâche d'indexation 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.

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 :

  • 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
    titleEstimation 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é.

Multi-serveur

Dans le cas d'une installation avec serveur Edge, il faut modifier la configuration Nginx du serveur Edge, la nouvelle configuration est disponible ici : Installation d'un serveur Edge : Nginx et Postfix

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 l a 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 :

  1. Mise à jour de BlueMind dans la dernière version 3.0.x disponible
  2. Attente (ou forçage) des synchronisations et mises à jour des connecteurs Outlooks des postes clients en 3.0.x
  3. Mise à jour de BlueMind en 3.5 (voir ci-dessus)
  4. Attente des synchronisations et mises à jour des connecteurs Outlooks en 3.5
  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
titleOutlook 32bits
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
titleOutlook 64bits
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
titleBlueMind 3.5 seulement
$ curl -k https://localhost/settings/settings/download/outlookx64?file=VERSION
3.1.23247
Bloc de code
titleBlueMind 3.0 et 3.5
$ curl -k https://localhost/settings/settings/download/outlookx64?file=BUILD_NUMBER
23247
Sv translation
languageen
Avertissement
titlePerform a full system backup

BlueMind makes every effort to provide reliable updates. In some special untested cases or due to external circumstances, however, data may be lost unexpectedly. BlueMind may not be held responsible for any possible update failure leading to system corruption.

It is your responsibility to prevent this risk by performing a complete system backup.

Avertissement
titleLinux Upgrades

Major Linux distribution upgrades (Debian 7 to Debian 8, etc.) must not be performed using automatic distribution update mechanisms (changing package sources and using the aptitude dist-upgrade command) because this may change BlueMind dependencies which may impact BlueMind services.

To perform major distribution upgrades, you must perform a server upgrade. Please contact your integrator service provider or contact us via our ticket platform.

Volet
borderWidth3

On this page:

Sommaire
maxLevel2

Related:
Installation
Mise en œuvre de la souscription

Mise à jour de BlueMind

Introduction

Updating BlueMind from a major version to another is an extremely particular operation: as subscriptions and packages vary from one version to the next, the lower version is unable to apply new elements.

This is why we provide a detailed description of the BlueMind 3.0 to BlueMind 3.5 update procedure in this page. Please make sure you read the entire procedure in order to be familiar with the order of operations, in particular if your IT equipment includes machines using the Outlook connector.

For any other simple update, please refer to the dedicated page: Updating BlueMind

Prerequisites

Pre-Update version

Before you update to BlueMind 3.5, you must have the latest 3.0 version installed. To find the latest available version, please refer to our downloads page: https://download.bluemind.net/bm-download/3.0

If the most up-to-date version of BlueMind isn't installed, then update it (Updating BlueMind).

Outlook Connectors

Specific operations are required before updating to BlueMind 3.5. If your IT equipment includes machines using the Outlook connector, please refer to the paragraph at the bottom of this page: Updating the Outlook connector.

Accessing the installation wizard

To perform the update, you need to access the installation wizard (http://<your.server.com>/setup) for which a password was provided during the installation of BlueMind.

If this password was lost, there are two ways to reset it:

  1. Before any installation operation, access the admin console as global admin0 > System Management > System Configuration > "Reverse Proxy" tab:
    fill in the new password and save.
  2. By command line:
    • log into the BlueMind server as root and type the following command line:

      Bloc de code
      rm -f /etc/nginx/sw.htpasswd; htpasswd -b -c /etc/nginx/sw.htpasswd admin admin
    • log into the /setup url and use "admin/admin" as username and password 
      You MUST perform this step, even if you are in the process of performing the BlueMind update.

Repository signature 

Repositories are now signed for all supported Ubuntu/Debian distributions.

Repository signature is required for Ubuntu 18.04 and Debian 9 which are supported by BlueMind 3.5.9.

You may, if you need or want to, manually import the key on all our supported distributions using the following command:

Bloc de code
curl https://pkg.bluemind.net/bluemind-deb.asc | apt-key add -

Otherwise, a warning may come up during earlier version updates. This will not disrupt updates however.

Procedure

Info
titleAbout backups

BlueMind 3.0 backups cannot be used in version 3.5. There is therefore no need to keep them on the server. Make sure you remove them before or right after updating in order to free up space for future 3.5 backups.

Remarque

Before you update, make sure your 3.5 subscription matches your number of BlueMind users.

The update process requires specific subscription installation steps: before you are able to update to BlueMind 3.5 your subscription must be up to date and in the future version BEFORE you are able to install the new subscription-specific installation package.

  • Install the required packages:

    • bm-setup-wizard: a special version of the installation and update wizard
    • bm-plugin-core-lic: in-application subscription information display tool
    • apt-transport-https : allows access to BlueMind repository in https (in BlueMind 3.0 the package wasn't required because repository was accessible in http mode, which is not permitted anymore)
    Tabs group
    borderall-sides
    Debian/UbuntuRedHat/CentOS

    NB: if you've already performed updates on your BlueMind install (e.g. to update from BlueMind 3.0.39 to 3.0.40), these packages may already be installed. In this case, simply move on to the next steps.

  • Restart BlueMind:

    Bloc de code
    bmctl restart
  • Update the subscription with the new version 3.5 subscription from the admin console:
    • while logged in as admin0, go to System Management > Install a subscription
    • using the "Update the subscription" button, search for the file containing the subscription key provided by BlueMind and open it.
      BlueMind installs the subscription.
      Registration is immediate and doesn't require you to restart BlueMind.
  • Update the packages on the server (on all servers concerned):

    Bloc de code
    aptitude update
    aptitude dist-upgrade
  • The following new packages are available:

    • bm-plugin-core-subscription: subscription management
    • bm-connector-outlook* and bm-plugin-core-outlook*: Outlook connector
    • bm-plugin-core-ad-import*: ActiveDirectory import tool

    * optional packages, to be installed as needed

    On the main server, install the new packages and restart the BlueMind service:

    Tabs group
    borderall-sides
    Debian/UbuntuRedHat/CentOS
  • Connect to the update url: https://<your server>/setup and follow the installation wizard's instructions:

    NB: version numbers may vary

  • When the update is complete, the BlueMind welcome page opens and the wizard displays access links to the applications:

Post-install actions 

Email indexing

Once the update is complete, you must run message indexing jobs.

To do this, while logged in as admin0 :

  • go to the scheduled jobs page in the admin console > System Management > Scheduled Jobs
  • select "global.virt" domain in the combobox on top-right of the page
  • select the scheduled job named ConsolidateMailSpoolIndexJob which is responsible for message indexing – this job only – then click "Start now":

    Info

    The message archiving job may take a long time – it processes 16Gb of data in 4,600 seconds (i.e. 1 hour 12 mins). However, the process is transparent to users who can continue to use BlueMind in the meantime.

    Astuce

    As users' messages are indexed, the new search engine will appear in their webmail. All users will therefore neither see it as soon as the system update is complete nor at the same time.

Backups

Old backups not being usable with the new version, make sure you delete them from the server if you haven't done so at the beginning of the update procedure.

In order to have a usable backup, run DataProtect as soon as the update is complete.

Cyrus configuration

After updating, the maximum number of imap processes allowed by Cyrus must be set again.

To do this, you can either edit the file /etc/cyrus.conf using command line, or – as of now -- set it in the BlueMind admin console:

  • log into the admin console as admin0
  • go to System Management > System Configuration > Mail tab
  • in the Cyrus section, enter the desired value in the "max child" box:

    Info
    titleCalculating the approximate number of processes required

    In general, consider approximately 1.5 times the number of users for mixed webmail/thick client use. On installs with many users using thick clients, allow for approximately 3 times the number of users.

    To calculate the number of processes used currently:

    pgrep -c imap
  • click "Save" to apply changes.
    Cyrus restarts automatically.

Ancre
migration-connecteur-outlook
migration-connecteur-outlook
Updating the Outlook connector

Foreword: about version 3.0 before updating

The Outlook connector uses a Windows service dedicated to its own updates: AutoUpdateService

Before you are able to download a new major BlueMind version such as 3.5, the Outlook connector (and in particular its update service) must be in a version recent enough to be able to handle downloading and installing the next version. Only connectors installed in version 3.0.39 (technical version 3.0.14366) or above are able to download version 3.5 and update correctly.

Checking the connector's version on a computer

To find out what connector version you have installed, hover over the BlueMind synchronization logo in Outlook, without clicking: a tooltip appears, showing the connector version:

If the version number is equal to or greater than 3.0.14366, or starts with 3.1, then the connector is compatible.

Astuce

The number shown is the build number, i.e. technical version of BlueMind. If it starts with "3.0", then it refers to BlueMind 3.0.x, if it starts with 3.1, then it refers to BlueMind 3.5.x.

This number can be found on the BlueMind download page where you can track the corresponding software version: https://download.bluemind.net/bm-download/

Update sequence of operations 

When moving to BlueMind 3.5, it is common, and possibly necessary (see above), to update to the latest 3.0.x version before moving to the latest 3.5.x.

You must therefore be very careful with the sequence of operations so that the connectors from versions earlier than 3.0.39 can be updated.

For example: you want to update from 3.0.36 to 3.5.5-4.

  • First you need to update the server from 3.0.36 to 3.0.39.
  • Older connector versions (which includes 3.0.36) only start checking for updates after the first successful synchronization. The server must therefore stay in version 3.0.39 until all client machines using Outlook have retrieved version 3.0.39 of the connector and in particular its new update service.
    As the connector's service only checks for updates every hour, you must wait at least one full hour to make sure that as many machine connectors as possible have correctly moved to 3.0.39.
  • If this timespan has not been reached or not all machines were running, you will have to install connector 3.5 manually on all Outlook clients that had not reached version 3.0.39 before the server switching to 3.5.

The typical sequence of operations is:

  1. Updating BlueMind to the latest 3.0.x version available
  2. Waiting for (or forcing) the synchronization and update of Outlook connectors on client machines running 3.0.x
  3. Updating to BlueMind 3.5 (see above)
  4. Waiting for synchronization and update of Outlook connectors to 3.5
  5. If needed, manually updating the connectors that haven't been updated automatically.

Monitoring/Checking update status

The file /var/log/nginx/access.log is used to view http requests made by the connector update service.

3.0 requests either look like this:

Bloc de code
titleOutlook 32bits
10.1.100.135 - - [19/Jul/2017:08:41:56 +0200] "GET /settings/settings/download/outlookx86?file=BUILD_NUMBER HTTP/1.1" 200 6 "-" "-"

or like this:

Bloc de code
titleOutlook 64bits
10.1.100.135 - - [19/Jul/2017:08:41:56 +0200] "GET /settings/settings/download/outlookx64?file=BUILD_NUMBER HTTP/1.1" 200 6 "-" "-"

The IP shown (10.1.100.135) typically is the client machine's. If devices or proxys are placed between the machines and the BlueMind nginx server, the IP address shown may belong to these devices. It is therefore up to network administrators to know where to locate the information needed to re-assign requests to client machines.

The request shown here for example purposes, shows a connector checking for its own updates. If an update is available, a second request follows, this time to download the new connector:

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

After this request, you can consider the connector on the machine with IP number 10.1.100.135 as up to date.

3.5.x connector/update service requests are slightly different. They include the key word VERSION instead of 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 "-" "-"

When you go on the server, you can check which version the update service returns:

Bloc de code
titleBlueMind 3.5 only
$ curl -k https://localhost/settings/settings/download/outlookx64?file=VERSION
3.1.23247
Bloc de code
titleBlueMind 3.0 and 3.5
$ curl -k https://localhost/settings/settings/download/outlookx64?file=BUILD_NUMBER
23247

Known bugs and workarounds

Redhat/centos servers with BlueMind versions < 3.5.5-5

The Outlook connector package is incomplete in versions 3.5 earlier than 3.5.5-5

You can work around this issue by running the following command on the BlueMind server:

Bloc de code
/usr/share/bm-connector-outlook/repack-cert.sh