Bevor Sie beginnen
- Berechtigung zum Exportieren der relevanten Gruppeninhalte und personenbezogenen Informationen.
- Dokumentation für die Quellanwendung, das Exportformat und das vorgesehene Ziel.
- Ein separates Testziel mit unterbundenen ausgehenden Benachrichtigungen und externen Integrationen.
1. Entscheiden Sie, was das Paket Ihnen ermöglichen muss.
Schreiben Sie das beabsichtigte Ergebnis auf, bevor Sie eine Export-Schaltfläche auswählen. Eine lesbare Kopie für ein ausscheidendes Mitglied, ein Umzug in eine andere Anwendung und eine vollständige Wiederherstellung des bestehenden Dienstes erfordern unterschiedliches Material. Ein Export kann den ersten Zweck gut erfüllen und bei den anderen beiden versagen.
BookStack macht diese Unterscheidung explizit: Seine Werkzeuge zum Exportieren und Importieren von Inhalten sind nicht als Backup und Wiederherstellung gedacht. Eine lesbare HTML- oder PDF-Kopie ist nützlich, sollte aber nicht stillschweigend das Wiederherstellungsset für die Anwendung ersetzen. BookStack exportiert und importiert Inhalte.
Für eine hypothetische Workshop-Gruppe ist das anfängliche Ziel bescheiden: Ein weiterer autorisierter Maintainer kann das Betriebshandbuch lesen und einen repräsentativen Abschnitt einschließlich seiner Diagramme in eine separate Testinstanz importieren.
2. Halten Sie das Format und die Lücken fest.
Erstellen Sie eine Matrix, die beschreibt, was Sie bewahren müssen und wie Sie es nachweisen werden. Setzen Sie „vollständig“ erst dann in eine Zelle, wenn Sie das Ziel überprüft haben.
| Material | Mögliche Ausgabe | Zu klärende Frage |
|---|---|---|
| Wiki-Seiten | Lesbares HTML plus unterstütztes Importpaket | Bleiben Überschriften, Links und Diagramme erhalten? |
| Anhänge | Originaldateien und ein Manifest | Kann jede wichtige Referenz ihre Datei finden? |
| Kalender | Unterstützte Kalender-Austauschdatei | Verhalten sich Wiederholung und Zeitzone wie erwartet? |
| Mitgliedschaft und Berechtigungen | Notizen zur kontrollierten Rollenzuordnung | Welche Zugriffsregeln müssen manuell neu erstellt werden? |
| Anwendungswiederherstellung | Versionsspezifisches Backup-Set | Welche Konfiguration und Datenbank sind noch erforderlich? |
BookStack dokumentiert ein portables ZIP-Format mit Inhaltsdaten, Anhängen und Bildern, das erneut in BookStack importiert werden kann. Das belegt keine Kompatibilität mit einem anderen Wiki oder die Bewahrung jeder Einstellung auf Dienstebene. BookStack-Exportformate.
3. Geben Sie dem Paket einen menschlichen Ausgangspunkt.
Fügen Sie eine kurze Readme mit Quellanwendung und Version, Exportdatum und Zeitzone, ausgewähltem Umfang, Rolle des Exporteurs, Dateiliste und erwartetem Ziel hinzu. Verwenden Sie beschreibende Ordnernamen wie readable-content, attachments und import-package. Bewahren Sie Anmeldedaten anderswo auf; schreiben Sie nur das genehmigte Abrufverfahren für autorisierte Maintainer auf.
Das hypothetische Handbuch enthält eine Eröffnungscheckliste, eine Seite zur Maschinenpflege, ein Diagramm und eine verlinkte Tabelle. Sein Manifest erfasst diese vier Elemente, ihre relativen Pfade und die Beziehung zwischen der Seite und ihrem Anhang. Erfassen Sie außerdem eine eingeschränkte Seite als absichtlich ausgeschlossen, damit ein Fehlen später nicht fälschlich für versehentlichen Verlust gehalten wird.
Eine Prüfsumme kann helfen, eine unveränderte Datei während der Übertragung zu erkennen. Sie beweist nicht, dass der Export vollständig, korrekt berechtigt oder lesbar war.
4. Prüfen Sie eine repräsentative Stichprobe.
Öffnen Sie die lesbare Kopie, ohne sich auf eine aktive Sitzung in der ursprünglichen Anwendung zu verlassen. Folgen Sie einem Link, prüfen Sie ein eingebettetes Bild und öffnen Sie den verlinkten Anhang. Achten Sie auf Referenzen, die noch zum Quelldienst zurückführen. Notieren Sie, welche Links absichtlich extern sind und welche nach einem Umzug brechen würden.
Wählen Sie für Kalender ein Beispiel, das ein wiederkehrendes Ereignis, eine Ausnahme und ein Ereignis mit relevanter Zeitzone enthält. Nextcloud dokumentiert Kalenderexport und iCalendar-kompatiblen .ics Import. Das belegt einen unterstützten Austauschweg, nicht den Beweis, dass Ihr Ziel jedes gewählte Merkmal bewahrt. Nextcloud Kalender Import und Export.
Prüfen Sie die Dokumentation für Ihre installierte Version, bevor Sie Oberflächenbeschriftungen folgen; das verlinkte fortlaufende Handbuch kann eine andere Version beschreiben.
5. Importieren Sie in ein separates, kontrolliertes Ziel.
Verwenden Sie ein leeres Testziel oder eine ausdrücklich genehmigte Testsammlung. Lassen Sie den Arbeitsdienst und seine Originaldaten unberührt. Deaktivieren Sie ausgehende Benachrichtigungen und begrenzen Sie externe Verbindungen, bevor Sie die importierte Anwendung starten; der Zweck ist, die Daten zu bewerten, nicht historische Ereignisse erneut an Mitglieder zu senden.
Lassen Sie den zweiten Maintainer die Readme befolgen, ohne sich auf undokumentierte Anweisungen des Exporteurs zu verlassen. Vergleichen Sie die erwarteten Elemente mit dem importierten Ergebnis. Überprüfen Sie das Diagramm, den Tabellenlink, die Seitenstruktur und die beabsichtigten Mitgliederberechtigungen. Erfassen Sie jede Rollenzuordnung, die manuelle Arbeit erfordert. Wenn einem Format ein benötigtes Merkmal fehlt, entscheiden Sie, ob Sie es rekonstruieren, eine andere Exportmethode wählen oder ein lesbares Archiv neben dem neuen Dienst behalten.
6. Machen Sie Fehler informativ.
Wenn Dateien fehlen, vergleichen Sie Exportumfang und Exporteur-Berechtigungen, bevor Sie wiederholt größere Archive erstellen. Wenn Links brechen, stellen Sie fest, ob sie auf den alten Dienst oder auf eine im Paket fehlende Datei verweisen. Wenn der Import unerwartete Duplikate erzeugt, stoppen Sie und prüfen Sie seine Zuordnungsregeln, bevor Sie dasselbe Paket erneut importieren.
Für das Workshop-Beispiel bedeutet Abnahme, dass der zweite Maintainer die ausgewählten Seiten lesen und bearbeiten, jede enthaltene Datei abrufen und nachweisen kann, dass ein normales Mitglied nicht auf das ausgeschlossene Material zugreifen kann. Erfassen Sie jedes Ergebnis und seinen Prüfer. „Der Import ist abgeschlossen“ ist nur eine Beobachtung. Halten Sie ungelöste Unterschiede neben dem Paket fest, damit die Gruppe eine bewusste Entscheidung darüber treffen kann.
7. Halten Sie Exporte und Wiederherstellung in getrennten Spuren.
Bewahren Sie ein akzeptiertes Paket an einem kontrollierten Ort unabhängig vom Quelldienst auf und vereinbaren Sie, wann es aktualisiert wird. Prüfen Sie erneut nach Änderungen an wichtigen Formaten, Berechtigungen oder Anwendungsversionen. Exportdateien können private Inhalte enthalten, selbst wenn das Ziel nur temporär ist, weisen Sie ihnen daher ebenfalls Zugriff und eine Aufbewahrungsentscheidung zu.
Bewahren Sie das Anwendungs-Wiederherstellungsset separat auf: Die Wiederherstellungsdokumentation von BookStack erfordert beispielsweise Datenbank- und Dateimaterial über einen lesbaren Dokumentexport hinaus. BookStack-Anforderungen für Backup und Wiederherstellung.
Fahren Sie mit dem Wiederherstellungsübung für die Dienstwiederherstellung, dem Speicher-Arbeitsblatt für den Export-Arbeitsbereich und dem Dienstverzeichnis für Abhängigkeiten fort. Portabilität ist etwas, das Sie mit Ihrem Paket nachweisen, nicht aus einer Dateiendung annehmen sollten.
Dokumentation zu dieser Notiz
Verwenden Sie die Dokumentation für die Version, die Sie tatsächlich ausführen. Diese Beispiele sind Planungsmaterial, kein Nachweis eines Tests auf einem Hoszen VPS.