Die Beispiele in diesem Dokument gelten nur für eine AEM Forms on JEE-Umgebung.
Mit dem Sicherungs- und Wiederherstellungs-Service können Sie AEM Forms in den Sicherungsmodus versetzen, wodurch Hot-Backups durchgeführt werden können. Der Sicherungs- und Wiederherstellungs-Service führt keine Sicherung von AEM Forms durch und stellt das System auch nicht wieder her. Stattdessen versetzt er den Server in einen Zustand, der konsistente und zuverlässige Sicherungen ermöglicht, während der Server weiterhin ausgeführt wird. Sie sind für die Aktionen zum Sichern des globalen Dokumentenspeichers (GDS) und der mit dem Formularserver verbundenen Datenbank verantwortlich. Der globale Dokumentenspeicher ist ein Ordner zum Speichern von Dateien, die in einem langlebigen Prozess genutzt werden.
Der Sicherungsmodus ist ein Zustand, in den der Server versetzt wird, damit Dateien im globalen Dokumentenspeicher während eines Sicherungsverfahrens nicht bereinigt werden. Stattdessen werden Unterverzeichnisse im Ordner des globalen Dokumentenspeichers erstellt, um einen Datensatz der Dateien zu speichern, die nach Beendigung des Speichersicherungsmodus bereinigt werden sollen. Eine Datei soll Systemneustarts überdauern und kann Tage oder sogar Jahre umfassen. Diese Dateien sind ein wichtiger Bestandteil des Gesamtzustands des Formularservers und können PDF-Dateien, Richtlinien oder Formularvorlagen enthalten. Wenn eine dieser Dateien verloren geht oder beschädigt wird, können die Prozesse auf dem Formularserver instabil werden und Daten gehen verloren.
Sie können Snapshot-Sicherungen durchführen, bei denen Sie in der Regel über einen bestimmten Zeitraum in den Sicherungsmodus wechseln und diesen beenden, nachdem Sie die Sicherungsaktivitäten abgeschlossen haben. Der Sicherungsmodus muss deaktiviert werden, damit Dateien aus dem globalen Dokumentenspeicher gelöscht werden können, sodass dieser nicht unnötig groß wird. Sie können den Sicherungsmodus entweder explizit beenden oder auf den Ablauf einer Sicherungsmodussitzung warten.
Sie können Ihren Server auch im permanenten Sicherungsmodus belassen, was typisch für Sicherungsstrategien für kontinuierliche Sicherungen oder eine kontinuierliche Systemabdeckung ist. Der kontinuierliche Sicherungsmodus gibt an, dass das System stets im Sicherungsmodus ist, wobei eine neue Sicherungsmodussitzung ausgelöst wird, sobald die vorherige Sitzung freigegeben wurde. Im permanenten Sicherungsmodus wird eine Datei nach zwei Sicherungsmodussitzungen bereinigt und nicht mehr referenziert.
Sie können den Sicherungs- und Wiederherstellungs-Service verwenden, um bestehende oder neue Anwendungen hinzuzufügen, die Sie erstellen, um Sicherungen des GDS oder der mit dem Formularserver verbundenen Datenbank durchzuführen.
Wie auch bei allen anderen Aspekten einer AEM Forms-Implementierung gilt, dass die Sicherungs- und Wiederherstellungsstrategie in einer Entwicklungs- oder Testumgebung entwickelt und getestet werden muss, bevor sie in der Produktion zum Einsatz kommt. So wird sichergestellt, dass die gesamte Lösung wie erwartet und ohne Datenverlust funktioniert.
Sie können folgende Aufgaben mit dem Sicherungs- und Wiederherstellungs-Service ausführen:
Weitere Informationen dazu, was bei der Durchführung von Sicherungen für AEM Forms zu beachten ist, finden Sie unter Hilfe zur Administration.
Weitere Informationen zum Sicherungs- und Wiederherstellungs-Service finden Sie in der Services-Referenz für AEM Forms.
Sie aktivieren den Sicherungsmodus, um Hot-Backups eines Formularservers zu ermöglichen. Wenn Sie den Sicherungsmodus aktivieren, geben Sie die folgenden Informationen basierend auf den Sicherungsverfahren Ihres Unternehmens an:
Bevor Sie Anwendungen zum Aktivieren des Sicherungsmodus schreiben, sollten Sie die Sicherungsverfahren verstehen, die verwendet werden, nachdem der Formularserver in den Sicherungsmodus versetzt wurde. Weitere Informationen dazu, was bei der Durchführung von Sicherungen für AEM Forms zu beachten ist, finden Sie in der Hilfe zur Administration.
Weitere Informationen über den Service „Backup und Wiederherstellung“ finden Sie unter Service-Referenz für AEM Forms.
So erstellen Sie eine Anwendung, die den Sicherungsmodus aktiviert:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Diese Dateien müssen in Ihr Projekt aufgenommen werden, damit Sie Ihren Code ordnungsgemäß kompilieren und die Backup- und Wiederherstellungs-Service-API verwenden können.
Weitere Informationen über den Speicherort dieser Dateien finden Sie unter Einbeziehung von AEM Forms Java-Bibliotheksdateien.
Erstellen eines BackupService Client-API-Objekts
Um den Backup-Modus programmgesteuert zu deaktivieren, erstellen Sie ein BackupService-Client-Objekt, das die Backup- und Wiederherstellungs-Service-API verwendet.
Legen Sie eine eindeutige Beschriftung fest, bestimmen Sie die Zeitdauer für die Durchführung des Backups und entscheiden Sie, ob der kontinuierliche Backup-Modus ausgeführt werden soll.
Bevor Sie in den Backup-Modus wechseln, sollten Sie sich für eine eindeutige Beschriftung entscheiden, die Zeitdauer festlegen, die Sie für die Durchführung des Backups zuweisen möchten, und entscheiden, ob der Formular-Server im Backup-Modus verbleiben soll. Diese wichtigen Überlegungen sollten unbedingt in die von Ihrem Unternehmen eingerichteten Backup-Verfahren integriert werden. (Siehe Administration-Hilfe.)
Backup-Modus aktivieren
Wechseln Sie in den Backup-Modus mit den Parametern, die den Backup-Verfahren in Ihrem Unternehmen entsprechen.
Abrufen von Informationen zur Backup-Modus-Sitzung auf dem Server
Nachdem Sie den Backup-Modus gestartet haben, können Sie Informationen zur Sitzung abrufen. Diese Informationen können zur Integration in Ihre Backup-Verfahren verwendet werden.
Durchführen des Backups des globalen Dokumentenspeichers (GDS) und der Datenbank
Nachdem Sie den Backup-Modus erfolgreich aktiviert haben, können Sie ein Backup des globalen Dokumentenspeichers (GDS) und der Datenbank, mit der der Formular-Server verbunden ist, durchführen. Dieser Schritt ist für Ihr Unternehmen spezifisch, da Sie diesen Schritt manuell ausführen können oder andere Werkzeuge zum Ausführen des Backup-Verfahrens nutzen können.
So wechseln Sie mithilfe der Backup- und Wiederherstellungs-Service-API in den Backup-Modus:
Projektdateien einschließen
Fügen Sie benötigte Client-JAR-Dateien wie „adobe-backup-restore-client.jar“ in den Klassenpfad des Java-Projekts ein. Um das Java-Client-Programm zu erstellen, müssen die folgenden JAR-Dateien zum Klassenpfad Ihres Projekts hinzugefügt werden:
Erstellen eines BackupService-Client-API-Objekts
Sie verwenden ein ServiceClientFactory
-Objekt und das BackupService-Client-API-Objekt zusammen.
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. (Siehe Einstellung von Verbindungseigenschaften.)BackupService
-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Festlegen einer eindeutigen Beschriftung, Bestimmen der Zeitdauer für die Durchführung des Backups und Entscheidung, ob der kontinuierliche Backup-Modus ausgeführt werden soll
Legen Sie eine eindeutige Beschriftung fest, bestimmen Sie die Zeitdauer, die Sie für das Backup zuweisen möchten, und entscheiden Sie, ob der Formular-Server im kontinuierlichen Backup-Modus verbleiben soll.
Aktivieren des Sicherungsmodus
Sp wechseln Sie in den Backup-Modus, indem Sie die enterBackupMode
-Methode mit den folgenden Parametern aufrufen:
Einen String
-Wert, der eine eindeutige, für Menschen lesbare Bezeichnung angibt, die die Backup-Modus-Sitzung benennt. Es wird empfohlen, keine Leerzeichen oder Zeichen zu verwenden, die nicht im XML-Format kodiert werden können.
Einen int
-Wert, der die Anzahl der Minuten angibt, die im Backup-Modus verblieben werden soll. Sie können einen Wert zwischen 1
und 10080
angeben (Anzahl der Minuten in einer Woche). Dieser Wert wird bei Verwendung des kontinuierlichen Backup-Modus ignoriert.
Einen Boolean
-Wert, der angibt, ob der kontinuierliche Backup-Modus ausgeführt werden soll. Der Wert True
gibt an, dass der kontinuierliche Backup-Modus ausgeführt werden soll. Im kontinuierlichen Backup-Modus wird der Wert ignoriert, den Sie für die Anzahl der Minuten angeben, die im Backup-Modus verblieben werden soll.
Der kontinuierliche Backup-Modus bedeutet, dass eine neue Backup-Modus-Sitzung gestartet wird, nachdem die aktuelle Sitzung abgeschlossen ist. Der Wert False
bedeutet, dass der kontinuierliche Backup-Modus nicht verwendet wird und die Bereinigung der Dateien aus dem globalen Dokumentenspeicher (GDS) nach dem Verlassen des Backup-Modus fortgesetzt wird.
Abrufen von Informationen zur Sicherungsmodussitzung auf dem Server
Rufen Sie Informationen mithilfe des BackupModeEntryResult
-Objekts ab, das nach dem Aufrufen der enterBackupMode
-Methode zurückgegeben wird. Die Informationen, die Sie nach der Aktivierung des Sicherungsmodus abrufen können, können für die Integration in Ihre Sicherungsverfahren nützlich sein. Beispielsweise können Beschriftung, Backup-ID und Startzeit als Eingabe für Dateinamen für Ihr Sicherungsverfahren nützlich sein.
Durchführen des Backups des globalen Dokumentenspeichers und der Datenbank
Erstellen Sie ein Backup vom globalen Dokumentenspeicher (GDS) und von der Datenbank, mit der Ihr Formular-Server verbunden ist. Die Aktionen zum Ausführen des Backups sind nicht Teil des AEM Forms-SDK und können sogar manuelle Schritte für die Backup-Verfahren in Ihrem Unternehmen enthalten.
So wechseln Sie mithilfe des von der Backup- und Wiederherstellungs-Service-API bereitgestellten Web-Services in den Backup-Modus:
Projektdateien einschließen
Erstellen eines BackupService-Client-API-Objekts
Erstellen Sie mithilfe der Microsoft .NET-Client-Assembly ein BackupServiceService
-Objekt durch Aufrufen des Standardkonstruktors und geben Sie die Anmeldeinformationen mithilfe der Credentials
-Methode an.
Festlegen einer eindeutigen Beschriftung, Bestimmen der Zeitdauer für die Durchführung des Backups und Entscheidung, ob der kontinuierliche Backup-Modus ausgeführt werden soll
Legen Sie eine eindeutige Beschriftung fest, bestimmen Sie die Zeitdauer, die Sie für das Backup zuweisen möchten, und entscheiden Sie, ob der Formular-Server im kontinuierlichen Backup-Modus verbleiben soll.
Aktivieren des Sicherungsmodus
Um in den Backup-Modus zu wechseln, rufen Sie die Methode enterBackupMode auf und übergeben Sie die folgenden Werte:
Einen String
-Wert, der eine eindeutige, für Menschen lesbare Bezeichnung angibt, die die Backup-Modus-Sitzung benennt. Es wird empfohlen, keine Leerzeichen oder Zeichen zu verwenden, die nicht im XML-Format kodiert werden können.
Einen Uint32
-Wert, der die Anzahl der Minuten angibt, die im Backup-Modus verblieben werden soll. Sie können einen Wert zwischen 1
und 10080
festlegen (Anzahl der Minuten in einer Woche). Dieser Wert wird bei Verwendung des kontinuierlichen Backup-Modus ignoriert.
Einen Boolean
-Wert, der angibt, ob der kontinuierliche Backup-Modus ausgeführt werden soll. Der Wert True
gibt an, dass der kontinuierliche Backup-Modus ausgeführt werden soll. Im kontinuierlichen Backup-Modus wird der Wert, den Sie für die Anzahl der Minuten angeben, die im Backup-Modus verbieben werden soll, ignoriert. Der kontinuierliche Backup-Modus bedeutet, dass eine neue Backup-Modus-Sitzung gestartet wird, nachdem die aktuelle Sitzung abgeschlossen ist.
Der Wert False
bedeutet, dass der kontinuierliche Backup-Moduss nicht verwendet wird und die Bereinigung der Dateien aus dem globalen Dokumentenspeicher nach dem Verlassen des Backup-Modus fortgesetzt wird.
Abrufen von Informationen zur Sicherungsmodussitzung auf dem Server
Rufen Sie Informationen zur Backup-Modus-Sitzung ab, nachdem Sie die Methode enterBackupMode aus dem zurückgegebenen BackupModeEntryResult aufgerufen haben, um zu überprüfen, ob es erfolgreich war. Die Informationen, die Sie nach der Aktivierung des Sicherungsmodus abrufen können, können für die Integration in Ihre Sicherungsverfahren nützlich sein. Beispielsweise können Beschriftung, Backup-ID und Startzeit als Eingabe für Dateinamen für Ihr Sicherungsverfahren nützlich sein.
Durchführen des Backups des globalen Dokumentenspeichers und der Datenbank
Erstellen Sie ein Backup vom globalen Dokumentenspeicher (GDS) und von der Datenbank, mit der Ihr Formular-Server verbunden ist. Die Aktionen zum Ausführen des Backups sind nicht Teil des AEM Forms-SDK und können sogar manuelle Schritte für die Backup-Verfahren in Ihrem Unternehmen enthalten.
Sie verlassen den Backup-Modus, damit der Formular-Server die Bereinigung der Dateien aus dem globalen Dokumentenspeicher (GDS) auf dem Formular-Server fortsetzt.
Bevor Sie Programme schreiben, um in den Modus „Verlassen“ zu wechseln, sollten Sie die Backup-Verfahren verstehen, die mit AEM Forms verwendet werden. Weitere Informationen dazu, was bei der Durchführung von Backups für AEM Forms zu beachten ist, finden Sie unter Administration-Hilfe.
Weitere Informationen über den Service „Backup und Wiederherstellung“ finden Sie unter Service-Referenz für AEM Forms.
Führen Sie die folgenden Schritte aus, um den Backup-Modus zu verlassen:
Projektdateien einschließen
Schließen Sie alle erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Diese Dateien sind wichtig, um Ihren Code ordnungsgemäß zu kompilieren und die Backup- und Wiederherstellungs-Service-API verwenden zu können.
Weitere Informationen über den Speicherort dieser Dateien finden Sie unter Einbeziehung von AEM Forms Java-Bibliotheksdateien.
Erstellen eines BackupService Client-API-Objekts
Um den Backup-Modus programmgesteuert zu deaktivieren, erstellen Sie ein BackupService-Client-Objekt, das die Backup- und Wiederherstellungs-Service-API verwendet.
Sicherungsmodus beenden
Beenden Sie den Sicherungsmodus, um die normale Bereinigung der Dateien aus dem globalen Dokumentenspeicher (GDS) fortzusetzen. Bevor Sie den Sicherungsmodus beenden, sollten Sie sicherstellen, dass die Sicherungsverfahren abgeschlossen sind.
Abrufen von Informationen zur beendeten Sicherungsmodussitzung
Nachdem Sie den Sicherungsmodus beendet haben, können Sie Informationen zur Sitzung abrufen. Diese Informationen können zur Integration in Sicherungsverfahren verwendet werden.
Deaktivieren Sie den Sicherungsmodus mithilfe der Sicherungs- und Wiederherstellungs-Service-API (Java):
Projektdateien einschließen
Fügen Sie benötigte Client-JAR-Dateien wie „adobe-backup-restore-client.jar“ in den Klassenpfad des Java-Projekts ein. Zum Erstellen der Java-Client-Anwendung müssen die folgenden JAR-Dateien zum Klassenpfad des Projekts hinzugefügt werden:
Erstellen eines BackupService-Client-API-Objekts
Sie verwenden ein ServiceClientFactory
-Objekt und das BackupService-Client-API-Objekt zusammen.
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. (Siehe Einstellung von Verbindungseigenschaften.)BackupService
-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Aktivieren des Sicherungsmodus
Deaktivieren Sie den Sicherungsmodus durch Aufrufen der leaveBackupMode
-Methode.
Abrufen von Informationen zur Sicherungsmodussitzung auf dem Server
Rufen Sie unter Verwendung des BackupModeResult
-Objekts, das zurückgegeben wird, Informationen zum Vorgang ab. Die Informationen, die Sie nach der Aktivierung des Sicherungsmodus abrufen können, können für die Integration in Ihre Sicherungsverfahren nützlich sein. Beispielsweise können Beschriftung, Backup-ID und Startzeit als Eingabe für Dateinamen für Ihr Sicherungsverfahren nützlich sein.
Beenden Sie den Sicherungsmodus mithilfe der Sicherungs- und Wiederherstellungs-Service-API (Web-Service):
Projektdateien einschließen
Um Web-Services zu verwenden, müssen Sie sicherstellen, dass Sie die Proxy-Dateien einbinden. Führen Sie diese Schritte aus, um das Projekt für die Verwendung der Sicherungs- und Wiederherstellungs-Service-API als Web-Service zu konfigurieren.
Erstellen eines BackupService-Client-API-Objekts
Erstellen Sie mithilfe der Microsoft .NET-Client-Assembly ein BackupServiceService
-Objekt, indem Sie den Standardkonstruktor aufrufen.
Aktivieren des Sicherungsmodus
Beenden Sie den Sicherungsmodus, indem Sie den Web-Service-Vorgang leaveBackupMode
aufrufen.
Abrufen von Informationen zur Sicherungsmodussitzung auf dem Server
Rufen Sie die Sicherungsmoduskennung nach dem Vorgang ab, um sich zu vergewissern, dass er erfolgreich war. Die Informationen, die Sie nach dem Beenden des Sicherungsmodus abrufen können, können für die Integration in Ihre Sicherungsverfahren nützlich sein.