Présentation

La souscription BlueMind apporte un système de mise à jour simplifié et testé.

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.

Prérequis

Souscription

Pour accéder aux outils de mise à jour de BlueMind, il est nécessaire de posséder et d'avoir installé une souscription en cours de validité.

Ancre
setup-passwd setup-passwd

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.

Ancre
signature-depot signature-depot

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 :

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.

Points de vigilance

De même qu'avant une installation de BlueMind 4, nous conseillons la lecture attentive de la page Deploiement BlueMind 4 - points de vigilance avant une mise à jour de version importante.

Mise à jour 4.0 vers 4.1

Dossiers sous la boîte de réception

Dans les versions 4.0.x de BlueMind (4.0.x), les dossiers créés sous la boîte de réception par Outlook ne sont pas des dossiers de messagerie mais des dossiers virtuels. BlueMind 4.1 apporte le support des sous-dossiers de la boîte de réception (inbox).

Dans le cadre d'une mise à jour de BlueMind 4.0.x vers 4.1, les dossiers virtuels éventuellement créés par les utilisateurs ne seront pas migrés et seront supprimés. Pour se prémunir de cela, il est donc conseillé de déplacer ces dossiers virtuels en dehors de la boîte de réception avant la mise à jour de façon à les conserver, ils pourront ensuite y être remis et seront recréés en tant que dossiers de messagerie.

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.

Ancre
prepare-install prepare-install

Préparer la mise à jour

Pour une mise à jour d'un BlueMind déjà en version 4.1 ou supérieure , le processus de mise à jour doit être initié. Cela permet une plus grande maîtrise des versions et limite le risque d'erreur : la version cible peut désormais être ouverte afin de toujours mettre à jour dans la dernière version publiée ou au contraire figée afin d'empêcher les mises à jour involontaires. Cela permet aussi de sécuriser le respect de la version majeure du serveur ainsi que l'installation des paquets additionnels : ils seront installés dans la version du serveur.

Cette préparation peut se faire via la console d'administration OU en ligne de commande :

• se rendre dans Gestion du système > Mise à jour de BlueMind
• Cliquer sur le bouton "Configurer" : la dernière version disponible sera installée.

Mettre à jour

Le processus de mise à jour de BlueMind commence par la mise à jour des paquets sur tous les serveurs de l'installation, au moyen des commandes déjà utilisées lors de l'installation. Les étapes 1 et 2 sont donc à appliquer sur toutes les machines concernées. Ensuite, la phase de mise à jour proprement dite sera jouée une seule fois, en se connectant à l'adresse /setup :

1. Se connecter en tant que root sur chacun des serveurs de la plate-forme

2. Mettre à jour les paquets sur chacun d'eux :

   Remarque

   Si vous souhaitez limiter le temps d'interruption des services, vous pouvez passer la commande de mise à jour avec l'option "download-only" afin dans un premier temps de ne faire que télécharger l'ensemble des paquets. N'entrainant pas d'interruption ni de ralentissement des services, cette action peut être réalisée à n'importe quel moment de la journée ou de la nuit. On pourra ensuite lancer au moment le plus opportun la commande "upgrade" de mise à jour effective des paquets, qui entrainera donc une coupure de service plus réduite.

   Tabs group
   border all-sides navcolor navy
   Debian/UbuntubashDebian/UbuntuRedhat/CentOSbashRedHat

   Répéter ces commandes sur chaque serveur de la plate-forme.

   Info
   Un warning peut survenir lors de la mise à jour de certaines versions précédentes, concernant la signature des dépôts. Cela ne gêne pas la mise à jour, il s'agit d'un simple avertissement, cependant vous pouvez y remédier : voir ci-dessus le paragraphe 2.3.c : Signature des dépôts.

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

   Astuce
   NB : cette étape nécessite le mot de passe d'accès à l'assistant d'installation - voir chapitre 2.2 ci-dessus

4. Lancer la procédure automatique de configuration de BlueMind en cliquant sur le bouton «Mise à jour»

5. 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 alors possible à son url habituelle

Annexes

Ancre
note-conf note-conf

Note sur les fichiers de configuration

Introduction

The BlueMind subscription includes a simplified, tried and tested update system.

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

Prerequisites

Subscriptions

To access BlueMind update tools, you must have a valid and current subscription installed.

Ancre
setup-passwd setup-passwd

Access to the setup wizard

Updates require 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:
   

   • Log into 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

   • Log into the /setup URL using admin/admin as username/password
     This step is required even if you have not reached the update step yet.

Ancre
signature-depot signature-depot

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:

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 or interfere with updates.

Points of Caution 

We recommend that you carefully read the page Deploiement BlueMind 4 - points de vigilance before any important version update.

Updating from 4.0 to 4.1

Inbox subfolders

In BlueMind versions 4.0.x, folders created in the inbox by Outlook are not mailbox folders but virtual folders. BlueMind 4.1 brings inbox subfolder support.

When you update from BlueMind 4.0.x to 4.1, virtual folders users may have created will not be migrated and will be deleted. To prevent this and keep these folders, we recommend that you move virtual folders outside the inbox before you perform the update. You can them put them back into the inbox where they will be created again as mail folders.

Update instructions

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

Ancre
prepare-install prepare-install

Preparing for the update

For updates from BlueMind version 4.1 or above, the process must always be prompted. This gives you greater control over versions and reduces the risk of errors: the target version can now be left open to allow updates to the latest published version or, on the contrary, it can be frozen to prevent unintentional updates. This also helps ensure that the server's major version as well as additional packages are conformed to.

This can be done in the admin console:

1. Go to System management > Update BlueMind
2. Click "Setup": the latest available version will be installed.

Update Procedure

The BlueMind update procedure begins with an update of the packages on all the installation's servers using the commands already used for installation. Steps 1 and 2 therefore must be applied to all the machines concerned. Then, the update itself will have to be played just once, by login into the /setup url:

1. Log in as root on each platform server.

2. Update the packages on each:

   Remarque
   If you want to minimize service downtime, you can pass the update command with the "download-only" option, which enables you to download all the packages ahead of the update. This does not interrupt or slow down services, which means it can be done at any time of day or night. You can then run the "upgrade" command at a more convenient time and therefore reduce service downtime.

   Tabs group
   border all-sides navcolor navy
   Debian/UbuntubashDebian/UbuntuRedhat/CentOSbashRedHat

   Repeat these commands on each platform server.

   Info
   You may get a warning message about repository signature during earlier version updates. This does not disrupt the update, it is a mere warning. To remedy this issue, please refer to 2.3.c: Repository signature above.

3. Go to the setup wizard https://<your.server.com>/setup
   
   

   Astuce
   Note: this step requires the setup wizard's password - see paragraph 2.2 above.

4. Click "Update" to start the automatic update process.
5. Once this is done, a message informs you that configuration was successful:

  BlueMind is then available at its usual url.

Appendices

Ancre
note-conf note-conf

About configuration files

Présentation

La souscription BlueMind apporte un système de mise à jour simplifié et testé.

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.

Procédure de mise à jour de BlueMind

Prérequis

Souscription

Pour accéder aux outils de mise à jour de BlueMind, il est nécessaire de posséder et d'avoir installé une souscription en cours de validité.

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.

Ancre
signature-depot signature-depot

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 :

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

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.

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

   Bloc de code
   language bash title RedHat
   yum makecache yum upgrade

   Info
   Un warning peut survenir lors de la mise à jour de certaines versions précédentes, concernant la signature des dépôts. Cela ne gêne pas la mise à jour, il s'agit d'un simple avertissement, cependant vous pouvez y remédier : voir ci-dessus le paragraphe 2.3.c : Signature des dépôts.

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

4. 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 alors possible à son url habituelle

Annexes

Ancre
note-conf note-conf

Note sur les fichiers de configuration

La configuration postfix est écrasée uniquement lors de la phase d'installation. Par la suite, cette configuration est mise à jour via la commande postconf.
Il est possible de personnaliser les fichiers de configuration comme souhaité, à l'exception de :

• enlever les maps de BlueMind : des maps peuvent en revanche être ajoutées.
• modifier mynetwork : il doit-être modifié depuis la console d'administration.
• modifier relayhost : il doit-être modifié depuis la console d'administration.

Concernant NGinx, le virtual host est écrasé à chaque mise à jour.
L'ensemble des VHost sont désactivés lors d'une mise à jour et seuls ceux de BlueMind (bm-client-acces et bm-webmail) sont ré-activé. D'autres peuvent être ré-activés en suivant, mais cela doit faire partie de la procédure de mise à jour, qui complète celle prévue par BlueMind.
Il est aussi possible d'étendre le virtual host de BlueMind via les fichiers /etc/nginx/bm-local.d/*.conf

Präsentation

Das BlueMind-Abonnement bringt ein vereinfachtes und getestetes Aktualiserungssystem mit sich.

Das Upgrade von BlueMind auf eine höhere korrigierende oder evolutionäre Version ist dann dank des grafischen Administrationstools einfacher, sicherer und schneller.

Voraussetzung

Abonnement

Um auf die BlueMind-Aktualisierungstools zuzugreifen, ist es erforderlich, ein gültiges Abonnementzu besitzen und zu installieren.

Ancre
setup-passwd setup-passwd

Zugriff auf den Installationsassistenten

Um die Aktualisierung durchzuführen, ist es notwendig, den Installationsassistenten (url<votre.serveur.com>http:///setup )</votre.serveur.com> aufzurufen<votre.serveur.com>, für den das Passwort bei der Installation von BlueMind</votre.serveur.com> angegeben wurde.

Bei Verlust kann dieses Passwort auf 2 Arten zurückgesetzt werden:

1. Rufen Sie vor der Installation die Administrationskonsole als globaler Administrator admin0 > Systemverwaltung > Systemkonfiguration > Registerkarte „Proxy-Server“ auf:
   geben Sie das neue Passwort ein und registrieren Sie sich.
2. Die Änderung kann auch auf der Befehlszeile vorgenommen werden:
   

   • verbinden Sie sich als root mit dem BlueMind-Server und geben Sie die folgende Zeile ein:

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

   • verbinden Sie sich mit der URL /setup und verwenden Sie das Login und Passwort admin/admin
     Dieser Schritt ist zwingend erforderlich, auch wenn Sie sich noch nicht in der BlueMind-Aktualisierungsphase befinden.

Ancre
signature-depot signature-depot

Unterschrift der Depots

Depots sind nun für alle unterstützten Ubuntu/Debian-Verteilungen signiert.

Diese Unterschrift ist erforderlich für von BlueMind 3.5.9 unterstützte Ubuntu 18.04 und Debian 9.

Falls notwendig oder erwünscht, kann der Schlüssel auf allen von uns unterstützten Verteilungen manuell über den folgenden Befehl importiert werden:

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

Andernfalls kann bei der Aktualisierung bestimmter Vorgängerversionen eine Warnung auftreten, ohne dass die Aktualisierung behindert wird.

Schwachstellen

Wie vor der Installation von BlueMind 4 empfehlen wir Ihnen, vor einem größeren Versionsupdate die Seite Deploiement BlueMind 4 - points de vigilance sorgfältig zu lesen.

Aktualisierung von 4.0 auf 4.1

Ordner unter dem Posteingang

In BlueMind-Versionen 4.0.x sind die von Outlook unter dem Posteingang angelegten Ordner keine E-Mail-Ordner, sondern virtuelle Ordner. BlueMind 4.1 bietet Unterstützung für Posteingangs-Unterordner.

Im Rahmen eines Upgrades von BlueMind 4.0.x auf 4.1 werden alle von Benutzern erstellten virtuellen Ordner nicht migriert und gelöscht. Daher wird empfohlen, diese virtuellen Ordner vor der Aktualisierung aus dem Posteingang zu verschieben, damit sie erhalten bleiben, und dann wieder einzuführen und als E-Mail-Ordner neu anzulegen.

Verfahren

Da Software-Depots vom System berücksichtigt werden, sobald das Abonnement installiert ist, wird BlueMind automatisch aktualisiert, wenn das System aktualisiert wird.

Ancre
prepare-install prepare-install

Vorbereitung der Aktualisierung

Für die Aktualisierung von BlueMind ab Version 4.1 oder höher , muss der Aktualisierungsprozess eingeleitet werden. Hierdurch wird Versionskontrolle verbessert und das Fehlerrisiko verringert: Die Zielversion kann geöffnet werden, um stets auf die neueste veröffentlichte Version zu aktualisieren oder im Gegenteil eingefroren zu werden, um unbeabsichtigte Aktualisierungen zu verhindern. Zudem wird die Beachtung der Hauptversion des Servers sowie die Installation zusätzlicher Pakete ermöglicht: Sie werden in der Serverversion installiert.

Diese Vorbereitung kann über die Administrationskonsole ODER die Befehlszeile erfolgen:

• gehen Sie zu Systemverwaltung > BlueMind-Aktualisierung
• Klicken Sie auf die Schaltfläche „Konfigurieren“: Die neueste verfügbare Version wird installiert.

Aktualisieren

Der BlueMind-Aktualisierungsprozess beginnt mit der Aktualisierung der Pakete auf allen Servern der Installation, wobei die bereits während der Installation verwendeten Befehle verwendet werden. Die Schritte 1 und 2 sind auf allen betroffenen Rechnernanzuwenden. Die eigentliche Aktualisierungsphase wird nur einmal durchlaufen, indem eine Verbindung zur /setup-Adresse hergestellt wird:

1. Melden Sie sich auf allen Plattform-Servern als root an

2. Aktualisieren Sie die Pakete auf allen:

   Remarque

   Wenn Sie die Ausfallzeit begrenzen möchten, können Sie den Update-Befehl mit der Option "nur-download" erteilen, um das gesamte Paket zunächst nur herunterzuladen. Da diese Aktion keine Unterbrechung oder Verlangsamung der Dienste verursacht, kann sie zu jeder Tages- und Nachtzeit durchgeführt werden. Der Befehl "Aktualisierung " zur tatsächlichen Aktualisierung der Pakete kann später zum günstigsten Zeitpunkt ausgeführt werden, was zu einer kürzeren Dienstunterbrechung führt.

   Tabs group
   border all-sides navcolor navy
   Debian/UbuntubashDebian/UbuntuRedhat/CentOSbashRedHat

   Wiederholen Sie diese Befehle auf allen Plattformservern.

   Info
   Beim Aktualisieren einiger früherer Versionen kann eine Warnmeldung bezüglich der Unterschrift von Depots auftreten. Als einfache Warnmeldung behindert sie die Aktualisierung nicht und sie können Sie beheben: siehe obiger Abschnitt 2.3.c: Unterschrift der Depots.

3. Gehen Sie mit einem Browser zur Update-Verwaltungsschnittstelle http://<votre.serveur.com>/setup:
   

   Astuce
   Hinweis: Dieser Schritt erfordert das Passwort für den Zugriff auf den Installationsassistenten - siehe obigesKapitel 2.2

4. Starten Sie den automatischen BlueMind-Konfigurationsvorgang, indem Sie auf die Schaltfläche „Aktualisieren“ klicken

5. Wurde dieser Vorgang erfolgreich abgeschlossen, werden Sie durch eine Meldung darüber informiert:
   

   Der Zugriff auf BlueMind ist dann unter der üblichen Url möglich

Anhänge

Ancre
note-conf note-conf

Hinweis zu Konfigurationsdateien