Wechseln Sie ownCloud Classic mit einer unterstützten Migration zu oCIS.

Verwenden Sie die ownCloud- migrate-to-ocisApp und ihre occBefehle, um Benutzer, Gruppen, Dateien und unterstützte Freigaben von ownCloud Classic 10 auf eine separat installierte ownCloud Infinite Scale (oCIS)-Instanz zu übertragen. Dies ist eine schrittweise Migration, kein direktes Upgrade: Das Zielsystem muss erreichbar, für Authentifizierung und Identitätswechsel vorbereitet und frei von Datenkonflikten sein. Planen Sie das Zurücksetzen von Passwörtern, die Neuzuweisung von Rollen und die manuelle Verwaltung externer Einbindungen ein.

Prüfen Sie, ob diese Migration zu Ihrer Konfiguration passt.

Die aktuelle Migrationsdokumentation für ownCloud Server 10.16 beschreibt einen unterstützten Migrationspfad mithilfe einer von ownCloud bereitgestellten App. Diese App ist nicht im Marketplace verfügbar; wenden Sie sich bitte an den ownCloud-Support. Quell- und Zielsystem müssen konfiguriert sein, laufen und miteinander kommunizieren können. Sie benötigen außerdem SSH-Zugriff auf den Classic-Server und die Berechtigung, occBefehle als Webserver-Benutzer auszuführen.

Die dokumentierte Migration überträgt aktivierte Benutzer und Gruppen, Dateien im jeweiligen Benutzerverzeichnis sowie Benutzer-, Gruppen- und Linkfreigaben. Deaktivierte Benutzer, deren Dateien, Passwörter und externe Einbindungen werden nicht übertragen. Empfangene Freigaben und Dateien auf externen Einbindungsstellen sind von der Dateiübertragung ausgeschlossen. Falls Ihre Benutzer auf eingebundenen SMB/S3-Speicher, freigegebene Administratoreinbindungen oder bestehende externe Repositories angewiesen sind, erstellen Sie eine Bestandsaufnahme dieser Daten und planen Sie einen separaten Kopier- und Wiederherstellungsprozess, bevor Sie die Umstellung terminieren.

Beispielsweise kann ein kleines Team mit lokalen Benutzerkonten und Dateien in persönlichen Home-Verzeichnissen den integrierten Migrationsprozess für lokale Benutzer nutzen. Unternehmen, deren Benutzerkonten in LDAP verwaltet werden, sollten zunächst sicherstellen, dass oCIS dieselben Benutzer und Gruppen auflösen kann, und anschließend die LDAP-spezifischen Anforderungen befolgen. Die dokumentierte Vorgehensweise unterstützt keine gemischte Benutzergruppe aus lokalen Benutzern und LDAP-Benutzern. Für Produktionsumgebungen oder größere Installationen empfiehlt ownCloud ein echtes LDAP- oder externes Identitätsmanagementsystem anstelle des eingeschränkten, in oCIS integrierten IDM.

Bereiten Sie beide Server vor, bevor Sie die Migrationsbefehle ausführen.

  1. Inventarisierung und Datensicherung. Erfassen Sie aktivierte und deaktivierte Konten, Gruppenzugehörigkeiten, Speichereinbindungen, Freigabelinks, Anwendungsintegrationen und den gesamten Datensatz. Erstellen und überprüfen Sie wiederherstellbare Backups der Classic-Datenbank und der Daten und sichern Sie die Zielkonfiguration. Eine Migration ist kein Backup. Halten Sie die ursprüngliche Classic-Instanz so lange verfügbar, bis die Benutzer den neuen Dienst bestätigen.
  2. Installieren Sie die Migrations-App. Sie erhalten die migrate-to-ocisApp vom ownCloud-Support, installieren sie im Classic apps- apps-externalVerzeichnis mit den korrekten Besitzrechten und aktivieren sie. Beispiel (bei Verwendung des Standardinstallationspfads und des Apache- www-dataKontos):
sudo -u www-data php /var/www/owncloud/occ app:enable migrate_to_ocis

Passen Sie Pfad und Betriebssystemkonto an Ihre Installation an. Die Migrations-App enthält eine eigene rclone-Binärdatei. Verwenden Sie daher ohne Migrationsplan von ownCloud keine separate manuelle Kopierprozedur anstelle des dokumentierten App-Workflows.

  1. Bereiten Sie die oCIS-Authentifizierung vor. Aktivieren Sie den auth-appDienst und die Identitätswechselfunktion. Die dokumentierten Umgebungseinstellungen sind OCIS_ADD_RUN_SERVICES: "auth-app"[ PROXY_ENABLE_APP_AUTH: truehier die AUTH_APP_ENABLE_IMPERSONATION: trueEinstellungen einfügen]. Erstellen Sie über die Authentifizierungs-App ein App-Token für den oCIS-Administrator. Die Migration verwendet den Administrator-Benutzernamen und dieses Token für oCIS-Operationen. Bewahren Sie das Token sicher auf; fügen Sie es nicht in einen gemeinsam genutzten Shell-Verlauf oder eine Artikelkonfiguration ein.
  2. Zuerst muss die Benutzeridentität geklärt werden. Jeder aktivierte Classic-Benutzer benötigt eine gültige, eindeutige E-Mail-Adresse. Bei Verwendung von LDAP muss sichergestellt werden, dass oCIS Benutzer vor der Migration anmelden kann und die korrekten LDAP-Benutzernamen und Schemaattribute konfiguriert sind. Das Classic-LDAP-Benutzernameattribut sollte einen stabilen Anmeldenamen wie z. B. „Benutzername“ oder „Benutzername“ verwenden uid, samAccountNameanstatt einer internen UUID, die nicht mit den oCIS-Identitäten übereinstimmt. Benutzer- und Gruppennamen müssen in allen relevanten Systemen übereinstimmen. Nach Abschluss der Identitätsmigration dürfen keine Konten oder Gruppen hinzugefügt, gelöscht oder umbenannt werden.

Führen Sie die Migration in der angegebenen Reihenfolge aus.

Die folgenden Befehle verwenden /var/www/owncloud, www-data, und einen oCIS-Hostnamen ocis.example.comals Beispiele. Ersetzen Sie diese durch Ihre tatsächlichen Werte. Das Administratorpasswort wird interaktiv von den Migrationsbefehlen angefordert.

  1. Initialisieren und überprüfen Sie die Quelle. Bei der Initialisierung wird der Zielhost für die nachfolgenden Schritte festgelegt:
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

Überprüfen Sie die Verifizierungsergebnisse und korrigieren Sie fehlende oder doppelte E-Mails, bevor Sie fortfahren. Überspringen Sie die Verifizierung nicht, nur um schneller voranzukommen; die dokumentierte Überspringoption macht E-Mail-bezogene Probleme zu Ihrer Verantwortung. Vermeiden Sie dies --insecureaußer bei einem kontrollierten Test mit einem Zertifikatsproblem, das Sie verstehen. Stellen Sie die TLS-Vertrauensstellung für eine Produktionsmigration wieder her.

  1. Benutzer bereitstellen und Rollen zuweisen. Für lokale Benutzer, die den dokumentierten eingebetteten IDM-Ablauf verwenden, führen Sie Folgendes aus:
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

Die Rollenzuweisung ist obligatorisch. Migrierten Classic-Benutzern wird eine ausgewählte oCIS-Rolle zugewiesen; Classic-Rollen bleiben nicht erhalten, und Subadministratorrechte haben keine entsprechende Rolle. Überprüfen Sie Administratorkonten einzeln und erteilen Sie erhöhte oCIS-Berechtigungen nur, wenn dies beabsichtigt ist. Falls die Benutzer bereits über LDAP bereitgestellt wurden, folgen Sie dem offiziellen LDAP-Verfahren und verwenden Sie die unterstützten Überspringoptionen, anstatt Konten zu duplizieren.

  1. Übertragen Sie anschließend die Dateien und Freigaben. Führen Sie diese Schritte aus, nachdem Benutzer- und Gruppenidentitäten eingerichtet sind:
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

Dateien im Classic-Home-Verzeichnis jedes Benutzers werden in dessen persönlichen Bereich verschoben. Externe Einbindungen und empfangene Freigaben werden dabei nicht berücksichtigt. Der Befehl „shares“ verarbeitet Benutzer-, Gruppen- und Linkfreigaben. Fehler bezüglich fehlender Benutzer oder Gruppen können während der Migration gemeldet werden. Passwortgeschützte Links erhalten ein neues Passwort, das nicht mit dem Classic-Passwort übereinstimmt. Passwortlose Links können gemäß der Standardrichtlinie von oCIS fehlschlagen. Weisen Sie die Benutzer an, veröffentlichte Links zu ersetzen und aktualisierte Passwörter über einen sicheren Kanal zu verteilen.

Zugriff vor der Umstellung prüfen

Vergleichen Sie nach Abschluss der Befehle eine Stichprobe von Benutzern, Gruppen, Ordnerstrukturen, Dateianzahlen, Berechtigungen und Schlüsselfreigaben mit Ihrem Inventar. Testen Sie dies mit normalen Benutzerkonten, nicht nur mit dem Administratorkonto. Stellen Sie sicher, dass der externe Speicher neu erstellt und dessen Daten in einem separat geplanten Prozess kopiert wurden. Bereiten Sie Passwortzurücksetzungen oder die Einarbeitung neuer Benutzer vor, da die alten Passwörter migrierter Benutzer nicht übertragen werden.

Halten Sie den Classic-Dienst während der Validierung und Kommunikation der Änderung verfügbar. Für eine konsistente finale Umstellung planen Sie einen Schreibstopp, verhindern Sie weitere Änderungen am Quellsystem und berücksichtigen Sie alle Änderungen seit der Migration. Die dokumentierte Vorgehensweise garantiert keine kontinuierliche Synchronisierung. Leiten Sie Benutzer und Clients erst nach erfolgreichen Prüfungen um. Halten Sie ein Rollback-Fenster und ein funktionierendes Backup bereit und führen Sie keinen Reset auf einem bereits migrierten Zielsystem durch, ohne das dokumentierte Reset-Verhalten zu verstehen: --forceDer Migrationsstatus wird zwar neu gestartet, die bereits migrierten Zieldaten bleiben jedoch erhalten. Daher muss das Zielsystem vor dem Neustart bereinigt werden.

Offizielle Referenzen

Einen Kommentar hinterlassen

Automatisieren Sie ownCloud-Datenbank-Dumps mit einem sicheren nächtlichen Cron-Job

Automatisieren Sie ownCloud-Datenbank-Dumps mit einem sicheren nächtlichen Cron-Job

Planen Sie geschützte MariaDB-Dumps für ownCloud Server, handhaben Sie den Wartungsmodus sicher und überprüfen Sie jedes Backup, bevor Sie sich darauf verlassen.

Wechseln Sie ownCloud Classic mit einer unterstützten Migration zu oCIS.

Planen Sie eine Migration von ownCloud 10 zu oCIS mit der unterstützten App, geordneten Befehlen, Identitätsprüfungen und einer klaren Liste der Daten, die eine separate Behandlung erfordern.

ownCloud Classic 10 mit Theme-App und CSS

Ersetzen Sie die ownCloud Classic 10-Logos und passen Sie die Farben der Web-Benutzeroberfläche mit einer Design-App an, ohne dabei Probleme bei Upgrades und Integritätsprüfungen zu riskieren.

Festlegen von Standard-Speicherkontingenten nach Benutzerrolle in ownCloud oCIS

Festlegen von Standard-Speicherkontingenten nach Benutzerrolle in ownCloud oCIS

Weisen Sie neuen ownCloud Infinite Scale-Benutzern rollenbasierte Speicherlimits auf Byte-Basis zu, inklusive eines proxy.yaml-Beispiels und einer Checkliste zur sicheren Überprüfung.

Behebung von ownCloud-Synchronisierungszertifikatfehlern an der TLS-Quelle

Behebung von ownCloud-Synchronisierungszertifikatfehlern an der TLS-Quelle

Stellen Sie die ownCloud-Desktop-Synchronisierung wieder her, indem Sie den Server-Hostnamen, die Zertifikatskette, die Vertrauensstellung der privaten Zertifizierungsstelle und Probleme mit dem Captive Portal überprüfen, ohne die TLS-Verifizierung zu deaktivieren.

ownCloud-Integritätswarnung nach einem Upgrade löschen

Verwenden Sie den Bericht über ungültige Dateien, um nicht übereinstimmende Kerndateien oder App-Signaturen zu identifizieren, die korrekten Release-Dateien wiederherzustellen und die Integritätsprüfung sicher durchzuführen.

ownCloud Infinite Scale mit Docker Compose installieren

Stellen Sie ownCloud Infinite Scale anhand des offiziellen Compose-Beispiels bereit, konfigurieren Sie Domänen und persistenten Speicher und überprüfen Sie anschließend TLS, Container und die erste Anmeldung.

Konfigurieren Sie S3 Blob Storage für ownCloud Infinite Scale

Konfigurieren Sie S3 Blob Storage für ownCloud Infinite Scale

Richten Sie den S3NG-Treiber, die Bucket-Berechtigungen, die persistente Metadatenspeicherung und die Upload-Größe so ein, dass ownCloud Infinite Scale Dateiinhalte zuverlässig speichern kann.

Wenn ownCloud-Uploads bei 99 % hängen bleiben, überprüfen Sie diese Grenzwerte.

Wenn ownCloud-Uploads bei 99 % hängen bleiben, überprüfen Sie diese Grenzwerte.

Finden Sie heraus, warum ein Upload auf einem ownCloud-Server kurz vor Abschluss abbricht, indem Sie den Dateistatus, das Kontingent, den temporären Speicherplatz, die PHP-Limits und die Proxy-Timeouts überprüfen.

ownCloud Apache .htaccess-Warnung sicher löschen

ownCloud Apache .htaccess-Warnung sicher löschen

Setzen Sie AllowOverride All nur für das Web-Root-Verzeichnis von ownCloud, überprüfen Sie den aktiven Apache-Vhost und laden Sie die Seite sicher neu, um die .htaccess-Regeln wiederherzustellen.