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

La mise à jour de votre distribution Linux vers une version majeure supérieure (Debian 7 vers Debian 8, etc) 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 une mise à jour de version majeure de la distribution, 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 a jour de BlueMind 3.0 vers BlueMind 3.5

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.

Remarque
titleChangement de version majeure : migration

La mise à jour de BlueMind lors d'un changement de version majeure (par exemple de v2.x en v3.x ou de v3.0.x en v3.5.x) nécessite un changement des adresses des dépôts logiciels. Le fichier de souscription doit donc être mis à jour afin de pouvoir réaliser le changement de version.

Cette mise à jour BlueMind ne doit pas être réalisée en même temps qu'une mise à jour majeure de distribution (Ubuntu 12.04 vers Ubuntu 16.04 par exemple). Pour une mise à jour majeure de distribution, veuillez contacter votre prestataire intégrateur ou nous contacter via notre plate-forme de tickets.

Pour mettre à jour en version majeure, il est donc nécessaire de contacter l'équipe BlueMind afin d'obtenir un nouveau fichier de souscription.

Pour en savoir plus, vous pouvez consulter la page dédiée à la Mise a jour de BlueMind 3.0 vers BlueMind 3.5.

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.

Distribution

La mise à jour est disponible pour toute version officiellement supportée par BlueMind.

Remarque
titleDebian 7 Wheezy n'est plus supportée par Debian

Pour continuer à profiter des mises à jour BlueMind avec cette distribution il faut mettre à jour les adresses des dépôts dans le fichier /etc/apt/sources.list pour :

Bloc de code
deb http://archive.debian.org/debian/ wheezy main
deb http://archive.debian.org/debian/ wheezy-backports main

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 :

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

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.

Remarque

Si vous avez modifié les fichiers de configuration manuellement, assurez-vous d'en faire une sauvegarde.
Pour en savoir plus, voir en Annexes : note sur les fichiers de configuration

Préparer la mise à jour

Pour une mise à jour d'un BlueMind déjà en version 3.5.14 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 fait via la console d'administration OU en ligne de commande :

Via la console d'administration

administration  :

  • se rendre dans Gestion du système > Mise à jour de BlueMind
  • Cliquer sur le bouton "Paramétrer" : la dernière version disponible sera installée.
  • En ligne de commande :
    1. saisir la commande suivante pour mettre à jour dans la dernière version disponible :

      Bloc de code
      bm-cli setup version latest
    2. pour mettre à jour dans une version particulière, passer le numéro de la version en paramètre :

      Bloc de code
      bm-cli setup version 3.5.14-2

      NB : l'utilisation du numéro de version majeure ("3.5" ou "4" par exemple) aura les mêmes effets que l'option "latest" : la dernière version mineure disponible de celle-ci sera installée

    3. pour bloquer la version et empêcher les mises à jour dans une version supérieure :

      Bloc de code
      bm-cli setup version current
  • Mettre à jour

    La mise à jour de BlueMind se fait sur le serveur au moyen des commandes déjà utilisées lors de l'installation (à appliquer sur toutes les machines concernées) :

    Info
    titleAdministration avancée

    Les opérations de mise à jour peuvent être réalisées entièrement en ligne de commande par des administrateurs avancés au moyen de l'outil bm-cli.

    Pour en savoir plus, consulter la page dédiée au Client CLI pour l'administration.

    1. Se connecter en tant que root sur le serveur à mettre à jour
    2. Mettre à jour les

    Mettre à jour

    La mise à jour de BlueMind se fait sur le serveur au moyen des commandes déjà utilisées lors de l'installation (à appliquer sur toutes les machines concernées) :

    1. Se connecter en tant que root sur le serveur à mettre à jour
    2. Mettre à jour les paquets

      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
      borderall-sides
      navcolornavy
      Debian/UbuntuRedhat/CentOS
      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. 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 automatiquement rouvert pour les utilisateurs, il redevient accessible à son url habituelle

    Info

    En cas de problèmes, les erreurs sont écrites dans les journaux de bm-core et bm-webserver.

    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

    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 factors, 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 upgrades of Linux distributions (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 modify BlueMind dependencies which may impact BlueMind services.

    To perform major distribution upgrades, please contact your integrator service provider or contact us via our ticket platform.

    Volet
    borderWidth3

    On this page:

    Sommaire
    maxLevel2

    Related:

    Installation

    Introduction

    The BlueMind subscription provides a simplified update system which has been tested and saves having to perform a migration procedure, 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.

    Remarque
    titleMajor Upgrades: Migration

    Major BlueMind upgrades (to a newer version, for instance e.g. from v2.x to v3.x or from v3.0.x to v3.5.x) require software deposit addresses to be updated. The subscription file must therefore be updated for you to perform the version upgrade.

    This Such BlueMind upgrade upgrades must not be performed at the same time as a major distribution update (e.g. Ubuntu 12.04 to Ubuntu 16.04). To perform major distribution upgrades, please contact your integrator service provider or contact us via our ticket platform.

    For major upgrades, you must contact BlueMind to obtain a new subscription file.

    To find out more, please go to our dedicated page: Migrating from BlueMind 3.0 to BlueMind 3.5.

    Prerequisites

    Souscription

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

    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:
      • 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.

    Distribution

    Updates are available for any version officially supported by BlueMind.

    Remarque
    titleDebian 7 Wheezy is no longer supported by supports Debian 7 Wheezy

    To continuer being able to use BlueMind updates with this distribution, you must update repository addresses in the file /etc/apt/sources.list for:

    Bloc de code
    deb http://archive.debian.org/debian/ wheezy main
    deb http://archive.debian.org/debian/ wheezy-backports main

    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:

    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.

    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.

    Remarque
    If you've modified the made changes to configuration files manually, make sure to you back them up.
    To find out more, please refer to the Appendices: note on configuration files

    Préparer la mise à jour

    Preparing for the update

    For updates from BlueMind Pour une mise à jour d'un BlueMind déjà en version 3.5.14 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 :

    1. Via la console d'administration :
      1. se rendre dans Gestion du système > Mise à jour de BlueMind
      2. Cliquer sur le bouton "Paramétrer" : la dernière version disponible sera installée.
    2. En ligne de commande :
      1. saisir la commande suivante pour mettre à jour dans la dernière version disponible :

        Bloc de code
        bm-cli setup version latest
      2. pour mettre à jour dans une version particulière, passer le numéro de la version en paramètre :

        Bloc de code
        bm-cli setup version 3.5.14-2

        NB : l'utilisation du numéro de version majeure ("3.5" ou "4" par exemple) aura les mêmes effets que l'option "latest" : la dernière version mineure disponible de celle-ci sera installée

      3. pour bloquer la version et empêcher les mises à jour dans une version supérieure :

        Bloc de code
        bm-cli setup version current

    Mettre à jour

    Updates are performed using the same command lines as for installs and must be applied to all the devices concerned:

    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 is conformed to and consistent with the installation of additional packages – which will be installed in the server version.

    This can be done in the admin console:

    • Go to System Management > Update BlueMind
    • Click "Setup": the latest available version will be installed.

    Update procedure

    Updates are performed using the same command lines as for installs and must be applied to all the devices concerned:

    Info

    Les opérations de mise à jour peuvent être réalisées entièrement en ligne de commande par des administrateurs avancés au moyen de l'outil bm-cli.

    Pour en savoir plus, consulter la page dédiée au Client CLI pour l'administration.

    1. Connect to the server you want to update as root
    2. Update the packages

      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
      borderall-sides
      navcolornavy
      Debian/UbuntuRedhat/CentOS
    3. connect to the server as root
    4. enter the commands below, depending on your OS:

      Bloc de code
      languagebash
      titleDebian/Ubuntu
      aptitude update
      aptitude upgrade
      
      Bloc de code
      languagebash
      titleRedHat
      yum makecache
      yum upgrade
      Info

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

    5. Using In your web browser, go to the setup wizard https://<votre<your.serveurserver.com>/setup:

    6. Click "Update" to start the automatic update process.
    7. Once this is done, a message informs you that configuration was successful:
       
      BlueMind is then available at its usual url.
    Info

    In the event of a problem, errors are logged into the bm-core and bm-tomcat files.

    Appendices

    Ancre
    note-conf
    note-conf
    About configuration files

    The postfix configuration is overwritten during the installation phase only. From then on, this configuration is updated using the command postconf.
    Configuration files can be configured as desired, with the following restrictions:

    • deleting BlueMind maps: maps can however be added.
    • editing mynetwork: mynetwork must be edited in the admin console.
    • editing relayhost: relayhost must be edited in the admin console.
    Concerning NGinx: the virtual host is overwritten with every update.
    All VHosts are disabled during updates. Only BlueMind VHosts (bm-client-access and bm-webmail) are enabled again afterwards. Other virtual hosts may be enabled again, but this must be done as part of the update process, in addition to and to complete the BlueMind update process.
    BlueMind's virtual host can also be extended through the /etc/nginx/bm-local.d/*.conf files.

    ...