Aller au contenu principal

Changer de distribution

Cette documentation décrit la façon de changer la distribution sur laquelle fonctionne BlueMind. Elle peut être utilisée pour mettre à jour la distribution (Ubuntu 16.04 vers Ubuntu 18.04 par exemple).

Cette procédure est basée sur l'installation d'un système cible sur lequel les données seront migrées. Ce nouveau système prendra ensuite la place, au niveau réseau, du premier.

Pré-requis

  • installer sur le système cible un BlueMind en version identique au système d'origine. Si le système d'origine utilise BlueMind 4.8.x, le système cible doit avoir un BlueMind 4.8.x
  • installer sur le serveur cible l'ensemble des plugins utilisés sur le serveur source (import LDAP, signatures d'entreprise...)
  • jouer l'installation wizard (ou le setup wizard) sur le serveur cible:
    • si l'external-url d'origine est bluemind.domain.tld, le BlueMind du système cible doit être configuré avec l'external-url bluemind.domain.tld
    • installer une souscription valide pour cet OS. Dans ce cas précis, vous pouvez ré-utiliser la même souscription, le nouveau serveur venant remplacer l'ancien.
  • l'utilisateur root du serveur cible doit pouvoir s'authentifier en tant que root sur le serveur d'origine, idéalement en authentification par clé.
  • l'utilitaire rsync doit-être installé sur les 2 systèmes.

Migration

La migration des données se passe en 3 temps afin de minimiser l'indisponibilité du service:

  1. synchronisation à chaud des données du serveur source vers le serveur cible - opération longue, mais ne provoquant pas de coupure de service
  2. synchronisation à froid - opération rapide, mais provoquant une coupure de service
  3. remplacement des serveurs

Synchronisation à chaud

Permet de faire la copie initiale des données sans coupure du service:

  1. se connecter en tant que root sur le serveur cible: su -

  2. stopper les services sur les serveurs cible:

    bmctl stop
    systemctl stop postfix.service
  3. synchroniser les données de BlueMind via l'utilitaire rsync:

    rsync -avH --delete root@origsrv.domain.tld:/var/spool/cyrus/ /var/spool/cyrus/
    rsync -avH --delete root@origsrv.domain.tld:/var/lib/cyrus/ /var/lib/cyrus/
    rsync -avH --delete root@origsrv.domain.tld:/var/spool/bm-hsm/ /var/spool/bm-hsm/
    rsync -avH --delete root@origsrv.domain.tld:/var/spool/sieve/ /var/spool/sieve/
    rsync -avH --delete root@origsrv.domain.tld:/var/spool/bm-elasticsearch/ /var/spool/bm-elasticsearch/
    rsync -avH --delete root@origsrv.domain.tld:/var/spool/bm-docs/ /var/spool/bm-docs/
    rsync -avH --delete root@origsrv.domain.tld:/var/spool/bm-filehosting/ /var/spool/bm-filehosting/

Ces opérations peuvent-être interrompues et/ou réalisées plusieurs fois.

info

Pour minimiser le temps de coupure de service lors de la synchronisation à froid, il est recommandé d'effectuer les synchronisations à chaud le plus fréquemment possible. Cela permet de limiter la volumétrie de données à transférer entre les deux machines.

Plus le temps entre la synchronisation à chaud et la synchronisation à froid est court, plus la synchronisation à froid sera rapide.

Synchronisation à froid

  1. stopper les services sur les serveurs (origine et cible):

    bmctl stop
    systemctl stop postfix.service
  2. depuis le serveur cible, refaire une synchronisation des données:

    rsync -avH --delete root@origsrv.domain.tld:/var/spool/cyrus/ /var/spool/cyrus/
    rsync -avH --delete root@origsrv.domain.tld:/var/lib/cyrus/ /var/lib/cyrus/
    rsync -avH --delete root@origsrv.domain.tld:/var/spool/bm-hsm/ /var/spool/bm-hsm/
    rsync -avH --delete root@origsrv.domain.tld:/var/spool/sieve/ /var/spool/sieve/
    rsync -avH --delete root@origsrv.domain.tld:/var/spool/bm-elasticsearch/ /var/spool/bm-elasticsearch/
    rsync -avH --delete root@origsrv.domain.tld:/var/spool/bm-docs/ /var/spool/bm-docs/
    rsync -avH --delete root@origsrv.domain.tld:/var/spool/bm-filehosting/ /var/spool/bm-filehosting/
  3. depuis le serveur cible, réaliser un démarrage de PostgreSQL du serveur d'origine:

    ssh root@origsrv.domain.tld "systemctl start postgresql.service"
  4. depuis le serveur cible, réaliser un dump de la base de données du serveur d'origine:

    ssh root@origsrv.domain.tld "PGPASSWORD=bj pg_dump --format=c --username=bj --host localhost bj" > /tmp/dump-bj.sql
    ssh root@origsrv.domain.tld "PGPASSWORD=bj pg_dump --format=c --username=bj --host localhost bj-data" > /tmp/dump-bj-data.sql
  5. depuis le serveur cible, copier les fichiers du serveur origine vers le serveur cible:

    rsync -av -r root@origsrv.domain.tld:/etc/bm/\* /etc/bm

    rsync -av root@origsrv.domain.tld:/etc/nginx/sw.htpasswd /etc/nginx/sw.htpasswd

    rsync -av -r root@origsrv.domain.tld:/etc/bm-hps/\* /etc/bm-hps

    rsync -av root@origsrv.domain.tld:/etc/ssl/certs/bm_cert*.pem /etc/ssl/certs

    rsync -av -r root@origsrv.domain.tld:/var/lib/bm-ca/\* /var/lib/bm-ca

    rsync -av root@origsrv.domain.tld:/usr/share/bm-elasticsearch/config/elasticsearch.yml /usr/share/bm-elasticsearch/config/elasticsearch.yml

    rsync -av root@origsrv.domain.tld:/etc/imapd\* /etc/
    rsync -av root@origsrv.domain.tld:/etc/cyrus\* /etc/

    rsync -av root@origsrv.domain.tld:/etc/bm-webmail/\* /etc/bm-webmail/

    rsync -av root@origsrv.domain.tld:/etc/postfix/main.cf /etc/postfix/main.cf
    rsync -av root@origsrv.domain.tld:/etc/postfix/master.cf /etc/postfix/master.cf
    rsync -av root@origsrv.domain.tld:/etc/postfix/master_relay_transport-flat /etc/postfix/master_relay_transport-flat
    rsync -av root@origsrv.domain.tld:/etc/postfix/master_relay_transport.db /etc/postfix/master_relay_transport.db
    rsync -av root@origsrv.domain.tld:/etc/postfix/transport-flat /etc/postfix/transport-flat
    rsync -av root@origsrv.domain.tld:/etc/postfix/transport.db /etc/postfix/transport.db
    rsync -av root@origsrv.domain.tld:/etc/postfix/virtual_alias-flat /etc/postfix/virtual_alias-flat
    rsync -av root@origsrv.domain.tld:/etc/postfix/virtual_alias.db /etc/postfix/virtual_alias.db
    rsync -av root@origsrv.domain.tld:/etc/postfix/virtual_domains-flat /etc/postfix/virtual_domains-flat
    rsync -av root@origsrv.domain.tld:/etc/postfix/virtual_domains.db /etc/postfix/virtual_domains.db
    rsync -av root@origsrv.domain.tld:/etc/postfix/virtual_mailbox-flat /etc/postfix/virtual_mailbox-flat
    rsync -av root@origsrv.domain.tld:/etc/postfix/virtual_mailbox.db /etc/postfix/virtual_mailbox.db
  6. depuis le serveur cible, réaliser un démarrage de PostgreSQL:

    systemctl start postgresql.service
  7. re-monter la base de données sur le serveur cible:

    su - postgres
    dropdb bj
    dropdb bj-data
    createdb bj
    createdb bj-data
    export nb_cpu=$(cat /proc/cpuinfo |grep "processor"|wc -l)
    pg_restore -C --jobs=${nb_cpu} -d bj /tmp/dump-bj.sql
    pg_restore -C --jobs=${nb_cpu} -d bj /tmp/dump-bj-data.sql
    exit

Remplacement des serveurs

  1. stopper le serveur d'origine
  2. re-configurer le serveur cible pour lui attribuer l'adresse IP du serveur d'origine
  3. re-démarrer le serveur cible et le connecter au réseau à la place du serveur d'origine afin qu'il soit joignable à la place du serveur origine

Post-migration

Se connecter à la console d'administration de BlueMind en tant qu'utilisateur admin0@global.virt puis:

  1. Se rendre dans la partie Sécurité > Gestion du pare-feu et cliquer immédiatement sur le bouton "Enregistrer" pour forcer la régénération des règles du parefeu BlueMind
  2. Se rendre dans la partie Gestion du Système > Maintenance des mails, cliquer sur le bouton "Exécuter" pour re-générer les tables de routage de mails postfix
  3. Se rendre dans la partie Gestion du Système > Configuration Système et remplacer l'ancienne adresse IP du champ "Mes réseaux" par la nouvelle adresse ou plage d'adresse pour laquelle on souhaite être relais ouvert avant de cliquer sur le bouton "Enregistrer"