Point de départ
Ce plan a été rédigé à partir d’une inspection en lecture seule du serveur source. Rien n’y a été modifié. Il s’adresse à un administrateur système qui n’a jamais vu la machine.
Source
- Serveur
archive.monentreprise.bj- Système d’exploitation
- Ubuntu 18.04.6
- Hébergement
- Plesk Obsidian 18.0.80.7
- Base de données
- MariaDB 10.5.9
Cible
- Système d’exploitation
- Ubuntu Server 24.04 LTS
- Serveur web
- nginx relié directement à PHP-FPM. Ni Apache, ni panneau de contrôle.
- Application
- Yii 1, version 3.2.0, sous PHP 7.4
- Périmètre
- L’archive de production uniquement, sauf si la section 11 s’applique.
Le disque système de la source dispose de peu d’espace libre. N’y écrivez rien pendant ces travaux. Si vous avez besoin d’un espace de travail temporaire sur la source, utilisez /mnt/volume-bj, qui dispose de 208 Go libres. Lancez chaque copie depuis la nouvelle machine, en tirant les données vers elle, afin que rien de volumineux ne soit jamais créé sur la source.
1 · Ce que vous transférez
Sept éléments. Tout ce qui ne figure pas dans cette liste reste sur place.
| Élément | Chemin sur la source | Taille |
|---|---|---|
| Base de données de productionLa seule base de données en service | Schéma MariaDB ereg_benin_prod |
17 Go une fois chargée13 Go en SQL, 1,2 Go compressée |
| Documents des demandeursL’essentiel du transfert | /mnt/volume-bj/monentreprise.bj/documents |
524 Go267 293 répertoires de premier niveau |
| Certificats délivrésPDF et images générés | /mnt/volume-bj/monentreprise.bj/certificats |
195 Go236 422 répertoires de premier niveau |
| Code de l’applicationApplication Yii 1, version 3.2.0 | /var/www/vhosts/benin.eregistrations.org/httpdocs |
environ 2,8 Goaprès exclusions ; 21 Go bruts |
| Configuration de l’applicationVoir l’étape 17 et l’étape 18 | httpdocs/protected/config/ |
moins de 100 Ko |
| Certificat TLSOu simplement en émettre un nouveau sur la nouvelle machine, ce que fait l’étape 23 | Magasin du panneau de contrôle | quelques Ko |
| Tâche de sauvegarde nocturneÀ recréer, avec un nouveau mot de passe | crontab de root | 1 ligne |
Total à transférer : environ 722 Go. Les deux espaces de stockage de fichiers en représentent 718 Go, répartis sur 7,07 millions de fichiers.
2 · Durée de la copie des fichiers
Pour les 718 Go de fichiers, avec rsync et 8 flux parallèles.
| Débit de la liaison | Temps de transfert brut | Durée réaliste avec 7 millions de fichiers |
|---|---|---|
| 100 Mbit/s | environ 16 h | 20–24 h |
| 500 Mbit/s | environ 3,5 h | 6–8 h |
| 1 Gbit/s | environ 1,7 h | 4–6 h |
C’est le nombre de fichiers, et non le débit, qui fixe la durée minimale. Prévoyez une première copie complète qui tourne pendant la nuit, puis une seconde passe de rattrapage, courte, juste avant la bascule.
3 · À confirmer avant de commencer
Ne commencez pas tant que chaque ligne ci-dessous n’a pas reçu de réponse. Chacune peut arrêter les travaux à mi-chemin.
- Confirmez l’accès au serveur source.
La nouvelle machine doit pouvoir joindre le serveur source par SSH. Organisez cela avec la personne qui l’administre.
- Décidez du périmètre.
Ce plan transfère uniquement l’archive de production : le site servi à l’adresse
archive.monentreprise.bj, sa base de donnéesereg_benin_prodet son stockage de documents. Confirmez si le site de test, le site de développement, le serveur de discussion et les conteneurs de statistiques doivent eux aussi être transférés. Si c’est le cas, ajoutez les éléments de la section 11. - Confirmez le disque cible.
Il vous faut au moins 800 Go pour le stockage des documents, sur son propre système de fichiers, plus 60 Go sur le disque système pour l’application, la base de données et la place nécessaire à la restauration. La base de données occupe 17 Go une fois chargée, et l’export en texte brut pèse 13 Go.
- Confirmez que PHP 7.4 est acceptable.
L’application fonctionne sous PHP 7.4.33 et ne fonctionnera pas sous PHP 8. PHP 7.4 est en fin de vie et n’est pas fourni avec Ubuntu 24.04. Vous devez soit ajouter une source de paquets PHP 7.4 tierce, soit exécuter PHP 7.4 dans un conteneur. Des paquets PHP 7.4 pour Ubuntu 24.04 existent bien et sont reconstruits régulièrement, mais aucune source gratuite ne publie de correctifs de sécurité pour PHP 7.4 lui-même ; ce suivi est vendu séparément. Vérifiez laquelle des deux solutions votre politique de sécurité autorise avant d’installer quoi que ce soit.
- Confirmez que le générateur de PDF fonctionne sur le nouveau système d’exploitation.
L’application génère chaque certificat avec
wkhtmltopdf 0.12.5 (with patched qt), installé sous forme de binaire statique dans/usr/local/binet compilé pour une version d’Ubuntu bien plus ancienne. Testez-le tôt, à l’étape 6. S’il ne démarre pas, prévoyez de l’exécuter dans un conteneur. - Confirmez l’accès réseau aux services internes.
L’application appelle, en XML-RPC, un système interne de registre des entreprises. Il doit être joignable depuis la nouvelle machine. Demandez à l’équipe réseau de le confirmer, et de confirmer quels réseaux clients doivent pouvoir joindre la nouvelle machine. Le serveur source autorise le trafic web depuis une seule plage d’adresses réseau du Bénin.
- Confirmez l’envoi du courrier sortant.
L’application envoie tous ses courriels par un relais de messagerie SMTP hébergé, sur le port 587. Confirmez que la nouvelle machine peut ouvrir le port 587 en sortie, et confirmez qui détient les identifiants du relais.
- Renouvelez trois identifiants.
Le mot de passe de base de données utilisé par la sauvegarde nocturne est enregistré en clair dans la crontab de root et dans la table des tâches du panneau de contrôle. Les identifiants du relais SMTP figurent en clair dans le fichier
.envde l’application. Changez-les tous à l’occasion de ce transfert. Ne reprenez pas les anciennes valeurs. - Confirmez le plan DNS.
Le DNS de ces domaines est assuré par un prestataire extérieur, et non par le serveur source ; la bascule se résume donc à une modification d’enregistrement chez ce prestataire. Confirmez qui peut la faire, et quelle est la durée du TTL actuel.
- Confirmez que
siggufe_dbn’est plus utilisée.Cette petite base de données, sur la source, n’a reçu aucune écriture depuis le dernier démarrage du serveur de base de données. Le plan la considère comme historique et la copie une seule fois, en lecture seule. Demandez au responsable de l’application si quelque chose la lit encore.
- Protégez le disque de la source.
Le disque système de la source dispose de peu d’espace libre. N’y écrivez rien pendant ces travaux. Utilisez
/mnt/volume-bjcomme espace de travail temporaire ; il dispose de 208 Go libres.
4 · Fichiers qui ne font pas partie de l’application
Ils ne font pas partie de l’application et ne doivent pas être repris. Soyez précis à leur sujet : les exclusions des étapes 10 à 12 reposent sur cette liste.
Ne fait pas partie de cette application — à ne pas copier
/var/www/vhosts/eregistrations.org/- Les bases de données
ereg_beninetereg_yii2. Malgré leur nom, elles n’appartiennent pas à cette application. Laissez-les. - Les répertoires de
/var/qmail/mailnames/correspondant à tout domaine autre quearchive.monentreprise.bjettest.benin.eregistrations.org. - Les fichiers de zone BIND présents sur la source. Ce sont des restes inutilisés ; le DNS public est assuré ailleurs.
Anciennes sauvegardes et anciens exports — 64 Go
/var/www/vhosts/benin.eregistrations.org/_backup_prod— 51 Go, 30 exports nocturnes. Un seul export récent vous suffit, celui que vous réalisez à l’étape 8.httpdocs/_backup— 13 Go, deux exports récents.- Anciens exports
.sql.zipdes bases de données de développement, de test et de migration, dans le répertoire personnel — 176 Mo.
Cache, journaux et fichiers générés — à recréer vides
httpdocs/protected/runtime— 5,2 Go de journaux de l’application, d’anciens journaux de migration et de fichiers temporaires d’export. Créez le répertoire vide et accessible en écriture ; l’application le remplit à nouveau.httpdocs/assets— 469 Mo. Le framework les republie automatiquement à la première requête./var/www/vhosts/system/*/logs— journaux du serveur web.
Copies périmées du site
old-benin.eregistrations.org(7,3 Go) — ce domaine est suspendu.backup_test.benin.eregistrations.org(1,5 Go), des copies datées du site de test et des répertoires de statistiques,ASIN-REQUEST-OLD(25 Mo) ethttpdocs/JsonDataV4_INVEST_OLD.
Outils de développement laissés dans le répertoire personnel — 8,5 Go
go(4,4 Go),homebrew(2,3 Go),git(786 Mo),python(363 Mo),glibc(309 Mo),go-sdk(253 Mo),bison-3.8.2(55 Mo),venv,.cargo,.bun,.gem,.nodenv,.composer,.cache,.config,.local.
Fichiers PHP cachés et scripts ponctuels — à exclure par motif, puis à vérifier après la copie
- Tout fichier correspondant à
.*.php— c’est-à-dire les fichiers PHP cachés. Ils ne font pas partie de l’application et ne doivent pas être repris. httpdocs/webgrind/— une interface de profilage. Ne fait pas partie de l’application.- Les scripts isolés et les archives
.zipsitués au premier niveau de la racine web et auxquels l’application ne fait pas référence. Comparez tout fichier de ce niveau aux fichiers propres à l’application avant de le copier.
Le panneau de contrôle lui-même. Vous n’installez pas Plesk sur la nouvelle machine. La section 10 explique pourquoi.
5 · Phase 1 — Préparer la nouvelle machine
Étapes 1 à 7. Environ deux heures de travail, plus le délai de traitement de la demande réseau.
- Installez le système de base et créez les systèmes de fichiers
Installez Ubuntu Server 24.04 LTS. Donnez au stockage des documents son propre système de fichiers.
sudo mkdir -p /srv/ereg-files # mount your data disk at /srv/ereg-files via /etc/fstab, then: df -h /srv/ereg-filesRésultat — un système de fichiers vide d’au moins 800 Go, monté sur
/srv/ereg-files.
Durée — 30 minutes.
Vérification —df -h /srv/ereg-filesindique au moins 800 Go disponibles, etdf -i /srv/ereg-filesindique au moins 10 millions d’inodes libres. Si vous formatez en ext4, utilisezmkfs.ext4 -T newsou passez l’option-i 8192, afin de ne pas manquer d’inodes avant de manquer d’espace. - Installez le serveur web et la base de données
sudo apt update sudo apt install -y nginx mariadb-server sudo systemctl enable --now nginx mariadb mariadb --versionRésultat — nginx et MariaDB en fonctionnement.
Durée — 10 minutes.
Vérification —mariadb --versionaffiche une version. Ubuntu 24.04 fournit MariaDB 10.11 ou une version plus récente. C’est un chemin de mise à niveau pris en charge depuis la version 10.5 de la source, et un export suivi d’une restauration s’en charge. Lisez l’étape 15 avant de charger la moindre donnée : un paramètre du serveur doit changer. - Installez PHP 7.4 et les extensions dont l’application a besoin
L’application ne fonctionnera pas sous PHP 8. Ajoutez une source de paquets PHP 7.4, ou utilisez un conteneur.
sudo apt install -y software-properties-common sudo add-apt-repository -y ppa:ondrej/php sudo apt update sudo apt install -y php7.4-fpm php7.4-mysql php7.4-gd php7.4-imagick php7.4-intl \ php7.4-mbstring php7.4-curl php7.4-soap php7.4-xml php7.4-xsl php7.4-zip \ php7.4-bcmath php7.4-gmp php7.4-ldap php7.4-memcached php7.4-redis \ php7.4-imap php7.4-tidy php7.4-opcache php7.4 -mRésultat — PHP 7.4 avec le même jeu d’extensions que la source.
Durée — 15 minutes.
Vérification —php7.4 -ménumère au moinsgd imagick intl mbstring curl soap xml xsl zip bcmath gmp ldap memcached redis imap tidy pdo_mysql mysqli sockets sodium openssletZend OPcache.La source charge aussi le chargeur ionCube. Vous n’en avez pas besoin. Aucun fichier de l’application n’est encodé avec ionCube. Ce chargeur est le reste d’une ancienne installation. Ignorez-le.
Si les paquets PHP 7.4 ne sont pas autorisés, exécutez l’application dans un conteneur construit à partir de l’image
php:7.4-fpm, avec les mêmes extensions, et faites pointer nginx vers le socket du conteneur. Le reste de ce plan ne change pas ; seule la lignefastcgi_passde l’étape 14 diffère. - Installez les services d’appui
sudo apt install -y memcached redis-server sudo systemctl enable --now memcached redis-serverRésultat — les deux services de cache attendus par la configuration de l’application.
Durée — 5 minutes.
Vérification —systemctl is-active memcached redis-serveraffiche deux foisactive. L’application utilise memcached pour mettre en cache le schéma de la base de données. S’il manque, le site fonctionne quand même, mais chaque page relit le schéma et devient lente. - Créez l’utilisateur système et l’arborescence des répertoires
sudo useradd -r -m -d /srv/ereg -s /bin/bash ereg sudo mkdir -p /srv/ereg/httpdocs /srv/ereg-files/documents /srv/ereg-files/certificats sudo chown -R ereg:ereg /srv/ereg /srv/ereg-filesRésultat — le répertoire d’accueil de l’application et les deux répertoires de stockage des fichiers.
Durée — 2 minutes.
Vérification —ls -ld /srv/ereg/httpdocs /srv/ereg-files/documentsindique le propriétaireereg. - Installez et testez le générateur de PDF
C’est l’étape la plus susceptible d’échouer. Faites-la maintenant, pas à la fin.
# try the packaged build first sudo apt install -y wkhtmltopdf xfonts-75dpi xfonts-base fonts-dejavu-core wkhtmltopdf --version echo '<h1>test</h1>' > /tmp/t.html && wkhtmltopdf /tmp/t.html /tmp/t.pdf && ls -l /tmp/t.pdfRésultat — un
wkhtmltopdffonctionnel, et un PDF de test d’une page.
Durée — 15 minutes, ou jusqu’à une heure si vous devez recourir à la solution de repli en conteneur.
Vérification —wkhtmltopdf --versiondoit indiquer « with patched qt ». Une version sans le Qt modifié (« patched ») ne sait pas produire les en-têtes et les pieds de page, et les certificats sortent incorrects. Si la version fournie par les paquets n’est pas modifiée, ne cherchez pas de version officielle pour cette version d’Ubuntu : le projet n’est plus maintenu et n’en publie aucune. Exécutez plutôt wkhtmltopdf dans un petit conteneur construit sur une base plus ancienne, et appelez-le au moyen d’un script enveloppe placé à/usr/local/bin/wkhtmltopdf.La source contient aussi quatre polices personnalisées utilisées par les modèles de certificats. Copiez-les à l’étape 12, puis installez-les :
sudo cp /srv/ereg/httpdocs/wkfonts/*.ttf /usr/local/share/fonts/ && sudo fc-cache -f - Ouvrez le chemin réseau pour le transfert
Autorisez SSH depuis la nouvelle machine vers le serveur source. Demandez à la personne qui administre le serveur source d’autoriser l’adresse de la nouvelle machine, en entrée comme en sortie.
Résultat — un chemin SSH fonctionnel entre les deux machines.
Durée — dépend de la personne qui administre le serveur source.
Vérification — depuis la nouvelle machine,ssh <user>@archive.monentreprise.bj 'hostname'renvoie le nom d’hôte de la source. En cas d’échec, arrêtez-vous. Tout ce qui suit en dépend.
6 · Phase 2 — Copier les données
Étapes 8 à 13. C’est la phase longue. Lancez chaque copie depuis la nouvelle machine, en tirant les données vers elle. Ne créez jamais de fichier volumineux sur la source.
- Réalisez un nouvel export de la base de données sur la source, sur le volume de données
ssh <user>@archive.monentreprise.bj \ "sudo mysqldump --single-transaction --quick --user=<DB_USER> -p \ --default-character-set=utf8 ereg_benin_prod | bzip2 > /mnt/volume-bj/ereg_prod_move.sql.bz2"Résultat — un export compressé d’environ 1,2 Go, à
/mnt/volume-bj/ereg_prod_move.sql.bz2.
Durée — 25 à 40 minutes.
Vérification —ls -lsur le fichier indique environ 1,1 à 1,3 Go, etbzip2 -t /mnt/volume-bj/ereg_prod_move.sql.bz2se termine sans erreur.Pourquoi sur
/mnt/volume-bj— il dispose de 208 Go libres. Le disque système n’a pas la place.
Pourquoi--default-character-set=utf8— l’application se connecte aveccharset => utf8, et nonutf8mb4. Exporter et restaurer avec le même jeu de caractères préserve les caractères accentués du français. - Récupérez l’export de la base de données
rsync -a --info=progress2 \ <user>@archive.monentreprise.bj:/mnt/volume-bj/ereg_prod_move.sql.bz2 /srv/ereg/Résultat — l’export sur la nouvelle machine.
Durée — 2 à 20 minutes, selon la liaison.
Vérification —bzip2 -t /srv/ereg/ereg_prod_move.sql.bz2se termine avec le code 0. - Récupérez les certificats — 195 Go
Répartissez la copie en flux parallèles. Un rsync unique sur 236 000 répertoires est lent.
cd /srv/ereg-files for i in 0 1 2 3 4 5 6 7 8 9; do rsync -a --numeric-ids --no-owner --no-group --info=progress2 \ --exclude='.*.php' \ --include="$i" --include="$i*/" --include="$i*/**" --exclude='*' \ <user>@archive.monentreprise.bj:/mnt/volume-bj/monentreprise.bj/certificats/ certificats/ & done waitRésultat —
/srv/ereg-files/certificatscontenant environ 195 Go.
Durée — 2 à 8 heures.
Vérification —du -sh /srv/ereg-files/certificatsindique environ 195 Go, et le nombre de répertoires correspond :ls /srv/ereg-files/certificats | wc -l # expect 236422Notez l’option
--exclude='.*.php'— elle exclut les fichiers PHP cachés, qui ne font pas partie de l’application. Conservez-la. - Récupérez les documents — environ 524 Go
Même méthode, même exclusion.
cd /srv/ereg-files for i in 0 1 2 3 4 5 6 7 8 9; do rsync -a --numeric-ids --no-owner --no-group --info=progress2 \ --exclude='.*.php' \ --include="$i" --include="$i*/" --include="$i*/**" --exclude='*' \ <user>@archive.monentreprise.bj:/mnt/volume-bj/monentreprise.bj/documents/ documents/ & done waitRésultat —
/srv/ereg-files/documentscontenant environ 524 Go.
Durée — 4 à 20 heures. C’est l’étape la plus longue. Lancez-la pour la nuit.
Vérification —ls /srv/ereg-files/documents | wc -l # expect 267293 du -sh /srv/ereg-files/documents # expect about 524G find /srv/ereg-files -name '.*.php' # must print nothingSi la dernière commande affiche quoi que ce soit, supprimez ces fichiers avant d’aller plus loin.
- Récupérez le code de l’application
rsync -a --numeric-ids --no-owner --no-group --info=progress2 \ --exclude='_backup/' \ --exclude='protected/runtime/' \ --exclude='assets/' \ --exclude='.*.php' \ --exclude='webgrind/' \ --exclude='*.zip' \ --exclude='documents' --exclude='certificats' \ <user>@archive.monentreprise.bj:/var/www/vhosts/benin.eregistrations.org/httpdocs/ \ /srv/ereg/httpdocs/Résultat — environ 2,8 Go de code d’application dans
/srv/ereg/httpdocs.
Durée — 10 à 30 minutes.
Vérification —du -sh /srv/ereg/httpdocs # about 2.8G, not 21G ls /srv/ereg/httpdocs/index.php # must exist ls /srv/ereg/httpdocs/protected/config/main.php # must exist find /srv/ereg/httpdocs -name '.*.php' # must print nothingdocumentsetcertificatssont exclus parce que, sur la source, ce sont des liens symboliques vers/mnt/volume-bj. Vous les recréez à l’étape 13. - Recréez les répertoires d’exécution et les deux liens symboliques
sudo -u ereg mkdir -p /srv/ereg/httpdocs/protected/runtime/exports \ /srv/ereg/httpdocs/assets \ /srv/ereg/httpdocs/uploads/tmp \ /srv/ereg/httpdocs/exports sudo -u ereg ln -s /srv/ereg-files/documents /srv/ereg/httpdocs/documents sudo -u ereg ln -s /srv/ereg-files/certificats /srv/ereg/httpdocs/certificats sudo chown -R ereg:ereg /srv/ereg /srv/ereg-files sudo chmod -R u+rwX /srv/ereg/httpdocs/protected/runtime /srv/ereg/httpdocs/assets \ /srv/ereg/httpdocs/uploads /srv/ereg/httpdocs/exportsRésultat — les répertoires accessibles en écriture dont l’application a besoin, et les deux liens par lesquels elle lit les documents.
Durée — 5 minutes, plus jusqu’à 30 minutes pour lechownsur 7 millions de fichiers.
Vérification —ls -l /srv/ereg/httpdocs/documentsmontre un lien vers/srv/ereg-files/documents, et l’écriture d’un fichier de test, en tant qu’utilisateurereg, dansprotected/runtimeréussit.
7 · Phase 3 — Restaurer et configurer
Étapes 14 à 19. Environ trois à quatre heures, dont l’essentiel pour la restauration de la base de données.
- Écrivez le site nginx et le pool PHP-FPM
La source fait tourner nginx devant Apache. Vous n’avez pas besoin d’Apache. nginx relié directement à PHP-FPM remplit le même rôle.
Créez
/etc/nginx/sites-available/ereg:server { listen 80; server_name archive.monentreprise.bj; root /srv/ereg/httpdocs; index index.php; client_max_body_size 128m; # source value: 134217728 bytes location / { try_files $uri $uri/ /index.php?$args; } location ~ \.php$ { include snippets/fastcgi-php.conf; fastcgi_pass unix:/run/php/php7.4-fpm-ereg.sock; fastcgi_read_timeout 300; } # do not serve hidden files location ~ /\. { deny all; } }Créez le pool PHP-FPM
/etc/php/7.4/fpm/pool.d/ereg.confavec les valeurs suivantes, qui correspondent exactement à celles du pool de la source :[ereg] user = ereg group = ereg listen = /run/php/php7.4-fpm-ereg.sock listen.owner = www-data listen.group = www-data listen.mode = 0660 pm = dynamic pm.max_children = 20 php_value[memory_limit] = 300M php_value[post_max_size] = 16M php_value[upload_max_filesize] = 16M php_value[allow_url_fopen] = off php_value[cgi.fix_pathinfo] = 0 php_value[expose_php] = off php_value[date.timezone] = Africa/Porto-Novo php_value[open_basedir] = "/srv/ereg/:/srv/ereg-files/:/tmp/"sudo ln -s /etc/nginx/sites-available/ereg /etc/nginx/sites-enabled/ sudo nginx -t && sudo systemctl reload nginx sudo systemctl restart php7.4-fpmRésultat — un site servi, mais qui ne fonctionne pas encore, faute de base de données.
Durée — 20 minutes.
Vérification —nginx -tindique que la configuration est correcte, etcurl -I http://localhost -H 'Host: archive.monentreprise.bj'renvoie une réponse, très probablement une erreur 500 à ce stade. C’est normal tant que la base de données n’est pas chargée, à l’étape 16.open_basedirdoit inclure le stockage des fichiers. Si vous l’omettez, chaque téléchargement de document échoue avec une erreur de permission, et rien dans le journal de l’application n’explique pourquoi. - Réglez les options du serveur de base de données, puis créez la base de données
Avant de charger quoi que ce soit, définissez ces paramètres dans
/etc/mysql/mariadb.conf.d/50-server.cnf:[mysqld] character-set-server = utf8mb4 sql_mode = "ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION" innodb_buffer_pool_size = 8G # size this to about 40% of the new machine's RAM innodb_file_per_table = 1 max_allowed_packet = 256Msudo systemctl restart mariadb sudo mariadb -e "CREATE DATABASE ereg_benin_prod CHARACTER SET utf8mb4;" sudo mariadb -e "CREATE USER '<DB_USER>'@'localhost' IDENTIFIED BY '<NEW_PASSWORD>';" sudo mariadb -e "GRANT ALL ON ereg_benin_prod.* TO '<DB_USER>'@'localhost'; FLUSH PRIVILEGES;"Résultat — une base de données vide et son utilisateur.
Durée — 10 minutes.
Vérification —sudo mariadb -e "SHOW DATABASES"fait apparaîtreereg_benin_prod.
Choisissez un nouvel utilisateur de base de données et un nouveau mot de passe sur la nouvelle machine — ne réutilisez pas ceux de la source. Vous les inscrivez dans.envà l’étape 17.Deux différences par rapport à la source, à ne pas reproduire. Premièrement, le
sql_modede la source comprendNO_AUTO_CREATE_USER; cette option a été supprimée des serveurs de base de données récents et empêcherait le serveur de démarrer : omettez-la, comme ci-dessus. Deuxièmement, la source accorde les droits à ses utilisateurs de base de données depuis'%', c’est-à-dire depuis n’importe quel hôte ; créez le vôtre sur'localhost'uniquement, car rien n’a besoin d’un accès distant à la base de données. - Restaurez la base de données
cd /srv/ereg bunzip2 -c ereg_prod_move.sql.bz2 | sudo mariadb --default-character-set=utf8 ereg_benin_prodRésultat — environ 17 Go de données dans
ereg_benin_prod.
Durée — 45 à 90 minutes.
Vérification —sudo mariadb -e "SELECT COUNT(*) FROM ereg_benin_prod.tbl_entreprise;" # expect about 549803 sudo mariadb -e "SELECT COUNT(*) FROM ereg_benin_prod.tbl_certificat;" # expect about 1854126 sudo mariadb -e "SELECT COUNT(*) FROM ereg_benin_prod.tbl_request;" # expect about 2132410Comparez ces chiffres aux mêmes décomptes relevés sur la source avant de commencer. Ils doivent correspondre, ou ne différer que des lignes ajoutées depuis l’export.
Vous pouvez ensuite vider sans risque la table des sessions. Elle contient 7,7 millions de sessions web expirées et occupe 5,3 Go :
sudo mariadb -e "TRUNCATE TABLE ereg_benin_prod.YiiSession;" - Modifiez le fichier d’environnement de l’application
Il s’agit du fichier
/srv/ereg/httpdocs/protected/config/.env. Modifiez les paramètres ci-dessous. Seuls les noms sont indiqués : prenez les valeurs dans votre nouvelle installation, jamais dans l’ancien fichier.Paramètre Ce qu’il doit devenir PHP_BINARYLe nouveau chemin de PHP 7.4, par exemple /usr/bin/php7.4. L’ancienne valeur pointe dans l’arborescence propre au panneau de contrôle.DOMAIN_NAMELe nom d’hôte sur lequel le site répondra. Actuellement archive.monentreprise.bj.DATABASE_HOST,DATABASE_PORT127.0.0.1et3306— inchangés, mais à confirmer.DATABASE_NAMEereg_benin_prod— inchangé.DATABASE_USER,DATABASE_PASSWORDLes nouveaux identifiants de l’étape 15. Ne réutilisez jamais l’ancien mot de passe. SMTP_HOST,SMTP_PORT,SMTP_ENCRYPTIONConfirmez que le relais les accepte toujours. SMTP_USERNAME,SMTP_PASSWORDDe nouveaux identifiants du relais, renouvelés. SYSTEM_ADMIN_EMAILDestination des courriels d’erreur de l’application. Actuellement une adresse personnelle. Remplacez-la par une boîte aux lettres d’équipe. WKHTMLTOPDF_BIN_PATHLe chemin que vous avez validé à l’étape 6. ENVIRONMENTLaissez prod.HTTPS_ENABLEDLaissez 1une fois TLS activé. Ce paramètre commande l’attribut de sécurité (Secure) du cookie de session.USER_SESSION_NAME,USER_SESSION_TIMEOUTLaissez-les tels quels. Changer le nom déconnecte tout le monde. YII_DEBUGDoit rester à 0.Durée — 15 minutes.
Vérification — l’utilisateureregpeut lire le fichier. - Vérifiez les autres fichiers de configuration
Ils lisent leurs valeurs dans
.env, si bien que la plupart n’exigent aucune modification. Lisez chacun d’eux et confirmez.Fichier Ce qu’il faut examiner protected/config/params.phpportal_urlest une adresse absolue, codée en dur, du site public — mettez-la à jour. Vérifiez aussiadminEmail,SupportEmail,gmaps_key,currency,documents_folder,certificats_folder. Obtenez une nouvelle clé Google Maps : faites-la réémettre à l’occasion du transfert et inscrivez la nouvelle valeur dans la configuration de la nouvelle machine.protected/config/main.phptimeZone(Africa/Porto-Novo),name,theme,language. Aucun chemin à modifier ; le fichier utilise des chemins relatifs.protected/config/prod.phpLes routes de journalisation. EmailLogRouteenvoie les erreurs àSYSTEM_ADMIN_EMAILavec une adresse d’expéditeur codée en dur — changez-la si le domaine d’envoi change. Les options de base de donnéescharset => utf8ettablePrefix => tbl_ne doivent pas changer.protected/config/database.phpLit .env. Aucune modification.protected/config/session.phpLit .env. Les sessions sont stockées dans la base de données, et non sur disque ; il n’y a donc rien à copier.protected/config/smtp.phpLit .env. Il remplace le texte littéral[domain]par le nom d’hôte ; ainsi, siSMTP_HOSTcontient[domain], ce texte devient le nom d’hôte du site.protected/config/hoauth.phpChaque fournisseur de connexion externe est réglé sur enabled => false. Laissez-le ainsi. Le fichier contient des identifiants et des secrets clients pour plusieurs services tiers. Rien de tout cela n’est utilisé. Faites-les réémettre à l’occasion du transfert et inscrivez les nouvelles valeurs dans la configuration de la nouvelle machine.protected/config/dkim_private.pemUne clé de signature du courrier. Le code qui l’utilisait est mis en commentaire. Ne la copiez pas. Générez une nouvelle clé si vous activez DKIM. protected/config/env.phpRenvoie la chaîne littérale prod. N’y touchez pas.httpdocs/.htaccessRègles Apache uniquement. Avec nginx, ce fichier est sans effet ; la réécriture équivalente figure déjà dans la configuration nginx de l’étape 14. Durée — 30 minutes.
Vérification — recherchez dans le répertoire de configuration tout chemin absolu restant de l’ancienne machine :grep -rn "/var/www\|/opt/plesk\|/mnt/volume-bj" /srv/ereg/httpdocs/protected/config/La commande ne doit rien afficher.
- Recréez la sauvegarde nocturne, avec un nouveau mot de passe
Ne copiez pas l’ancienne ligne de crontab. Elle contient le mot de passe de la base de données en clair, ce qui le rend visible de tous les utilisateurs de la machine dans la liste des processus. Utilisez plutôt un fichier d’options.
sudo install -m 600 /dev/null /root/.my.cnf # put [mysqldump] user= and password= in /root/.my.cnf, then: sudo crontab -eAjoutez :
0 19 * * * cd /srv/backups && D=$(date +\%Y-\%m-\%d) && mysqldump --single-transaction --quick ereg_benin_prod | bzip2 > db_$D.sql.bz2 0 18 * * * find /srv/backups -name 'db_*.sql.bz2' -mtime +30 -deleteRésultat — chaque nuit, un export compressé de 1,2 Go, conservé 30 jours, soit environ 36 Go.
Durée — 15 minutes.
Vérification — lancez une fois la commande d’export à la main, et confirmez quebzip2 -tréussit sur le résultat. Assurez-vous que/srv/backupsse trouve sur un système de fichiers disposant d’au moins 60 Go libres et, si vous pouvez l’éviter, pas sur le même disque que la base de données.
En outre — copiez l’export hors de la machine. La source ne dispose d’aucune copie externe de cette base de données.
8 · Phase 4 — Vérifier
Étapes 20 à 22. Environ une heure, plus le délai nécessaire à l’équipe réseau.
- Démarrez le site et lisez le journal
curl -s -o /dev/null -w '%{http_code}\n' http://localhost -H 'Host: archive.monentreprise.bj' sudo -u ereg tail -f /srv/ereg/httpdocs/protected/runtime/application.logRésultat — un premier affichage de page.
Durée — 10 minutes.
Vérification — le code de statut est 200 ou une redirection, et non 500. S’il vaut 500, le journal de l’application en indique la cause. Les trois causes habituelles sont un mot de passe de base de données erroné, une extension PHP manquante, etopen_basedirqui n’inclut pas le stockage des fichiers. - Testez les trois choses qui cessent réellement de fonctionner après un transfert
Premièrement, connectez-vous avec un utilisateur de test. Cela valide la base de données, la table des sessions et les réglages du cookie. Deuxièmement, ouvrez un document existant : choisissez un dossier quelconque et ouvrez une pièce jointe. Cela valide le lien symbolique,
open_basediret la propriété des fichiers. Troisièmement, générez un certificat. Cela validewkhtmltopdf, les polices et l’accès en écriture au répertoire des certificats.Durée — 30 minutes.
Vérification — les trois réussissent, et aucune nouvelle erreur n’apparaît dansapplication.log. - Testez les connexions vers l’extérieur
L’application contacte les services suivants. Testez chacun d’eux depuis la nouvelle machine.
Ce qu’elle appelle Où c’est configuré Ce qui cesse de fonctionner si le service est injoignable Le système interne de registre des entreprises, en XML-RPC protected/components/DataExchangeHelper.php— les constantesBACKEND_URL,BACKEND_DB,BACKEND_DB_USERNAME,BACKEND_DB_PASSWORDLes dossiers déposés ne sont jamais transmis au registre. L’application réessaie jusqu’à 10 fois, avec un délai de 3 heures, puis abandonne sans rien signaler. C’est une perte de données silencieuse. Les identifiants sont codés en dur dans ce fichier — changez-les ici et renouvelez-les. Un second point d’accès XML-RPC protected/components/Odoo.phpLe même type de transmission échoue. Relais de messagerie SMTP sur le port 587 protected/config/.envPlus aucun courriel : ni activation de compte, ni notifications, ni alertes d’erreur. API JavaScript Google Maps protected/config/params.php,gmaps_keyLes cartes d’adresses ne s’affichent pas. Sans gravité. Un serveur de sécurité national d’échange de données, et un service de données de référence protected/controllers/TestController.phpuniquementRien. Ils n’apparaissent que dans du code de test, inaccessible en usage normal. Un service web fiscal protected/components/ServiceDGI.phpRien. Cette application ne l’utilise pas. # adapt the host and port from the configuration files above timeout 5 bash -c 'cat < /dev/null > /dev/tcp/<BACKEND_HOST>/<BACKEND_PORT>' && echo reachable timeout 5 bash -c 'cat < /dev/null > /dev/tcp/<SMTP_HOST>/587' && echo smtp-reachableDurée — 20 minutes, plus le délai nécessaire à l’équipe réseau.
Vérification — chaque test affichereachable. Lorsque ce n’est pas le cas, déposez une demande d’ouverture de pare-feu avant la bascule. Une défaillance silencieuse ici fait perdre des dossiers déposés.
9 · Phase 5 — Basculer
Étapes 23 et 24. Deux à trois heures, puis 30 jours d’attente avant que le serveur source ne soit restitué.
- Dernier rattrapage, puis bascule
Mettez le site source en maintenance, ou convenez d’une plage de faible activité. Puis, dans l’ordre : refaites les étapes 8 et 9 pour obtenir un nouvel export de la base de données, et l’étape 16 pour le recharger ; refaites les étapes 10 et 11 — la seconde passe ne transfère que ce qui a changé, et prend quelques minutes plutôt que des heures ; émettez un certificat TLS sur la nouvelle machine ; et remplacez, chez le prestataire DNS extérieur, l’enregistrement par l’adresse de la nouvelle machine.
sudo certbot --nginx -d archive.monentreprise.bjNe copiez pas le certificat de la source. Il est conservé dans le magasin propre au panneau de contrôle et il expirera. Émettez-en un nouveau.
Résultat — le site en service sur la nouvelle machine.
Durée — 2 à 3 heures, second chargement de la base de données compris.
Vérification —curl -I https://archive.monentreprise.bj, lancé depuis l’extérieur, renvoie 200 depuis la nouvelle machine. Confirmez-le en comparant la date d’émission du certificat. - Conservez le serveur source pendant 30 jours, puis restituez-le
Laissez la source en fonctionnement. Ne la supprimez pas tant que ces trois conditions ne sont pas toutes réunies : la nouvelle machine a mené à bien 30 sauvegardes nocturnes ; la personne qui administre la source a donné son accord pour la libérer ; et quelqu’un a confirmé que les décomptes d’enregistrements correspondent toujours.
Durée — 30 jours d’attente, puis quelques minutes.
10 · Pourquoi reconstruire, plutôt que migrer le panneau de contrôle
Cinq raisons, de la plus forte à la moins forte.
- La nouvelle machine doit faire fonctionner une seule application, et rien d’autre.
Il s’agit d’un site, d’une base de données, d’un stockage de fichiers et d’une tâche nocturne. La reconstruction copie une liste précise sur une machine propre et exclut le reste par motif, si bien que ce qui y est arrivé peut être vérifié après coup. Une migration du panneau de contrôle copie au contraire des répertoires entiers, et vous héritez de tout ce qu’ils contiennent.
- La question de la version de PHP doit être réglée dans les deux cas.
Le site fonctionne avec la version de PHP 7.4 propre au panneau de contrôle, et PHP 7.4 est en fin de vie. Consultez la documentation du panneau de contrôle pour savoir quelles versions de PHP il fournit pour Ubuntu 24.04 avant de compter sur une migration pour reprendre la version 7.4 ; ce point n’a pas pu être vérifié depuis le serveur source. S’il ne la fournit pas, la migration place le site sur une version de PHP sous laquelle il ne peut pas fonctionner, et vous installez PHP 7.4 à la main de toute façon — la partie difficile de la reconstruction, sans l’avantage d’une machine propre.
- Un panneau de contrôle est une licence et une dépendance dont vous n’avez pas besoin.
L’application se compose d’un site Yii 1, d’une base de données, d’un stockage de fichiers et d’une tâche planifiée nocturne. nginx, PHP-FPM et MariaDB couvrent l’ensemble. Ajouter un panneau de contrôle ajoute un coût de licence, un produit de plus à mettre à jour, ainsi qu’un second serveur de messagerie, un serveur DNS et un serveur FTP que vous n’avez pas demandés.
- L’application est en PHP ordinaire.
Aucun fichier de l’application n’est encodé avec ionCube ; le chargeur présent sur la source est un reste. Rien n’est lié à une machine ou à une licence précise ; une simple copie de fichiers suffit donc.
- Le système d’exploitation de la source n’est plus couvert par le support standard, et la machine manque d’espace disque.
Cloner cet état reporterait ces deux contraintes sur le nouveau matériel. Une installation propre d’Ubuntu 24.04 démarre sans elles.
Ce que la reconstruction vous coûte, en toute franchise. Vous écrivez à la main la configuration nginx et PHP-FPM à l’étape 14, vous émettez un nouveau certificat TLS à l’étape 23, et vous perdez le panneau de contrôle dont les administrateurs précédents se servaient pour gérer la messagerie et les tâches planifiées. Deux boîtes aux lettres existent sur la source — une adresse noreply sur chacun des deux domaines, contenant 4 Go composés surtout de rapports de remise. Si quelqu’un a besoin de ces courriels, exportez-les avant la mise hors service de la source. Tout le reste du panneau de contrôle est soit inutilisé, soit remplacé par ce qui précède.
11 · Si les systèmes de test, de développement et de discussion doivent aussi être transférés
Uniquement si le point 2 de la liste de confirmation appelle une réponse positive. Ajoutez ces éléments à tout ce qui précède.
| Élément | Taille | Remarque |
|---|---|---|
Base de données ereg_benin_test | 1,4 Go | Pour test.benin.eregistrations.org |
Base de données ereg_benin_dev | 1,6 Go | Pour dev.benin.eregistrations.org |
Base de données ereg_benin_migration | 0,12 Go | Un espace de travail de migration ponctuel, sans écriture récente |
Base de données siggufe_db | 0,11 Go | Historique, sans écriture récente |
Base de données keycloak | 0,02 Go | Voir la note ci-dessous |
/var/www/vhosts/benin.eregistrations.org/test.benin.eregistrations.org | 2,3 Go | Code du site de test |
/var/www/vhosts/benin.eregistrations.org/dev.benin.eregistrations.org | 3,3 Go | Code du site de développement |
/mnt/volume-bj/test.benin.eregistrations.org/documents | 6,0 Go | Documents de test |
/mnt/volume-bj/test.benin.eregistrations.org/certificats | 1,5 Go | Certificats de test |
/opt/keycloak | — | Le serveur de connexion ; voir la note ci-dessous |
| Quatre conteneurs Docker | 23 Mo chacun | Statistiques, vérification des noms commerciaux, mise à jour du registre des noms, guichet d’investissement. L’application de production en appelle trois sur localhost, ports 3003, 3004 et 3005. |
La base de données keycloak
L’archive de production ne l’utilise pas. La base contient un domaine d’authentification (realm) de 4 028 comptes d’utilisateurs et deux applications clientes : le serveur de discussion, et un client dont les adresses de redirection ne pointent que vers les sites de test et de développement. Le site de production authentifie ses utilisateurs à partir de sa propre table tbl_user, et tous les fournisseurs de connexion externes sont désactivés.
Si vous ne transférez que l’archive de production, ne copiez pas la base de données keycloak. Si vous transférez aussi le site de test, le site de développement ou le serveur de discussion, copiez-la avec /opt/keycloak. Il s’agit d’un serveur Keycloak de la génération 16, exécuté sur WildFly et lié à 127.0.0.1:8080. Il fonctionne sous Java 11, qui n’est pas la version par défaut d’Ubuntu 24.04, et cette version de Keycloak n’est plus maintenue depuis longtemps. Prévoyez de le remplacer plutôt que de le reprendre tel quel.
Les trois conteneurs auxiliaires comptent plus qu’il n’y paraît
protected/components/AutomaticAction.php appelle localhost:3003 et localhost:3004, et protected/models/TradeNameSearch.php appelle localhost:3005. Tous trois se trouvent sur des chemins de code normaux en production. Si vous transférez le site de production sans eux, la recherche de noms commerciaux et deux actions automatiques échoueront.
Leurs répertoires sources se trouvent dans le répertoire personnel : update-names-register, guichet-investissement, check_trade_name. Ils sont petits. Copiez-les, et exécutez-les avec Docker Compose sur la nouvelle machine, sur les mêmes ports locaux.