Preparazione di AEM Forms per il backup

Informazioni sul servizio di backup e ripristino

Il servizio Backup e ripristino consente di inserire AEM Forms in modalità di backup, che consente l'esecuzione di backup a caldo. Il servizio Backup e ripristino non esegue effettivamente un backup di AEM Forms o ripristina il sistema. Invece, mette il server in uno stato per backup coerenti e affidabili, consentendo al server di continuare l'esecuzione. L’utente è responsabile delle azioni di backup del GDS (Global Document Storage) e del database connessi al server dei moduli. Il GDS è una directory utilizzata per memorizzare i file utilizzati in un processo di lunga durata.

La modalità di backup è uno stato immesso dal server in modo che i file nel GDS non vengano eliminati durante una procedura di backup. Al contrario, le sottodirectory vengono create nella directory GDS per mantenere un record di file da eliminare dopo la fine della modalità di backup del salvataggio. Un file ha lo scopo di sopravvivere al riavvio del sistema e può durare giorni, o anche anni. Questi file rappresentano una parte critica dello stato generale del server dei moduli e possono includere file, criteri o modelli di moduli di PDF. Se uno di questi file viene perso o danneggiato, i processi sul server dei moduli potrebbero diventare instabili e i dati potrebbero andare persi.

È possibile scegliere di eseguire i backup delle copie istantanee, in cui di solito si entra in modalità di backup per un periodo e poi lasciare la modalità di backup dopo aver completato le attività di backup. È necessario lasciare la modalità di backup in modo che i file possano essere eliminati dal GDS per garantire che non crescano inutilmente grandi. È possibile uscire dalla modalità di backup esplicitamente o attendere la scadenza del tempo per una sessione in modalità di backup.

È inoltre possibile lasciare il server in modalità di backup perpetuo, tipica delle strategie di backup per il backup continuo o la copertura continua del sistema. La modalità di backup continuo indica che il sistema è sempre in modalità di backup, con una nuova sessione in modalità di backup avviata non appena viene rilasciata la sessione precedente. In modalità di backup continuo, un file viene eliminato dopo due sessioni in modalità di backup e non viene più fatto riferimento.

È possibile utilizzare il servizio Backup e ripristino per aggiungere alle applicazioni esistenti o alle nuove applicazioni create per eseguire backup del GDS o del database connesso al server dei moduli.

È possibile eseguire queste operazioni utilizzando il servizio Backup e ripristino:

• Accedere alla modalità di backup.
• Lascia la modalità di backup.

Accesso alla modalità di backup nel server dei moduli

È possibile accedere alla modalità di backup per consentire il backup a caldo di un server dei moduli. Quando si accede alla modalità di backup, è possibile specificare le seguenti informazioni in base alle procedure di backup dell'organizzazione:

• Etichetta univoca per identificare la sessione di modalità di backup che può essere utile per i processi di backup.
• Tempo necessario per il completamento della procedura di backup.
• Flag che indica se è attiva la modalità di backup continuo, utile solo se si eseguono backup continui.

Prima di scrivere applicazioni per accedere alla modalità di backup, è consigliabile comprendere le procedure di backup che verranno utilizzate dopo aver messo il server dei moduli in modalità di backup. Per ulteriori informazioni su cosa considerare durante l'esecuzione dei backup per AEM Forms, consulta aiuto amministrativo.

Riepilogo dei passaggi

Per creare un'applicazione che entra in modalità di backup, esegui i seguenti passaggi:

1. Includi file di progetto.
2. Creare un oggetto client BackupService.
3. Determinare un'etichetta univoca, la quantità di tempo necessario per eseguire il backup e se utilizzare la modalità di backup continuo.
4. Accedere alla modalità di backup.
5. (Facoltativo) Recupera informazioni sulla sessione della modalità di backup sul server.
6. Esegui 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 di backup e ripristino.

Per informazioni sulla posizione di questi file, vedi Inclusione dei file libreria Java di AEM Forms.

Creare un oggetto API client BackupService

Per uscire dalla modalità di backup a livello di programmazione, creare un oggetto client BackupService per utilizzare l'API del servizio Backup e ripristino.

Stabilire un'etichetta univoca, determinare il tempo necessario per eseguire il backup e decidere se utilizzare la modalità di backup continuo

Prima di passare alla modalità di backup, è necessario stabilire un'etichetta univoca, determinare il tempo da allocare per eseguire il backup e decidere se si desidera che il server dei moduli rimanga in modalità di backup. Queste considerazioni sono importanti per l'integrazione con le procedure di backup stabilite dall'organizzazione. (Vedi aiuto amministrativo.)

Modalità backup

Accedi alla modalità di backup con i parametri coerenti con le procedure di backup della tua organizzazione.

Recupera informazioni sulla sessione in modalità di backup sul 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

Esegui il backup del GDS e del database

Dopo aver attivato correttamente la modalità di backup, è possibile eseguire un backup del GDS (Global Document Storage) e del database a cui è connesso il server dei moduli. Questo passaggio è specifico dell'organizzazione, in quanto è possibile eseguire manualmente questo passaggio o eseguire altri strumenti per eseguire la procedura di backup.

Accedi alla modalità di backup utilizzando l’API Java

Immettere la modalità di backup utilizzando l'API del servizio Backup e ripristino:

1. Includi file di progetto

   Includi i file JAR client necessari, come adobe-backup-restore-client-sdk.jar, nel percorso di classe del progetto Java. Per creare l’applicazione client Java, i seguenti file JAR devono essere aggiunti 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 su JBoss Application Server)
   • jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)

2. Creare un oggetto API client BackupService

   Utilizza un ServiceClientFactory insieme all'oggetto API client BackupService.

   • Crea un ServiceClientFactory oggetto contenente le proprietà di connessione. (Vedi Impostazione delle proprietà di connessione.)
   • Crea un BackupService utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.

3. Stabilire un'etichetta univoca, determinare il tempo necessario per eseguire il backup e decidere se utilizzare la modalità di backup continuo

   Scegliere un'etichetta univoca, determinare il tempo da allocare per eseguire il backup e decidere se si desidera che il server dei moduli rimanga in modalità di backup continuo.

4. Modalità backup

   Attiva la modalità di backup richiamando il enterBackupMode con i seguenti parametri:

   • A String valore che specifica un'etichetta univoca leggibile dall'utente che identifica la sessione in modalità di backup. È consigliabile non utilizzare spazi o caratteri che non possono essere codificati in formato XML.

   • Un int valore che specifica il numero di minuti in cui rimanere in modalità di backup. Puoi specificare un valore da 1 a 10080 (il numero di minuti in una settimana). Questo valore viene ignorato quando si utilizza la modalità di backup continuo.

   • A Boolean valore che specifica se è in modalità di backup continuo. Un valore di True specifica di essere in modalità di backup continuo. In modalità di backup continuo, il valore specificato per il numero di minuti da rimanere in modalità di backup viene ignorato.

     Modalità di backup continuo significa che una nuova sessione in modalità di backup viene avviata dopo il completamento di quella corrente. Un valore di False significa che non si utilizza la modalità di backup continuo e, dopo aver lasciato la modalità di backup, riprende lo svuotamento dei file dal GDS.

5. Recupera informazioni sulla sessione in modalità di backup sul server

   Recupera le informazioni utilizzando il BackupModeEntryResult oggetto restituito dopo aver richiamato enterBackupMode metodo . Le informazioni che è possibile recuperare dopo l'accesso alla 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 dei file per la procedura di backup.

6. Esegui il backup del GDS e del database

   Eseguire il backup di GDS (Global Document Storage) e del database a cui è connesso il server dei moduli. Le azioni per eseguire il backup non fanno parte dell’SDK AEM Forms e possono includere anche passaggi manuali specifici per le procedure di backup all’interno dell’organizzazione.

Accedere alla modalità di backup utilizzando l’API del servizio Web

Accedere alla modalità di backup utilizzando il servizio Web fornito dall'API del servizio di backup e ripristino:

1. Includi file di progetto

   • Creare un assembly client Microsoft .NET che utilizzi la WSDL API del servizio di backup e ripristino.
   • Fare riferimento all'assembly client Microsoft .NET.

2. Creare un oggetto API client BackupService

   Utilizzando l'assembly client Microsoft .NET, creare un BackupServiceService richiamando il relativo costruttore predefinito e specificando le credenziali utilizzando Credentials metodo .

3. Stabilire un'etichetta univoca, determinare il tempo necessario per eseguire il backup e decidere se utilizzare la modalità di backup continuo

   Scegliere un'etichetta univoca, determinare il tempo da allocare per eseguire il backup e decidere se si desidera che il server dei moduli rimanga in modalità di backup continuo.

4. Modalità backup

   Per accedere alla modalità di backup, richiamare il metodo enterBackupMode e passare i seguenti valori:

   • A String valore che specifica un'etichetta univoca leggibile dall'utente che identifica la sessione in modalità di backup. È consigliabile non utilizzare spazi o caratteri che non possono essere codificati in formato XML.

   • A Uint32 valore che specifica il numero di minuti in cui rimanere in modalità di backup. Puoi specificare un valore da 1 a 10080 (numero di minuti in una settimana). Questo valore viene ignorato quando si utilizza la modalità di backup continuo.

   • A Boolean valore che specifica se è in modalità di backup continuo. Un valore di True specifica di essere in modalità di backup continuo. In modalità di backup continuo, il valore specificato per il numero di minuti da rimanere in modalità di backup viene ignorato. Modalità di backup continuo significa che una nuova sessione in modalità di backup viene avviata dopo il completamento di quella corrente.

     Un valore di False significa che non si utilizza la modalità di backup continuo e, dopo aver lasciato la modalità di backup, riprende lo svuotamento dei file dal GDS.

5. Recupera 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 l'accesso alla 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 dei file per la procedura di backup.

6. Esegui il backup del GDS e del database

   Eseguire il backup di GDS (Global Document Storage) e del database a cui è connesso il server dei moduli. Le azioni per eseguire il backup non fanno parte dell’SDK AEM Forms e possono includere anche passaggi manuali specifici per le procedure di backup all’interno dell’organizzazione.

Uscita dalla modalità di backup sul server dei moduli

È possibile uscire dalla modalità di backup in modo che il server dei moduli riprenda l’eliminazione dei file da GDS (Global Document Storage) sul server dei moduli.

Prima di scrivere applicazioni per entrare in modalità di uscita, è consigliabile comprendere le procedure di backup utilizzate con AEM Forms. Per ulteriori informazioni su cosa considerare durante l'esecuzione dei backup per AEM Forms, consulta aiuto amministrativo.

Riepilogo dei passaggi

Per uscire dalla modalità di backup, esegui i seguenti passaggi:

1. Includi file di progetto.
2. Creare un oggetto client BackupService.
3. Lascia la modalità di backup.
4. (Facoltativo) Recupera informazioni sulla sessione in modalità di backup in esecuzione sul server dei moduli.

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 di backup e ripristino.

Per informazioni sulla posizione di questi file, vedi Inclusione dei file libreria Java di AEM Forms.

Creare un oggetto API client BackupService

Per uscire dalla modalità di backup a livello di programmazione, 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, 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

Lascia la modalità di backup utilizzando l’API del servizio Backup e ripristino (Java):

1. Includi file di progetto

   Includi i file JAR client necessari, come adobe-backup-restore-client-sdk.jar, nel percorso di classe del progetto Java. Per creare un’applicazione client Java, i seguenti file JAR devono essere aggiunti 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 su JBoss Application Server)
   • jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)

2. Creare un oggetto API client BackupService

   Utilizza un ServiceClientFactory insieme all'oggetto API client BackupService.

   • Crea un ServiceClientFactory oggetto contenente le proprietà di connessione. (Vedi Impostazione delle proprietà di connessione.)
   • Crea un BackupService utilizzando il relativo costruttore e passando ServiceClientFactory come parametro.

3. Modalità backup

   Lascia la modalità di backup richiamando il leaveBackupMode metodo .

4. Recupera informazioni sulla sessione in modalità di backup sul server

   Recupera informazioni sull'operazione utilizzando BackupModeResult oggetto restituito. Le informazioni che è possibile recuperare dopo l'accesso alla 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 dei file per la procedura di backup.

Lascia la modalità di backup utilizzando l’API del servizio Web

Lascia la modalità di backup utilizzando l'API del servizio Backup e ripristino (servizio Web):

1. Includi file di progetto

   Per utilizzare i servizi Web, è necessario assicurarsi di includere i file proxy. Segui questi passaggi per configurare il progetto per l’utilizzo dell’API del servizio Backup e ripristino come servizio Web.

   • Creare un assembly client Microsoft .NET che utilizzi la WSDL API del servizio di backup e ripristino.
   • Fare riferimento all'assembly client Microsoft .NET.

2. Creare un oggetto API client BackupService

   Utilizzando l'assembly client Microsoft .NET, creare un BackupServiceService richiamando il relativo costruttore predefinito.

3. Modalità backup

   Lascia la modalità di backup richiamando il leaveBackupMode funzionamento del servizio Web.

4. Recupera informazioni sulla sessione in modalità di backup sul server

   Recupera l'identificatore della modalità di backup dopo l'operazione per verificare che sia stato eseguito correttamente. Le informazioni che è possibile recuperare dopo aver lasciato la modalità di backup possono essere utili per l'integrazione con le procedure di backup.