Migrer Nextcloud : comment bien réussir sa migration ?

Une migration Nextcloud consiste généralement à transférer des données d’un serveur Nextcloud à un autre ou à passer d’une solution comme ownCloud à Nextcloud.  Les raisons peuvent aller d’un changement matériel à un changement de prestataire d’hébergement.

Quels sont les motifs d’une migration Nextcloud ?

Migrer vers Nextcloud ou changer de serveur Nextcloud peut être utile ou nécessaire pour différentes raisons. Le plus souvent, cette opération est motivée par le désir d’améliorer les performances, de renforcer la sécurité ou de gagner en flexibilité. Parmi les raisons les plus fréquentes pour une migration de serveur, on retrouve :

• Changer de matériel pour de meilleures performances : lorsque l’infrastructure existante atteint ses limites, par exemple en raison de l’augmentation du nombre d’utilisateurs ou du volume de données, le passage à des serveurs plus puissants permet d’améliorer sensiblement la vitesse et la stabilité.
• Migrer d’un environnement virtuel à un serveur physique : un autre motif courant est le transfert de solutions logicielles préconfigurées fonctionnant dans un environnement virtuel vers des serveurs physiques. Ces derniers offrent généralement une plus grande puissance de calcul.
• Passer à un autre service d’hébergement : une migration peut être motivée par un changement de fournisseur Nextcloud, que ce soit pour réduire les coûts, obtenir un meilleur support ou en raison d’une politique de confidentialité plus stricte.
• Profiter pleinement des fonctionnalités Nextcloud : cette application open source offre de nombreuses fonctionnalités et options d’extension grâce à son écosystème d’applications. Elle représente donc une option sérieuse et puissante par rapport aux différentes alternatives à Nextcloud disponibles sur le marché.

Migrer Nextcloud : les différents scénarios possibles

Il existe différents cas de figure pour une migration Nextcloud, selon l’origine et la destination des données. Les plus courants sont les suivants :

• Migration de Nextcloud vers Nextcloud : les données sont transférées d’un serveur Nextcloud à un autre, par exemple pour utiliser un matériel plus performant ou pour changer de service d’hébergement. 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 plateforme vers Nextcloud : il s’agit de migrer depuis d’autres solutions Cloud comme ownCloud pour profiter de la communauté active, du catalogue d’applications Nextcloud et de la scalabilité de Nextcloud. Les données sont alors d’abord exportées de la plateforme précédente, avant d’être migrées vers Nextcloud.
• Migration depuis une base de données locale vers Nextcloud : les données, les applications et les ressources numériques stockées localement sont transférées partiellement ou entièrement dans un environnement Nextcloud. L’ampleur de la migration dépend principalement des raisons du changement et des objectifs qui y sont associés.

Instructions : migrer Nextcloud vers un autre serveur

La migration vers un autre serveur nécessite une planification et une mise en œuvre minutieuses. Les instructions suivantes vous montrent, étape par étape, comment transférer vos données vers le nouveau système. Dans tous les cas, il est recommandé de faire une sauvegarde de toutes les données importantes 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’exploitation de votre choix sur le nouveau serveur.
2. Configurez les composants nécessaires : serveur Web, PHP et la base de données de votre choix (MySQL, MariaDB, PostgreSQL, Oracle).
3. Assurez-vous que la version de PHP et de toutes les potentielles extensions PHP est compatible avec votre configuration Nextcloud.

Étape 2 : passer Nextcloud en mode maintenance

1. Passez Nextcloud en mode maintenance 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 synchronisation détectent le mode maintenance. Ensuite, arrêtez le serveur Web sur lequel vous exécutez Nextcloud.

Étape 3 : sauvegarder et transférer la base de données

1. Effectuez une sauvegarde de la base de données (dump) pour votre installation existante.
2. Transfé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 horodatage. Sinon, les clients synchroniseront à nouveau tous les fichiers après la migration. Utilisez pour cela l’outil de synchronisation 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écessaire d’adapter également ces chemins dans le fichier Nextcloud config.php.
4. Exécutez la commande suivante pour corriger les éventuelles incohé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. Redémarrez la base de données, le serveur Web ou le serveur d’applications, ainsi que l’application Nextcloud.
2. Vérifiez si le mode de maintenance est toujours actif, si des fichiers journaux ont été générés et s’il y a des messages d’erreur.
3. Désactivez le mode de maintenance et connectez-vous en tant qu’administrateur pour vérifier que tout fonctionne correctement.

Étape 7 : mettre à jour l’enregistrement DNS

Mettez à jour l’enregistrement CNAME dans les paramètres DNS afin de diriger les utilisateurs vers le nouvel emplacement.

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 applications Cloud soient compatibles, ce qui limite la compatibilité à 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 sauvegarde : par sécurité, assurez-vous de créer une sauvegarde avant de commencer le processus de migration.
2. Télécharger la version compatible de Nextcloud : vous trouverez la version téléchargeable du logiciel depuis la page d’archive de Nextcloud.
3. Effectuer la mise à niveau : suivez les instructions de la documentation officielle 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 configurer correctement 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 configuration, assurez-vous qu’ils sont bien exécutés via la commande PHP (et non occ system:cron), conformément aux instructions 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’application.
7. Analyser les avertissements : consultez la section « Vue d’ensemble » des paramètres pour identifier d’éventuelles alertes de sécurité ou de configuration.
8. Réactiver les applications : après la migration vers Nextcloud, certaines applications ownCloud peuvent être désactivées. Vous pouvez installer les équivalents Nextcloud de ces applications en utilisant les commandes suivantes :

occ app:enable calendar
occ app:enable contacts