Diese Seite richtet sich an Personen, die aktuell Confluence Cloud nutzen und zu Confluence Data Center (eine selbst gehostete Confluence-Instanz) wechseln möchten.

Vor Beginn

Es gibt ein paar Dinge, die du verstehen solltest, bevor du mit diesem Vorgang beginnst.

Mindest-Confluence-Version

Du kannst von Confluence Cloud zu Confluence Data Center 6.0 oder höher migrieren. Der Import von Cloud-Daten (entweder der gesamten Instanz oder einzelner Bereiche) in frühere Versionen von Confluence Data Center wird nicht unterstützt.

Wir empfehlen, entweder die neueste Confluence-Version oder das neueste Enterprise-Release zu installieren. Die Confluence Upgrade Matrix (Englisch) hilft dir, die richtige Version für deine Organisation zu wählen.

Funktionen und App-Verfügbarkeit

Manche Cloud-Funktionen sind in Confluence Data Center nicht verfügbar. Auch die Navigation und die Nutzererfahrung unterscheiden sich an manchen Stellen. Die Kernfunktionalität von Confluence bleibt jedoch gleich.

Marketplace-Apps werden nicht automatisch migriert. Beim Einrichten deiner Confluence Data Center Instanz musst du jede deiner Apps neu installieren.

Nicht alle Apps sind sowohl für Cloud als auch für Data Center verfügbar. Prüfe bei der Planung deiner Migration im Atlassian Marketplace, ob deine wichtigsten Apps für Data Center verfügbar sind, und erstelle eine Liste der Apps, die du neu installieren musst.

Vorlagen

Alle Seiten, die aus einer Vorlage erstellt wurden, werden migriert.

Alle benutzerdefinierten Vorlagen, die du in deiner Confluence Cloud Site erstellt hast, werden jedoch nicht migriert. Du musst deine Vorlagen neu erstellen, sobald deine Migration abgeschlossen ist.

Beachte außerdem, dass die Anzahl der integrierten Vorlagen (bekannt als Blueprints) in Confluence Data Center eingeschränkter ist, sodass einige der Standardvorlagen, die du bisher genutzt hast, möglicherweise nicht verfügbar sind.

Teamkalender- und Questions-Daten

Confluence Questions und Teamkalender-Daten können nicht migriert werden, da es derzeit keine Möglichkeit gibt, diese Daten aus Confluence Cloud zu exportieren.

Migrationsansatz

Du kannst wählen, ob du deine gesamte Instanz auf einmal migrierst oder die Inhalte deines Teams bereichsweise importierst.

Eine vollständige Site-Migration umfasst einen vollständigen Site-Export (Backup) und den Import dieser Datei in Confluence Data Center. Nutzer und Gruppen sind in diesem Export enthalten. Alle Bereiche werden migriert, einschließlich archivierter Bereiche und persönlicher Bereiche.

Eine bereichsweise Migration umfasst den Export jedes Bereichs einzeln (Englisch) und den Import dieser Dateien nacheinander in Confluence Data Center. So kannst du auswählen, welche Bereiche du migrieren möchtest, oder die Migration schrittweise über einen längeren Zeitraum durchführen. Nutzer und Gruppen werden dabei nicht automatisch migriert. Wenn du Confluence Data Center mit einem externen Benutzerverzeichnis verbunden hast oder deine neue Site bereits mit Benutzerkonten befüllt hast, versuchen wir, den Inhalt beim Import den richtigen Personen zuzuordnen.

Infrastruktur- und Datenbankwahl

Wo du Confluence Data Center hostest, bleibt dir überlassen. Sieh dir Supported Platforms (Englisch) an, um herauszufinden, welche Betriebssysteme und Datenbanken unterstützt werden.

Du kannst jede auf der Seite Supported Platforms (Englisch) gelistete Datenbank verwenden. Falls du noch keinen Datenbankserver hast, empfehlen wir PostgreSQL – darauf läuft auch Confluence Cloud.

Lizenzen

Du benötigst eine neue Lizenz, um zu Confluence Data Center zu migrieren. Deine bestehende Confluence Cloud Lizenz kann nicht verwendet werden. Eine neue Lizenz erhältst du unter my.atlassian.com. Du benötigst außerdem neue Lizenzen für alle kostenpflichtigen Marketplace-Apps.

Sichtbarkeit von Konten

In Confluence Cloud können Personen entscheiden, ihre Profilinformationen nicht sichtbar zu machen. Das bedeutet, dass beim Import einer Cloud-Instanz in Data Center Benutzerkontoinformationen wie der vollständige Name möglicherweise nicht enthalten sind.

Solange du beim Site-Export als Site-Administrator angemeldet bist, sind E-Mail-Adressen immer enthalten und werden als Nutzername verwendet, wenn die Benutzerkonten erstellt werden. Nutzer können sich danach anmelden und ihr Profil um die fehlenden Informationen ergänzen.

Migrationsschritte

Diese Seite führt dich durch eine vollständige Site-Migration.

Schritt 1: Prüfe deine Apps

So prüfst du, ob deine Apps kompatibel sind:

1. Falls du dich nicht bereits dort befindest, gehe zu deiner Confluence Cloud Instanz.
2. Klicke auf das Zahnrad-Symbol ⚙️ oben rechts, um die Confluence-Administration zu öffnen.
3. Suche Einstellungen > Apps in der Navigation auf der linken Seite.
4. Notiere dir alle von Nutzern installierten Apps.
5. Gehe zu marketplace.atlassian.com und prüfe für jede App, ob eine Data-Center-Edition verfügbar ist.

Schritt 2: Installiere Confluence Data Center

Wie du dabei vorgehst, hängt davon ab, wie du die Anwendung hosten möchtest.

Den Confluence Installation Guide (Englisch) findest du mit Links zu allen Installationsoptionen.

Schritt 3: Exportiere deine Confluence Cloud Instanz

So exportierst du deine Confluence Cloud Instanz:

1. Melde dich als Site-Administrator bei Confluence Cloud an.
2. Klicke auf das Zahnrad-Symbol ⚙️ oben rechts, um die Confluence-Administration zu öffnen.
3. Suche Einstellungen > Datenmanagement > Backup-Manager in der Navigation auf der linken Seite.
4. Folge den Anweisungen und lade die XML-Datei herunter.

Die Datei enthält alle Bereiche und Seiten (einschließlich Anhänge) sowie alle deine Nutzer und Gruppen.

Schritt 4: Importiere die Exportdatei deiner Confluence Cloud Instanz

Außer deine Exportdatei ist recht klein (weniger als 25 MB), empfehlen wir den Import über die Home-Verzeichnis-Methode.

So importierst du aus dem Home-Verzeichnis:

1. Kopiere deine Exportdatei nach <confluence-home>/restore. (Falls du nicht sicher bist, wo sich dieses Verzeichnis befindet: Der Pfad wird auf dem Bildschirm Backup and Restore angezeigt.)
2. Gehe zu ⚙️ > General configuration > Backup and Restore.
3. Wähle deine Site-Exportdatei unter Import from home directory aus.
4. Stelle sicher, dass Build Index aktiviert ist, damit dein Index automatisch erstellt wird.
5. Wähle Import aus.

Weitere Informationen zum Importvorgang findest du unter Restoring a Site (Englisch).

Schritt 5: Stelle Systemadministrator-Berechtigungen wieder her

Wenn du eine Exportdatei importierst, werden alle Benutzerkonten überschrieben – einschließlich des Systemadministrator-Kontos, das bei der Installation von Confluence erstellt wurde. Dein bestehendes Cloud-Site-Administrator-Konto erhält dadurch nicht automatisch Systemadministrator-Berechtigungen für Confluence Data Center.

So stellst du die Systemadministrator-Berechtigungen wieder her:

1. Stoppe Confluence.
2. Bearbeite <installation-directory>/bin/setenv.sh bzw. setenv.bat und füge folgende System-Property hinzu, wobei du <your-password> durch ein eindeutiges, temporäres Passwort ersetzt: -Datlassian.recovery.password=<your-password>. Weitere Informationen zur Nutzung von System-Properties findest du unter Configuring System Properties (Englisch).
3. Starte Confluence (Englisch) manuell (starte Confluence nicht als Dienst).
4. Melde dich bei Confluence mit dem Nutzernamen recovery_admin und dem temporären Passwort an, das du in der System-Property angegeben hast.
5. Gehe zu ⚙️ > User Management > Add Users.
6. Gib die Details für dein neues Systemadministrator-Konto ein und wähle Save aus. Achte auf ein starkes Passwort.
7. Wähle Edit Groups aus und wähle die Gruppe confluence-administrators aus. Das ist eine Super-Gruppe mit Systemadministrator-Berechtigungen.
8. Melde dich ab und bestätige, dass du dich mit deinem neuen Konto erfolgreich anmelden kannst.
9. Stoppe Confluence.
10. Bearbeite <installation-directory>/bin/setenv.sh bzw. setenv.bat und entferne die System-Property wieder.
11. Starte Confluence auf deinem gewohnten Weg neu (manuell oder als Dienst).

Weitere Informationen dazu findest du unter Restore Passwords To Recover Admin User Rights (Englisch).

Schritt 6: Installiere deine Apps

So installierst du deine Apps neu:

1. Melde dich als Administrator bei Confluence Data Center an.
2. Gehe zu ⚙️ > Manage apps.
3. Folge den Anweisungen, um nach den in Schritt 1 identifizierten Apps zu suchen oder sie hochzuladen. Du musst neue Lizenzen für diese Apps erwerben.

Denk daran, dass Teamkalender- und Questions-Daten nicht in deinem Export enthalten sind und aktuell nicht aus der Cloud migriert werden können.

Schritt 7: Prüfe deine Anwendungslinks

Wenn du mehrere Cloud-Apps hattest, wie zum Beispiel Jira, musst du möglicherweise Änderungen an den Anwendungslinks vornehmen.

So entfernst oder aktualisierst du Anwendungslinks:

1. Gehe zu ⚙️ > General configuration > Application links.
2. Folge den Anweisungen, um Anwendungslinks zu prüfen und zu aktualisieren, die jetzt auf die falsche Stelle zeigen.

Wenn du den Jira Cloud Anwendungslink nach dem Import nicht aus deiner Confluence-Instanz entfernen kannst, musst du diese Referenzen direkt aus der Confluence-Datenbank entfernen. Sieh dir dazu Alternative Methods of Deleting Application Links in Confluence (Englisch) an.

Fehlerbehebung

Beim Importieren deiner Cloud-Instanz können ein paar bekannte Probleme auftreten.

• Seiten lassen sich in Confluence Data Center nicht laden

Wenn nach dem Import Probleme beim Laden von Seiten auftreten, gehe zu ⚙️ > General configuration, um deine Basis-URL zu prüfen – der Port könnte sich geändert haben.

• Jira-Vorgangs-Makros sind defekt

Wenn deine Confluence Cloud Instanz Makros enthält, die von Anwendungslinks zu einer Jira Cloud Instanz abhängen, und du Jira ebenfalls migrierst, müssen diese Referenzen aktualisiert werden, damit sie korrekt funktionieren. Einen Workaround findest du unter APL-1144 (Englisch).

Du kannst die XML-Datei auch vor dem Import in Confluence Data Center bearbeiten oder diese Referenzen per Bulk-Bearbeitung in der Confluence-Datenbank ändern. Sieh dir dazu How to bulk update Jira Issue Macro to point to a different Jira instance (Englisch) an.

• Favoriten von Nutzern (markierte oder für später gespeicherte Seiten) fehlen

Wenn die Favoriten mancher Nutzer (für später gespeicherte Seiten) aufgrund von CONF-36348 (Englisch) fehlen, findest du weitere Informationen unter How to restore missing favorites after import from XML (Englisch).

• Manche Benutzerkonten fehlen oder wurden ohne Nutzerdetails erstellt

Nutzer können in Confluence Cloud ihre Profil-Sichtbarkeitseinstellungen ändern. Damit alle Nutzerdaten im Export enthalten sind, bitte einen Site-Administrator, den Export durchzuführen.