Utilizza l'app dedicata di ownCloud migrate-to-ocise i relativi occcomandi per trasferire utenti, gruppi, file e condivisioni supportate da ownCloud Classic 10 a un'istanza di ownCloud Infinite Scale (oCIS) installata separatamente. Si tratta di una migrazione a fasi, non di un aggiornamento in loco: la destinazione deve essere raggiungibile, predisposta per l'autenticazione e l'impersonificazione e priva di dati in conflitto. Pianifica il ripristino delle password, la riassegnazione dei ruoli e la gestione manuale dei mount esterni.
Verifica se questa migrazione è compatibile con la tua configurazione.
La documentazione di ownCloud sulla migrazione a Server 10.16 descrive un percorso supportato che utilizza un'app fornita da ownCloud nell'ambito di una migrazione guidata. L'app non è disponibile nel Marketplace; per ottenerla, contattare l'assistenza di ownCloud. Sia il server di origine che quello di destinazione devono essere configurati, in esecuzione e in grado di comunicare tra loro. È inoltre necessario disporre dell'accesso SSH al server Classic e della possibilità di eseguire occcomandi come utente del server web.
La migrazione documentata trasferisce utenti e gruppi abilitati, file nella directory home di ciascun utente abilitato e condivisioni di utenti, gruppi e collegamenti. Non trasferisce utenti disabilitati, file di proprietà di utenti disabilitati, password o mount esterni. Le condivisioni ricevute e i file in posizioni di mount esterne sono esclusi dal trasferimento dei file. Se i tuoi utenti si affidano a storage SMB/S3 montato, mount amministrativi condivisi o repository esterni esistenti, inventariali e pianifica un processo di copia e ricreazione separato prima di programmare il passaggio.
Ad esempio, un piccolo team con account locali e file nelle directory personali potrebbe utilizzare il flusso di migrazione degli utenti locali integrato. Un'azienda i cui account sono in LDAP dovrebbe innanzitutto assicurarsi che oCIS sia in grado di risolvere gli stessi utenti e gruppi, quindi seguire i requisiti specifici di LDAP. La procedura documentata non supporta una popolazione mista di utenti locali e LDAP. Per ambienti di produzione o implementazioni di grandi dimensioni, ownCloud consiglia un vero sistema LDAP o un sistema di gestione delle identità esterno al posto del limitato IDM integrato di oCIS.
Preparare entrambi i server prima di eseguire i comandi di migrazione.
- Inventario e backup. Registrare gli account abilitati e disabilitati, l'appartenenza ai gruppi, i punti di montaggio dello storage, i collegamenti di condivisione, le integrazioni con le applicazioni e l'intero set di dati. Eseguire e verificare backup ripristinabili del database e dei dati di Classic ed eseguire il backup della configurazione di destinazione. Una migrazione non è un backup. Mantenere disponibile l'istanza Classic originale fino a quando gli utenti non confermano il nuovo servizio.
- Installa l'app di migrazione. Scarica l'
migrate-to-ocisapp dal supporto di ownCloud, installala nella directory Classic appso apps-externalin quella con i permessi di proprietà corretti e abilitala. Esempio, supponendo il percorso di installazione predefinito e www-datal'account Apache:
sudo -u www-data php /var/www/owncloud/occ app:enable migrate_to_ocis
Regola il percorso e l'account del sistema operativo in modo che corrispondano alla tua installazione. L'app di migrazione include il proprio binario rclone, quindi non sostituire il flusso di lavoro documentato dell'app con una procedura di copia manuale separata senza un piano di migrazione di ownCloud.
- Preparare l'autenticazione oCIS. Abilitare il
auth-appservizio e l'impersonificazione. Le impostazioni dell'ambiente documentate sono OCIS_ADD_RUN_SERVICES: "auth-app", PROXY_ENABLE_APP_AUTH: true, e AUTH_APP_ENABLE_IMPERSONATION: true. Creare un token dell'app per l'amministratore oCIS tramite l'app di autenticazione. La migrazione utilizza il nome utente dell'amministratore e questo token per le operazioni oCIS. Archiviare il token in modo sicuro; non incollarlo nella cronologia della shell condivisa o nella configurazione dell'articolo.
- Innanzitutto, risolvete il problema dell'identità dell'utente. Ogni utente Classic abilitato necessita di un indirizzo email valido e univoco. Se utilizzate LDAP, assicuratevi che oCIS possa accedere agli utenti prima della migrazione e configurate correttamente gli attributi del nome utente e dello schema LDAP. L'attributo del nome utente LDAP Classic dovrebbe utilizzare un nome di accesso stabile, come
uido samAccountName, anziché un UUID interno che non corrisponde alle identità di oCIS. I nomi utente e di gruppo devono corrispondere in tutti i sistemi pertinenti. Non aggiungete, eliminate o rinominate account o gruppi dopo la fase di identità della migrazione.
Eseguire la migrazione in ordine
I comandi seguenti utilizzano /var/www/owncloud, www-data, e un host oCIS denominato ocis.example.comcome esempi. Sostituiscili con i tuoi valori effettivi. La password di amministratore viene richiesta in modo interattivo dai comandi di migrazione.
- Inizializza e verifica l'origine. L'inizializzazione registra l'host di destinazione per le fasi successive:
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
Esamina l'output della verifica e correggi gli indirizzi email mancanti o duplicati prima di continuare. Non saltare la verifica solo per velocizzare il processo; l'opzione di salto documentata ti rende responsabile dei problemi relativi agli indirizzi email. Evita questa procedura, --insecurea meno che non si tratti di un test controllato con un problema di certificato che conosci. Risolvi i problemi di attendibilità TLS per una migrazione in ambiente di produzione.
- Configura gli utenti e assegna i ruoli. Per gli utenti locali che utilizzano il flusso IDM integrato documentato, esegui:
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
La fase di assegnazione dei ruoli è obbligatoria. Agli utenti Classic migrati viene assegnato un ruolo oCIS selezionato; i ruoli Classic non vengono mantenuti e i privilegi di subamministratore non hanno un ruolo equivalente. Verificare singolarmente gli account amministratore e concedere privilegi oCIS elevati solo dove previsto. Se LDAP ha già predisposto gli utenti, seguire la procedura LDAP ufficiale e utilizzare le opzioni di salto supportate, ove indicato, anziché duplicare gli account.
- Trasferisci i file, poi le condivisioni. Esegui questi passaggi dopo che le identità utente e di gruppo sono pronte:
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
I file presenti nella directory home Classic di ciascun utente vengono trasferiti nello spazio personale di quell'utente. Sono esclusi i mount esterni e le condivisioni ricevute. Il comando shares gestisce le condivisioni di utenti, gruppi e collegamenti, ma gli errori relativi a utenti o gruppi mancanti potrebbero essere segnalati durante la migrazione. I collegamenti protetti da password riceveranno una nuova password che non corrisponderà alla password Classic; i collegamenti senza password potrebbero non funzionare con i criteri oCIS predefiniti. Informare gli utenti di sostituire i collegamenti pubblicati e distribuire le password aggiornate tramite un canale sicuro.
Convalidare l'accesso prima del passaggio
Al termine dell'esecuzione dei comandi, confronta un campione di utenti, gruppi, strutture di cartelle, conteggi di file, autorizzazioni e condivisioni di chiavi con il tuo inventario. Esegui i test con account utente ordinari, non solo con l'amministratore. Verifica che l'archiviazione esterna sia stata ricreata e che i relativi dati siano stati copiati tramite una procedura pianificata separatamente. Prepara le procedure di reimpostazione della password o di onboarding, poiché le vecchie password degli utenti migrati non vengono trasferite.
Mantenere il servizio Classic disponibile durante la convalida e la comunicazione della modifica. Per un passaggio finale coerente, pianificare un blocco delle scritture, impedire nuove modifiche sull'origine e tenere conto di tutte le modifiche apportate dall'esecuzione della migrazione; la sequenza documentata non garantisce una sincronizzazione continua. Reindirizzare utenti e client solo dopo che i controlli sono stati superati. Mantenere una finestra di rollback e un backup valido e non reimpostare e rieseguire su una destinazione popolata senza aver compreso il comportamento di reimpostazione documentato: --forceriavvia lo stato della migrazione ma lascia i dati di destinazione già migrati, quindi la destinazione deve essere pulita prima del riavvio.
Riferimenti ufficiali