Utilisez l'application dédiée d'ownCloud migrate-to-ociset ses occcommandes pour transférer les utilisateurs, les groupes, les fichiers et les partages compatibles d'ownCloud Classic 10 vers une instance ownCloud Infinite Scale (oCIS) installée séparément. Il s'agit d'une migration par étapes, et non d'une mise à niveau directe : la cible doit être accessible, configurée pour l'authentification et l'emprunt d'identité, et exempte de données conflictuelles. Prévoyez la réinitialisation des mots de passe, la réattribution des rôles et la gestion manuelle des montages externes.
Vérifiez si cette migration est compatible avec votre configuration.
La documentation actuelle de migration d'ownCloud Server 10.16 décrit une méthode de migration guidée utilisant une application fournie par ownCloud. Cette application n'est pas disponible sur le Marketplace ; veuillez contacter le support ownCloud pour l'obtenir. Les serveurs source et cible doivent être configurés, en cours d'exécution et pouvoir communiquer entre eux. Vous devez également disposer d'un accès SSH au serveur Classic et des droits d'exécution occde commandes en tant qu'utilisateur du serveur web.
La migration documentée transfère les utilisateurs et groupes autorisés, les fichiers du répertoire personnel de chaque utilisateur autorisé, ainsi que les partages d'utilisateurs, de groupes et de liens. Elle ne transfère pas les utilisateurs désactivés, les fichiers leur appartenant, les mots de passe ni les points de montage externes. Les partages et fichiers reçus sur des points de montage externes sont exclus du transfert. Si vos utilisateurs dépendent d'un stockage SMB/S3 monté, de points de montage d'administration partagés ou de référentiels externes existants, veuillez les inventorier et planifier une procédure de copie et de recréation distincte avant de programmer la bascule.
Par exemple, une petite équipe disposant de comptes locaux et de fichiers dans des répertoires personnels peut utiliser le flux de migration intégré pour les utilisateurs locaux. Une entreprise dont les comptes sont hébergés dans LDAP doit d'abord s'assurer qu'oCIS peut résoudre les mêmes utilisateurs et groupes, puis suivre les exigences spécifiques à LDAP. La procédure documentée ne prend pas en charge un environnement mixte d'utilisateurs locaux et LDAP. Pour la production ou les déploiements de grande envergure, ownCloud recommande l'utilisation d'un véritable système LDAP ou d'un système de gestion des identités externe plutôt que le système de gestion des identités intégré à oCIS, dont les fonctionnalités sont limitées.
Préparez les deux serveurs avant d'exécuter les commandes de migration.
- Inventaire et sauvegarde. Consignez les comptes activés et désactivés, les appartenances aux groupes, les montages de stockage, les liens de partage, les intégrations d'applications et l'ensemble des données. Créez et vérifiez des sauvegardes restaurables de la base de données et des données Classic, puis sauvegardez la configuration cible. Une migration n'est pas une sauvegarde. Maintenez l'instance Classic d'origine accessible jusqu'à ce que les utilisateurs confirment le nouveau service.
- Installez l'application de migration. Téléchargez
migrate-to-ocis-la depuis le support ownCloud, installez-la dans le répertoire Classic appsou apps-externalun répertoire dont vous disposez des droits d'accès appropriés, puis activez-la. Exemple, en supposant le chemin d'installation par défaut et le compte Apachewww-data :
sudo -u www-data php /var/www/owncloud/occ app:enable migrate_to_ocis
Adaptez le chemin d'accès et le compte du système d'exploitation à votre installation. L'application de migration intègre son propre fichier binaire rclone ; par conséquent, n'utilisez pas de procédure de copie manuelle distincte à la place du flux de travail documenté de l'application sans plan de migration fourni par ownCloud.
- Préparez l'authentification oCIS. Activez le
auth-appservice et l'emprunt d'identité. Les paramètres d'environnement documentés sontOCIS_ADD_RUN_SERVICES: "auth-app" : PROXY_ENABLE_APP_AUTH: true[ AUTH_APP_ENABLE_IMPERSONATION: trueliste des paramètres]. Créez un jeton d'application pour l'administrateur oCIS via l'application d'authentification. La migration utilise le nom d'utilisateur de l'administrateur et ce jeton pour les opérations oCIS. Stockez le jeton en lieu sûr ; ne le collez pas dans l'historique d'un shell partagé ni dans la configuration d'un article.
- Commencez par résoudre l'identité des utilisateurs. Chaque utilisateur Classic activé doit posséder une adresse e-mail valide et unique. Si vous utilisez LDAP, assurez-vous qu'oCIS puisse authentifier les utilisateurs avant la migration et configurez correctement le nom d'utilisateur et les attributs de schéma LDAP. L'attribut de nom d'utilisateur LDAP Classic doit utiliser un nom d'utilisateur stable, tel que «
uid mon_utilisateur » ou samAccountName« mon_utilisateur », plutôt qu'un UUID interne qui ne correspond pas aux identités oCIS. Les noms d'utilisateurs et de groupes doivent être identiques dans tous les systèmes concernés. Après la phase d'authentification de la migration, ne modifiez ni n'ajoutez de comptes ou de groupes.
Exécutez la migration dans l'ordre
Les commandes ci-dessous utilisent /var/www/owncloud, à titre d'exemple www-data, un hôte oCIS nommé « oCIS » ocis.example.com. Remplacez-les par vos valeurs réelles. Le mot de passe administrateur est demandé de manière interactive par les commandes de migration.
- Initialisez et vérifiez la source. L'initialisation enregistre l'hôte de destination pour les étapes suivantes :
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:init ocis.example.com
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:verify
Vérifiez les résultats de la vérification et corrigez les adresses e-mail manquantes ou en double avant de poursuivre. Ne négligez pas la vérification pour gagner du temps ; l’option permettant de l’ignorer, bien que documentée, vous rend responsable des problèmes liés aux e-mails. Évitez cette option, --insecuresauf pour un test contrôlé avec un problème de certificat que vous comprenez. Corrigez la confiance TLS avant une migration en production.
- Configurez les utilisateurs et attribuez-leur des rôles. Pour les utilisateurs locaux utilisant le flux IDM intégré documenté, exécutez :
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:users ocis-admin
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:assign-role ocis-admin
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:groups ocis-admin
L'étape d'attribution des rôles est obligatoire. Un rôle oCIS sélectionné est attribué aux utilisateurs Classic migrés ; les rôles Classic ne sont pas conservés et les privilèges de sous-administrateur n'ont pas d'équivalent. Vérifiez individuellement les comptes d'administrateur et n'accordez des privilèges oCIS élevés que lorsque cela est nécessaire. Si LDAP provisionne déjà les utilisateurs, suivez la procédure LDAP officielle et utilisez les options d'ignorance prises en charge lorsque cela est indiqué, au lieu de dupliquer les comptes.
- Transférez les fichiers, puis les partages. Exécutez ces commandes une fois les identités des utilisateurs et des groupes définies :
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:files ocis-admin
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:shares ocis-admin
Les fichiers du répertoire personnel Classic de chaque utilisateur sont transférés vers son espace personnel. Les montages externes et les partages reçus sont exclus. La commande « shares » gère les partages d'utilisateurs, de groupes et de liens, mais des erreurs concernant des utilisateurs ou des groupes manquants peuvent être signalées pendant la migration. Les liens protégés par mot de passe reçoivent un nouveau mot de passe différent de celui de Classic ; les liens sans mot de passe peuvent ne pas fonctionner avec la politique oCIS par défaut. Veuillez demander aux utilisateurs de remplacer les liens publiés et de diffuser les nouveaux mots de passe via un canal sécurisé.
Valider l'accès avant la mise en service
Une fois les commandes terminées, comparez un échantillon d'utilisateurs, de groupes, d'arborescences de dossiers, de nombre de fichiers, de permissions et de partages de clés avec votre inventaire. Effectuez des tests avec des comptes d'utilisateurs ordinaires, et pas seulement avec le compte administrateur. Assurez-vous que le stockage externe a bien été recréé et ses données copiées via une procédure dédiée. Prévoyez une procédure de réinitialisation des mots de passe ou d'intégration, car les anciens mots de passe des utilisateurs migrés ne sont pas transférés.
Maintenez le service Classic disponible pendant la validation et la communication de la modification. Pour une bascule finale cohérente, planifiez un gel des écritures, empêchez toute nouvelle modification sur la source et tenez compte des modifications apportées depuis l'exécution de la migration ; la séquence documentée ne garantit pas une synchronisation continue. Ne redirigez les utilisateurs et les clients qu'une fois les vérifications réussies. Conservez une fenêtre de restauration et une sauvegarde fonctionnelle, et ne réinitialisez pas et ne relancez pas la migration sur une cible déjà remplie sans comprendre le comportement de réinitialisation documenté : --forcel'état de la migration est rétabli, mais les données cibles déjà migrées restent en place ; la cible doit donc être nettoyée avant de redémarrer.
Références officielles