Alt-Daten aus einer 1.x-Installation übernehmen

Übersicht

Der Import macht aus einem Mandanten Ihrer alten 1.x-Installation einen neuen Mandanten Ihrer laufenden 2.x-Instanz. Übernommen werden Projekte, Aufgaben, Kosten, Risiken, Nutzer samt Passwörtern sowie Anhänge, Avatare und Projektbilder. Das Altsystem wird dabei nicht gestartet - gelesen wird ein kalter Abzug.

Voraussetzungen

Eine laufende, eingerichtete 2.x-Instanz
Freier Plattenplatz mindestens in Größe der Alt-Dateiablage, zusätzlich zum ohnehin nötigen
Zwei Dateien aus dem Altsystem: backup.archive (Datenbankabzug der gestoppten Alt-Instanz) und backup.tar.gz (die Dateiablagen ws-dms und ws-tenantdata)

Die Alt-Dateien erzeugen

Auf dem alten Server, nach dem Stoppen der Anwendung:

docker compose down

docker compose up -d mongo
docker compose exec -T mongo mongodump --archive --gzip > backup.archive
docker compose down

docker run --rm \
  -v ws-dms:/daten/ws-dms:ro \
  -v ws-tenantdata:/daten/ws-tenantdata:ro \
  -v "$PWD":/ziel \
  alpine tar czf /ziel/backup.tar.gz -C /daten ws-dms ws-tenantdata

Die genauen Namen von Diensten und Ablagen können abweichen; docker volume ls zeigt die vorhandenen. Übertragen Sie beide Dateien auf den neuen Server.

Schritt-für-Schritt-Anleitung

Nachsehen, welche Mandanten der Abzug enthält
```
sudo wsp import --list --archive /pfad/backup.archive
```
- Rein lesend, braucht keine laufende Instanz
- Enthält der Abzug einen Mandanten, wählt wsp ihn selbst; bei mehreren geben Sie --tenant-db an
Probelauf durchführen
```
sudo wsp import --dry-run
```
- Der Probelauf ist Pflicht: Er führt denselben Ablauf aus wie der Echtlauf, schreibt in die Datenbank und nimmt am Ende alles zurück
- Über die Oberfläche: Alt-Daten übernehmen (1.x); dort läuft immer zuerst der Probelauf
Den Bericht lesen
- Erst wenn er in Ordnung ist, folgt der Echtlauf
Echtlauf starten
```
sudo wsp import \
  --archive /daten/backup.archive \
  --files   /daten/backup.tar.gz
```
- Liegen die Dateien unter genau diesen Namen im Aufrufverzeichnis, findet wsp sie selbst
Abnahme durchführen
- Mit einem Alt-Konto anmelden; das Passwort aus dem Altsystem gilt weiter
- Ein Projekt mit Kosten öffnen und die Zahlen vergleichen
- Kanban ansehen, einen Anhang herunterladen, ein Profil- und ein Projektbild prüfen
- Berichte und Auswertungen stichprobenartig gegenprüfen
Lizenz umhängen
- Erst wenn die Anmeldung im übernommenen Mandanten nachweislich funktioniert
- Den bei der Installation entstandenen Mandanten löschen
- Im übernommenen Mandanten unter Einstellungen → Lizenz den Schlüssel eintragen

Den Bericht lesen

Nach dem Lauf liegt migration-report.json im Arbeitsverzeichnis unter /var/lib/wsp/import/<zeit>/. Er enthält je Datenbereich, wie viel gelesen, geschrieben und ausgelassen wurde, jede Anpassung mit Beleg und alle Hinweise. Zwei Befunde hebt wsp eigens hervor:

Befund	Bedeutung
`Binärdatei fehlt`	Eintrag übernommen, Datei fehlt
`NICHT übernommen`	Datensatz nicht übersetzbar

Bewahren Sie den Bericht auf, er ist die Grundlage für die Abnahme.

Häufige Fehler und Tipps

Hinweis: Jeder Lauf erzeugt einen neuen Mandanten.
- Die Rücknahme besteht darin, diesen Mandanten zu löschen. Der Alt-Abzug bleibt unangetastet, ein erneuter Lauf ist jederzeit möglich.
Hinweis: Alles oder nichts.
- Der Lauf hängt an einer einzigen Transaktion. Ein abgebrochener Lauf hinterlässt keine halben Daten.
Hinweis: Ein zweiter Lauf mit demselben Abzug bricht mit einem Schlüsselkonflikt ab.
- Die Kennungen sind aus dem Altsystem abgeleitet. Das ist Absicht, damit nichts stillschweigend doppelt entsteht.
Hinweis: Verbindungen zu Fremdsystemen werden nicht übernommen.
- Kalender-, Jira- und Mailanbindungen sowie Anmeldungen über einen Fremdanbieter richten Sie in der neuen Instanz neu ein.
Hinweis: Ohne backup.tar.gz läuft der Import ebenfalls.
- Dann ohne Anhänge und Bilder; der Bericht weist jede fehlende Datei einzeln aus.
Tipp: Passt die Schemaprüfung nicht, erst die Instanz aktualisieren.
- Dabei auch wsp auf den aktuellen Stand bringen.

Wie übernehme ich Daten aus WORKSPACE.PM 1.x?