Migrer Nextcloud : comment bien réussir sa migration ?

Une migration Nextcloud consiste gé­né­ra­le­ment à trans­fé­rer des données d’un serveur Nextcloud à un autre ou à passer d’une solution comme ownCloud à Nextcloud.  Les raisons peuvent aller d’un chan­ge­ment matériel à un chan­ge­ment de pres­ta­taire d’hé­ber­ge­ment.

Quels sont les motifs d’une migration Nextcloud ?

Migrer vers Nextcloud ou changer de serveur Nextcloud peut être utile ou né­ces­saire pour dif­fé­rentes raisons. Le plus souvent, cette opération est motivée par le désir d’améliorer les per­for­mances, de renforcer la sécurité ou de gagner en flexi­bi­lité. Parmi les raisons les plus fré­quentes pour une migration de serveur, on retrouve :

• Changer de matériel pour de meil­leures per­for­mances : lorsque l’in­fras­truc­ture existante atteint ses limites, par exemple en raison de l’aug­men­ta­tion du nombre d’uti­li­sa­teurs ou du volume de données, le passage à des serveurs plus puissants permet d’améliorer sen­si­ble­ment la vitesse et la stabilité.
• Migrer d’un en­vi­ron­ne­ment virtuel à un serveur physique : un autre motif courant est le transfert de solutions lo­gi­cielles pré­con­fi­gu­rées fonc­tion­nant dans un en­vi­ron­ne­ment virtuel vers des serveurs physiques. Ces derniers offrent gé­né­ra­le­ment une plus grande puissance de calcul.
• Passer à un autre service d’hé­ber­ge­ment : une migration peut être motivée par un chan­ge­ment de four­nis­seur Nextcloud, que ce soit pour réduire les coûts, obtenir un meilleur support ou en raison d’une politique de con­fi­den­tia­lité plus stricte.
• Profiter plei­ne­ment des fonc­tion­na­li­tés Nextcloud : cette ap­pli­ca­tion open source offre de nom­breuses fonc­tion­na­li­tés et options d’extension grâce à son éco­sys­tème d’ap­pli­ca­tions. Elle re­pré­sente donc une option sérieuse et puissante par rapport aux dif­fé­rentes al­ter­na­tives à Nextcloud dis­po­nibles sur le marché.

Migrer Nextcloud : les dif­fé­rents scénarios possibles

Il existe dif­fé­rents cas de figure pour une migration Nextcloud, selon l’origine et la des­ti­na­tion des données. Les plus courants sont les suivants :

• Migration de Nextcloud vers Nextcloud : les données sont trans­fé­rées d’un serveur Nextcloud à un autre, par exemple pour utiliser un matériel plus per­for­mant ou pour changer de service d’hé­ber­ge­ment. Pour ce cas de figure, Nextcloud propose depuis la version 24 une fonction d’import/export, qui permet d’exporter les données d’une archive et de les migrer vers le nouveau serveur.
• Migration d’une autre pla­te­forme vers Nextcloud : il s’agit de migrer depuis d’autres solutions Cloud comme ownCloud pour profiter de la com­mu­nauté active, du catalogue d’ap­pli­ca­tions Nextcloud et de la sca­la­bi­lité de Nextcloud. Les données sont alors d’abord exportées de la pla­te­forme pré­cé­dente, avant d’être migrées vers Nextcloud.
• Migration depuis une base de données locale vers Nextcloud : les données, les ap­pli­ca­tions et les res­sources nu­mé­riques stockées lo­ca­le­ment sont trans­fé­rées par­tiel­le­ment ou en­tiè­re­ment dans un en­vi­ron­ne­ment Nextcloud. L’ampleur de la migration dépend prin­ci­pa­le­ment des raisons du chan­ge­ment et des objectifs qui y sont associés.

Ins­truc­tions : migrer Nextcloud vers un autre serveur

La migration vers un autre serveur nécessite une pla­ni­fi­ca­tion et une mise en œuvre mi­nu­tieuses. Les ins­truc­tions suivantes vous montrent, étape par étape, comment trans­fé­rer vos données vers le nouveau système. Dans tous les cas, il est re­com­mandé de faire une sau­ve­garde de toutes les données im­por­tantes avant la migration, afin de pouvoir les restaurer sans problème si besoin.

Étape 1 : préparer le nouveau serveur

1. Installez le système d’ex­ploi­ta­tion de votre choix sur le nouveau serveur.
2. Con­fi­gu­rez les com­po­sants né­ces­saires : serveur Web, PHP et la base de données de votre choix (MySQL, MariaDB, Post­greSQL, Oracle).
3. Assurez-vous que la version de PHP et de toutes les po­ten­tielles ex­ten­sions PHP est com­pa­tible avec votre con­fi­gu­ra­tion Nextcloud.

Étape 2 : passer Nextcloud en mode main­te­nance

1. Passez Nextcloud en mode main­te­nance sur le serveur existant en exécutant la commande suivante :

sudo -u www-data php occ maintenance:mode --on

2. Attendez quelques minutes afin que tous les clients de syn­chro­ni­sa­tion détectent le mode main­te­nance. Ensuite, arrêtez le serveur Web sur lequel vous exécutez Nextcloud.

Étape 3 : sau­ve­gar­der et trans­fé­rer la base de données

1. Effectuez une sau­ve­garde de la base de données (dump) pour votre ins­tal­la­tion existante.
2. Trans­fé­rez la copie vers le nouveau serveur, puis importez-la dans la nouvelle base.

Étape 4 : copier les fichiers

1. Copiez tous les fichiers de votre instance Nextcloud sur le nouveau serveur.
2. Les fichiers de données doivent conserver leur ho­ro­da­tage. Sinon, les clients syn­chro­ni­se­ront à nouveau tous les fichiers après la migration. Utilisez pour cela l’outil de syn­chro­ni­sa­tion rsync :

rsync -avz --progress --times /chemin/vers/nextcloud/ /chemin-de-destination/

3. Si les chemins d’accès aux fichiers changent en raison de la migration Nextcloud, il est né­ces­saire d’adapter également ces chemins dans le fichier Nextcloud config.php.
4. Exécutez la commande suivante pour corriger les éven­tuelles in­co­hé­rences après la migration :

sudo -u www-data php occ maintenance:repair

Étape 5 : vérifier l’empreinte des données

1. Vérifiez dans le fichier config.php du système d’origine si une valeur a été définie pour data-fingerprint.
2. Si c’est le cas, vous devez exécuter la commande suivante sur le nouveau serveur :

sudo -u www-data php occ maintenance:data-fingerprint

Étape 6 : test sur le nouveau serveur

1. Re­dé­mar­rez la base de données, le serveur Web ou le serveur d’ap­pli­ca­tions, ainsi que l’ap­pli­ca­tion Nextcloud.
2. Vérifiez si le mode de main­te­nance est toujours actif, si des fichiers journaux ont été générés et s’il y a des messages d’erreur.
3. Dé­sac­ti­vez le mode de main­te­nance et connectez-vous en tant qu’ad­mi­nis­tra­teur pour vérifier que tout fonc­tionne cor­rec­te­ment.

Étape 7 : mettre à jour l’en­re­gis­tre­ment DNS

Mettez à jour l’en­re­gis­tre­ment CNAME dans les pa­ra­mètres DNS afin de diriger les uti­li­sa­teurs vers le nouvel em­pla­ce­ment.

Migrer d’ownCloud vers Nextcloud

La migration d’ownCloud vers Nextcloud peut être comparée à une mise à niveau manuelle. Il est essentiel que les versions des deux ap­pli­ca­tions Cloud soient com­pa­tibles, ce qui limite la com­pa­ti­bi­lité à une migration depuis ownCloud 10.13.x vers au moins Nextcloud 25.0.13. Pour migrer ownCloud vers Nextcloud, procédez comme suit :

1. Créer une sau­ve­garde : par sécurité, assurez-vous de créer une sau­ve­garde avant de commencer le processus de migration.
2. Té­lé­char­ger la version com­pa­tible de Nextcloud : vous trouverez la version té­lé­char­geable du logiciel depuis la page d’archive de Nextcloud.
3. Effectuer la mise à niveau : suivez les ins­truc­tions de la do­cu­men­ta­tion of­fi­cielle de mise à niveau de Nextcloud pour installer Nextcloud sur votre instance existante d’ownCloud.
4. Adapter la base de données : après la mise à jour, exécutez les commandes suivantes (après avoir exécuté occ upgrade) pour con­fi­gu­rer cor­rec­te­ment la base de données :

occ db:convert-filecache-bigint
occ db:add-missing-columns
occ db:add-missing-indices
occ db:add-missing-primary-keys

5. Contrôler les cron jobs : si des cron jobs (tâches cron) étaient en place dans l’ancienne con­fi­gu­ra­tion, assurez-vous qu’ils sont bien exécutés via la commande PHP (et non occ system:cron), con­for­mé­ment aux ins­truc­tions pour les cron jobs Nextcloud.
6. Mettre Nextcloud à niveau : utilisez l’outil de mise à jour intégré de Nextcloud pour passer à la dernière version de l’ap­pli­ca­tion.
7. Analyser les aver­tis­se­ments : consultez la section « Vue d’ensemble » des pa­ra­mètres pour iden­ti­fier d’éven­tuelles alertes de sécurité ou de con­fi­gu­ra­tion.
8. Réactiver les ap­pli­ca­tions : après la migration vers Nextcloud, certaines ap­pli­ca­tions ownCloud peuvent être dé­sac­ti­vées. Vous pouvez installer les équi­va­lents Nextcloud de ces ap­pli­ca­tions en utilisant les commandes suivantes :

occ app:enable calendar
occ app:enable contacts