Accesso alla modalità di backup sul server Forms
È possibile attivare la modalità di backup per consentire backup a caldo di un server Forms. Quando si entra in modalità di backup, è possibile specificare le seguenti informazioni in base alle procedure di backup dell'organizzazione:
- Etichetta univoca per identificare la sessione in modalità di backup che può essere utile per i processi di backup.
- Tempo necessario per il completamento della procedura di backup.
- Un flag per indicare se deve essere in modalità di backup continuo, utile solo se si eseguono backup continui.
Prima di scrivere applicazioni per l'immissione in modalità di backup, è consigliabile comprendere le procedure di backup utilizzate dopo aver impostato Forms Server in modalità di backup. Per ulteriori informazioni su cosa prendere in considerazione durante l'esecuzione dei backup per AEM Forms, vedere guida per l'amministrazione.
Riepilogo dei passaggi
Per creare un'applicazione che entra in modalità di backup, effettuare le seguenti operazioni:
- Includi file di progetto.
- Creare un oggetto client BackupService.
- Determinare un'etichetta univoca, la quantità di tempo per l'esecuzione del backup e l'eventuale modalità di backup continuo.
- Accedi alla modalità di backup.
- (Facoltativo) Recupera informazioni sulla sessione in modalità di backup sul server.
- Eseguire il backup del GDS (Global Data Store) e del database.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Questi file sono importanti da includere nel progetto per compilare correttamente il codice e utilizzare l’API del servizio Backup e ripristino.
Per informazioni sul percorso di questi file, vedere Inclusi i file della libreria Java di AEM Forms.
Creare un oggetto API client BackupService
Per uscire dalla modalità di backup a livello di programmazione, è necessario creare un oggetto client BackupService per utilizzare l'API del servizio Backup e ripristino.
Scegliere un'etichetta univoca, determinare il tempo necessario per eseguire il backup e decidere se attivare la modalità di backup continuo
Prima di attivare la modalità di backup, è necessario scegliere un'etichetta univoca, determinare il tempo da allocare per eseguire il backup e decidere se si desidera che Forms Server rimanga in modalità di backup. Queste considerazioni sono importanti per l'integrazione con le procedure di backup stabilite dall'organizzazione. (Vedi guida per l'amministrazione.)
Accedi alla modalità di backup
Attiva la modalità di backup con i parametri coerenti con le procedure di backup dell’organizzazione.
Recupera informazioni sulla sessione in modalità di backup nel server
Dopo aver attivato la modalità di backup, è possibile recuperare informazioni sulla sessione. Queste informazioni possono essere utilizzate per l'integrazione con le procedure di backup
Eseguire il backup di GDS e database
Dopo aver immesso la modalità di backup, è possibile eseguire un backup di GDS (Global Document Storage) e del database a cui è connesso Forms Server. Questo passaggio è specifico per la tua organizzazione, in quanto puoi eseguirlo manualmente oppure puoi eseguire altri strumenti per eseguire la procedura di backup.
Entra in modalità di backup utilizzando l’API Java
Attiva la modalità di backup utilizzando l’API del servizio Backup e ripristino:
-
Includi file di progetto
Includi i file JAR client necessari, ad esempio adobe-backup-restore-client-sdk.jar, nel percorso di classe del progetto Java. Per creare l’applicazione client Java, è necessario aggiungere i seguenti file JAR al percorso di classe del progetto:
- adobe-backup-restore-client-sdk.jar
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-utilities.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)
- jbossall-client.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)
-
Creare un oggetto API client BackupService
Si utilizza un oggetto
ServiceClientFactory
e l'oggetto API del client BackupService insieme.- Creare un oggetto
ServiceClientFactory
contenente le proprietà di connessione. (Vedere Impostazione delle proprietà di connessione.) - Creare un oggetto
BackupService
utilizzando il relativo costruttore e passando l'oggettoServiceClientFactory
.
- Creare un oggetto
-
Decidere su un'etichetta univoca, determinare il tempo necessario per eseguire il backup e decidere se attivare la modalità di backup continuo
Decidere su un'etichetta univoca, determinare la quantità di tempo che si desidera allocare per eseguire il backup e decidere se si desidera che Forms Server rimanga in modalità di backup continuo.
-
Accedi alla modalità di backup
Immettere la modalità di backup richiamando il metodo
enterBackupMode
con i seguenti parametri:-
Valore
String
che specifica un'etichetta univoca leggibile che identifica la sessione in modalità di backup. Si consiglia di non utilizzare spazi o caratteri che non possono essere codificati in formato XML. -
Valore
int
che specifica il numero di minuti per cui mantenere la modalità di backup. È possibile specificare un valore compreso tra1
e10080
(il numero di minuti in una settimana). Questo valore viene ignorato quando si utilizza la modalità di backup continuo. -
Valore
Boolean
che specifica se essere in modalità di backup continuo. Un valore diTrue
specifica di essere in modalità di backup continuo. In modalità di backup continuo, il valore specificato per il numero di minuti da mantenere in modalità di backup viene ignorato.La modalità di backup continuo indica che una nuova sessione in modalità di backup viene avviata dopo il completamento di quella corrente. Il valore
False
indica che non viene utilizzata la modalità di backup continuo e che, dopo aver lasciato la modalità di backup, viene ripresa la rimozione dei file dal GDS.
-
-
Recuperare informazioni sulla sessione in modalità di backup sul server
Recuperare le informazioni utilizzando l'oggetto
BackupModeEntryResult
restituito dopo aver richiamato il metodoenterBackupMode
. Le informazioni che è possibile recuperare dopo aver attivato la modalità di backup possono essere utili per l'integrazione con le procedure di backup. Ad esempio, l'etichetta, l'ID di backup e l'ora di inizio possono essere utili come input per i nomi di file per la procedura di backup. -
Eseguire il backup di GDS e database
Eseguire il backup di GDS (Global Document Storage) e del database a cui è connesso Forms Server. Le azioni per eseguire il backup non fanno parte dell’SDK di AEM Forms e possono anche includere passaggi manuali specifici per le procedure di backup dell’organizzazione.
Entra in modalità di backup utilizzando l’API del servizio web
Attiva la modalità di backup utilizzando il servizio Web fornito dall'API del servizio Backup e ripristino:
-
Includi file di progetto
- Creare un assembly client Microsoft .NET che utilizza l'API WSDL del servizio di backup e ripristino.
- Fare riferimento all'assembly client Microsoft .NET.
-
Creare un oggetto API client BackupService
Utilizzando l'assembly client Microsoft .NET, creare un oggetto
BackupServiceService
richiamando il relativo costruttore predefinito e specificare le credenziali utilizzando il metodoCredentials
. -
Decidere su un'etichetta univoca, determinare il tempo necessario per eseguire il backup e decidere se attivare la modalità di backup continuo
Decidere su un'etichetta univoca, determinare la quantità di tempo che si desidera allocare per eseguire il backup e decidere se si desidera che Forms Server rimanga in modalità di backup continuo.
-
Accedi alla modalità di backup
Per attivare la modalità di backup, richiamare il metodo enterBackupMode e passare i valori seguenti:
-
Valore
String
che specifica un'etichetta univoca leggibile che identifica la sessione in modalità di backup. Si consiglia di non utilizzare spazi o caratteri che non possono essere codificati in formato XML. -
Valore
Uint32
che specifica il numero di minuti per cui mantenere la modalità di backup. È possibile specificare un valore compreso tra1
e10080
(numero di minuti in una settimana). Questo valore viene ignorato quando si utilizza la modalità di backup continuo. -
Valore
Boolean
che specifica se essere in modalità di backup continuo. Un valore diTrue
specifica di essere in modalità di backup continuo. In modalità di backup continuo, il valore specificato per il numero di minuti da mantenere in modalità di backup viene ignorato. La modalità di backup continuo indica che una nuova sessione in modalità di backup viene avviata dopo il completamento di quella corrente.Il valore
False
indica che non viene utilizzata la modalità di backup continuo e che, dopo aver lasciato la modalità di backup, viene ripresa la rimozione dei file dal GDS.
-
-
Recuperare informazioni sulla sessione in modalità di backup sul server
Recuperare le informazioni sulla sessione in modalità di backup dopo aver richiamato il metodo enterBackupMode da BackupModeEntryResult restituito per verificare che sia stato eseguito correttamente. Le informazioni che è possibile recuperare dopo aver attivato la modalità di backup possono essere utili per l'integrazione con le procedure di backup. Ad esempio, l'etichetta, l'ID di backup e l'ora di inizio possono essere utili come input per i nomi di file per la procedura di backup.
-
Eseguire il backup di GDS e database
Eseguire il backup di GDS (Global Document Storage) e del database a cui è connesso Forms Server. Le azioni per eseguire il backup non fanno parte dell’SDK di AEM Forms e possono anche includere passaggi manuali specifici per le procedure di backup dell’organizzazione.
Uscita dalla modalità di backup sul server Forms
Uscire dalla modalità di backup in modo che Forms Server riprenda la rimozione dei file da GDS (Global Document Storage) sul server Forms.
Prima di scrivere le applicazioni per passare alla modalità di congedo, è consigliabile comprendere le procedure di backup utilizzate con AEM Forms. Per ulteriori informazioni su cosa prendere in considerazione durante l'esecuzione dei backup per AEM Forms, vedere guida per l'amministrazione.
Riepilogo dei passaggi
Per uscire dalla modalità di backup, effettuare le seguenti operazioni:
- Includi file di progetto.
- Creare un oggetto client BackupService.
- Lascia la modalità di backup.
- (Facoltativo) Recuperare informazioni sulla sessione in modalità di backup in esecuzione sul server Forms.
Includi file di progetto
Includi tutti i file necessari nel progetto di sviluppo. Questi file sono importanti per la corretta compilazione del codice e per l'utilizzo dell'API del servizio Backup e ripristino.
Per informazioni sul percorso di questi file, vedere Inclusi i file della libreria Java di AEM Forms.
Creare un oggetto API client BackupService
Per uscire dalla modalità di backup a livello di programmazione, è necessario creare un oggetto client BackupService per utilizzare l'API del servizio Backup e ripristino.
Esci dalla modalità di backup
Lasciare la modalità di backup per riprendere la normale eliminazione dei file da Global Document Storage (GDS). Prima di uscire dalla modalità di backup, è necessario verificare che le procedure di backup siano state completate.
Recupera informazioni sulla sessione della modalità di backup terminata
Dopo aver lasciato la modalità di backup, è possibile recuperare informazioni sulla sessione. Queste informazioni possono essere utilizzate per l'integrazione con le procedure di backup.
Lascia la modalità di backup utilizzando l’API Java
Uscire dalla modalità di backup utilizzando l’API del servizio Backup e ripristino (Java):
-
Includi file di progetto
Includi i file JAR client necessari, ad esempio adobe-backup-restore-client-sdk.jar, nel percorso di classe del progetto Java. Per creare un’applicazione client Java, è necessario aggiungere i seguenti file JAR al percorso di classe del progetto:
- adobe-backup-restore-client-sdk.jar
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-utilities.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)
- jbossall-client.jar (richiesto se AEM Forms è distribuito sul server applicazioni JBoss)
-
Creare un oggetto API client BackupService
Si utilizza un oggetto
ServiceClientFactory
e l'oggetto API del client BackupService insieme.- Creare un oggetto
ServiceClientFactory
contenente le proprietà di connessione. (Vedere Impostazione delle proprietà di connessione.) - Creare un oggetto
BackupService
utilizzando il relativo costruttore e passando l'oggettoServiceClientFactory
come parametro.
- Creare un oggetto
-
Accedi alla modalità di backup
Uscire dalla modalità di backup richiamando il metodo
leaveBackupMode
. -
Recuperare informazioni sulla sessione in modalità di backup sul server
Recuperare le informazioni sull'operazione utilizzando l'oggetto
BackupModeResult
restituito. Le informazioni che è possibile recuperare dopo aver attivato la modalità di backup possono essere utili per l'integrazione con le procedure di backup. Ad esempio, l'etichetta, l'ID di backup e l'ora di inizio possono essere utili come input per i nomi di file per la procedura di backup.