AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.
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.
Come per qualsiasi altro aspetto dell'implementazione AEM Forms, la strategia di backup e ripristino deve essere sviluppata e testata in un ambiente di sviluppo o di staging prima di essere utilizzata in produzione per garantire che l'intera soluzione funzioni come previsto senza perdita di dati.
È possibile eseguire queste operazioni utilizzando il servizio Backup e ripristino:
Per ulteriori informazioni su cosa considerare durante l'esecuzione dei backup per AEM Forms, consulta aiuto amministrativo.
Per ulteriori informazioni sul servizio Backup e ripristino, vedere Riferimento servizi per AEM Forms.
È 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:
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.
Per ulteriori informazioni sul servizio Backup e ripristino, vedere Riferimento servizi per AEM Forms.
Per creare un'applicazione che entra in modalità di backup, esegui i seguenti passaggi:
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.
Immettere la modalità di backup utilizzando l'API del servizio Backup e ripristino:
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:
Creare un oggetto API client BackupService
Utilizza un ServiceClientFactory
insieme all'oggetto API client BackupService.
ServiceClientFactory
oggetto contenente le proprietà di connessione. (Vedi Impostazione delle proprietà di connessione.)BackupService
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.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.
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.
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.
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 il servizio Web fornito dall'API del servizio di backup e ripristino:
Includi file di progetto
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 .
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.
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.
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.
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.
È 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.
Per ulteriori informazioni sul servizio Backup e ripristino, vedere Riferimento servizi per AEM Forms.
Per uscire dalla modalità di backup, esegui i seguenti passaggi:
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 del servizio Backup e ripristino (Java):
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:
Creare un oggetto API client BackupService
Utilizza un ServiceClientFactory
insieme all'oggetto API client BackupService.
ServiceClientFactory
oggetto contenente le proprietà di connessione. (Vedi Impostazione delle proprietà di connessione.)BackupService
utilizzando il relativo costruttore e passando ServiceClientFactory
come parametro.Modalità backup
Lascia la modalità di backup richiamando il leaveBackupMode
metodo .
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 Backup e ripristino (servizio Web):
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 oggetto API client BackupService
Utilizzando l'assembly client Microsoft .NET, creare un BackupServiceService
richiamando il relativo costruttore predefinito.
Modalità backup
Lascia la modalità di backup richiamando il leaveBackupMode
funzionamento del servizio Web.
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.