Esistono due modi per eseguire il backup e ripristinare il contenuto dell'archivio in AEM:
L'approccio descritto si applica al backup e al ripristino del sistema.
Se è necessario eseguire il backup e/o recuperare una piccola quantità di contenuto, che viene persa, non è necessario ripristinare il sistema:
Per informazioni dettagliate, consultate Backup dei pacchetti di seguito.
Non eseguite il backup in parallelo con la raccolta dei rifiuti del datastore, in quanto potrebbe danneggiare i risultati di entrambi i processi.
È sempre possibile eseguire un backup offline. Ciò richiede un tempo di AEM, ma può essere abbastanza efficiente in termini di tempo richiesto rispetto a un backup online.
Nella maggior parte dei casi, per creare una copia di sola lettura dell'archivio in quel momento si utilizzerà un'istantanea del file system. Per creare un backup offline, effettuare le seguenti operazioni:
Poiché il backup dello snapshot in genere richiede solo pochi secondi, l'intero tempo di inattività è inferiore a pochi minuti.
Questo metodo di backup crea un backup dell’intero repository, incluse tutte le applicazioni implementate al suo interno, come AEM. Il backup include contenuti, cronologia delle versioni, configurazione, software, hotfix, applicazioni personalizzate, file di registro, indici di ricerca e così via. Se si utilizza il clustering e se la cartella condivisa è una sottodirectory di crx-quickstart
(fisicamente o utilizzando un softlink), viene eseguito anche il backup della directory condivisa.
È possibile ripristinare l'intero repository (e qualsiasi applicazione) in un momento successivo.
Questo metodo funziona come un backup "a caldo" o "online", in modo che possa essere eseguito durante l'esecuzione del repository. Pertanto, il repository è utilizzabile durante l'esecuzione del backup. Questo metodo funziona per le istanze di repository predefinite basate su archivio tar.
Durante la creazione di un backup, sono disponibili le seguenti opzioni:
In ogni caso, il backup crea un'immagine (o istantanea) del repository. L'agente di backup dei sistemi deve quindi provvedere a trasferire l'immagine a un sistema di backup dedicato (unità a nastro).
Se AEM funzione di backup online viene utilizzata in un'istanza AEM con una configurazione di blobstore personalizzata, si consiglia di configurare il percorso del datastore in modo che si trovi all'esterno della directory " crx-quickstart
" e di eseguire il backup del datastore separatamente.
Il backup online esegue solo il backup del file system. Se archiviate il contenuto del repository e/o i file del repository in un database, è necessario eseguire il backup del database separatamente. Se utilizzate AEM con MongoDB, consultate la documentazione sull'utilizzo degli strumenti di backup nativi MongoDB.
Un backup online del repository consente di creare, scaricare ed eliminare i file di backup. Si tratta di una funzione di backup "hot" o "online", che può essere eseguita mentre il repository viene utilizzato normalmente in modalità di lettura/scrittura.
Non eseguite AEM backup online in modo simultaneo con DataStore Garbage Collection o Revision Cleanup. Ciò influirà negativamente sulle prestazioni del sistema.
Quando si avvia un backup è possibile specificare un percorso di destinazione e/o un ritardo.
Target PathI file di backup vengono in genere salvati nella cartella principale della cartella contenente il file jar di avvio rapido (.jar). Ad esempio, se il file AEM jar si trova in /InstallationKits/AEM, il backup verrà generato in /InstallationKits. Potete anche specificare una destinazione in una posizione di vostra scelta.
Se TargetPath è una directory, l'immagine del repository viene creata in questa directory. Se la stessa directory viene utilizzata più volte (o sempre) per memorizzare il backup,
Se TargetPath è impostato su nomefile con l'estensione .zip, il repository viene sottoposto a backup in una directory temporanea e il contenuto di questa directory temporanea viene compresso e memorizzato nel file ZIP.
Questo approccio è scoraggiato, perché
Se è necessario creare un ZIP come formato di backup, è necessario eseguire il backup in una directory e quindi utilizzare un programma di compressione per creare il file zip.
Ritardo: indica un ritardo (in millisecondi), in modo che le prestazioni del repository non vengano alterate. Per impostazione predefinita, il backup del repository viene eseguito a tutta velocità. È possibile rallentare la creazione di un backup online, in modo da non rallentare altre attività.
Quando si utilizza un ritardo molto elevato, assicurarsi che il backup online non richieda più di 24 ore. In caso affermativo, scartare il backup, in quanto non può contenere tutti i file binari.
Un ritardo di 1 millisecondo genera in genere un utilizzo della CPU pari al 10% e un ritardo di 10 millisecondi in genere riduce l’utilizzo della CPU al 3%. Il ritardo totale in secondi può essere stimato come segue: Dimensione del repository in MB, moltiplicata per il ritardo in millisecondi, divisa per 2 (se si utilizza l'opzione zip), o divisa per 4 (quando si esegue il backup su una directory). Ciò significa che un backup in una directory di un repository da 200 MB con un ritardo di 1 ms aumenta il tempo di backup di circa 50 secondi.
Per informazioni dettagliate sul processo, vedere Funzionamento AEM backup online.
Per creare un backup:
Accedete per AEM come amministratore.
Vai a Strumenti - Operazioni - Backup.
Fai clic su Crea. Viene aperta la console di backup.
Nella console di backup, specificate i Percorso di destinazione e Ritardo.
La console di backup è disponibile anche tramite:
https://<*hostname*>:<*port-number*>/libs/granite/backup/content/admin.html
Fare clic su Salva, una barra di avanzamento indicherà l'avanzamento del backup.
È possibile annullare un backup in esecuzione in qualsiasi momento.
Una volta completato il backup, i file zip sono elencati nella finestra di backup.
I file di backup non più necessari possono essere rimossi utilizzando la console. Selezionare il file di backup nel riquadro a sinistra, quindi fare clic su Elimina.
Se avete eseguito il backup in una directory: al termine del processo di backup, AEM non scriverà nella directory di destinazione.
Se possibile, il backup online dovrebbe essere eseguito quando il carico sul sistema è limitato, ad esempio la mattina.
I backup possono essere automatizzati utilizzando i client wget
o curl
HTTP. Di seguito sono riportati alcuni esempi di automazione del backup tramite curl.
Nell'esempio seguente potrebbero essere necessari diversi parametri nel comando curl
per l'istanza; ad esempio, il nome host ( localhost
), la porta ( 4502
), la password amministratore ( xyz
) e il nome del file ( backup.zip
).
curl -u admin:admin -X POST http://localhost:4502/system/console/jmx/com.adobe.granite:type=Repository/op/startBackup/java.lang.String?target=backup.zip
Il file/directory di backup viene creato sul server nella cartella principale della cartella contenente la cartella crx-quickstart
(come se si stesse creando il backup utilizzando il browser). Ad esempio, se AEM installato nella directory /InstallationKits/crx-quickstart/
, il backup viene creato nella directory /InstallationKits
.
Il comando curl ritorna immediatamente, quindi è necessario monitorare questa directory per vedere quando il file zip è pronto. Mentre il backup viene creato una directory temporanea (con il nome basato su quello del file zip finale) può essere visto, alla fine verrà compresso. Esempio:
backup.zip
backup.f4d5.temp
Solitamente il file/directory di backup viene creato sul server nella cartella principale della cartella contenente la cartella crx-quickstart
.
Se si desidera salvare il backup (di entrambi gli ordini) in una posizione diversa, è possibile impostare un percorso assoluto "al parametro target
nel comando curl
.
Ad esempio, per generare backupJune.zip
nella directory /Backups/2012
:
curl -u admin:admin -X POST http://localhost:4502/system/console/jmx/com.adobe.granite:type=Repository/op/startBackup/java.lang.String?target=/Backups/2012/backupJune.zip"
Quando si utilizza un server applicazione diverso (ad esempio JBoss), il backup online potrebbe non funzionare come previsto, perché la directory di destinazione non è scrivibile. In questo caso, contattate l'Assistenza.
È inoltre possibile attivare un backup utilizzando gli MBeans forniti da AEM.
Il processo qui descritto è particolarmente adatto per grandi archivi.
Se si desidera utilizzare questo approccio di backup, il sistema deve supportare snapshot del file system. Ad esempio, per Linux questo significa che i file system devono essere inseriti su un volume logico.
Eseguite un'istantanea del AEM del file system in cui è distribuita.
Montare lo snapshot del file system.
Eseguire un backup e smontare lo snapshot.
AEM Backup online è costituito da una serie di azioni interne per garantire l'integrità dei dati sottoposti a backup e dei file di backup creati. Questi sono elencati di seguito per gli interessati.
Il backup online utilizza il seguente algoritmo:
Quando create un file zip, il primo passaggio consiste nel creare o individuare la directory di destinazione.
Se viene eseguito il backup su un file zip, viene creata una directory temporanea. Il nome della directory inizia con backup.
e termina con .temp
; ad esempio backup.f4d3.temp
.
Se viene eseguito il backup in una directory, viene utilizzato il nome specificato nel percorso di destinazione. È possibile utilizzare una directory esistente. In caso contrario verrà creata una nuova directory.
Un file vuoto denominato backupInProgress.txt
viene creato nella directory di destinazione all'avvio del backup. Questo file viene eliminato al termine del backup.
I file vengono copiati dalla directory di origine alla directory di destinazione (o alla directory temporanea al momento della creazione di un file zip). L'archivio segmenti viene copiato prima dell'archivio dati per evitare il danneggiamento dell'archivio. I dati di indice e cache vengono omessi durante la creazione del backup. Di conseguenza, i dati di crx-quickstart/repository/cache
e crx-quickstart/repository/index
non sono inclusi nel backup. L'indicatore della barra di avanzamento del processo è compreso tra 0% e 70% durante la creazione di un file ZIP, oppure tra 0% e 100% se non viene creato alcun file ZIP.
Se il backup viene eseguito su una directory preesistente, i file "vecchi" nella directory di destinazione vengono eliminati. I file precedenti sono file che non esistono nella directory di origine.
I file vengono copiati nella directory di destinazione in quattro fasi:
Nella prima fase di copia (indicatore di avanzamento 0% - 63% quando si crea un file ZIP oppure 0% - 90% se non viene creato alcun file ZIP), tutti i file vengono copiati mentre l'archivio è in esecuzione normalmente. Il processo prevede due fasi:
Nella seconda fase di copia (indicatore di avanzamento 63% - 65,8% quando si crea un file ZIP o 90% - 94% se non viene creato alcun file ZIP) vengono copiati solo i file creati o modificati nella directory di origine dall’avvio della prima fase di copia. A seconda dell’attività dell’archivio, questo può variare da nessun file, fino a un numero significativo di file (in genere la prima fase di copia del file richiede molto tempo). Il processo di copia è simile alla prima fase (fase A e fase B con ritardo).
Nella terza fase di copia (indicatore di avanzamento 65,8% - 68,6% quando si crea un file ZIP o 94% - 98% se non viene creato alcun file ZIP) vengono copiati solo i file creati o modificati nella directory di origine dall’avvio della seconda fase di copia. A seconda dell’attività dell’archivio, potrebbe non esserci alcun file da copiare o un numero molto ridotto di file (in quanto la seconda fase di copia del file è in genere rapida). Il processo di copia è simile alla seconda fase - fase A e fase B, ma senza ritardo.
Le fasi di copia dei file da uno a tre vengono tutte eseguite contemporaneamente mentre la directory archivio è in esecuzione. Vengono copiati solo i file creati o modificati nella directory di origine dall’avvio della terza fase di copia. A seconda dell'attività del repository, potrebbe non esserci alcun file da copiare, o un numero molto, molto limitato di file (perché la seconda fase di copia del file è in genere molto veloce). Indicatore di avanzamento 68,6% - 70% quando si crea un file ZIP o 98% - 100% se non viene creato alcun file ZIP. Il processo di copia è simile alla terza fase.
A seconda della destinazione:
backupInProgress.txt
viene eliminato per indicare che il backup è terminato.È possibile ripristinare un backup come segue:
Per eseguire il backup e ripristinare il contenuto, potete utilizzare uno dei servizi di gestione pacchetti, che utilizza il formato Pacchetto contenuti per eseguire il backup e il ripristino del contenuto. Gestione pacchetti offre maggiore flessibilità nella definizione e gestione dei pacchetti.
Per informazioni dettagliate sulle caratteristiche e sulle compensazioni di ciascuno di questi formati di pacchetto di contenuti, consultate Come lavorare con i pacchetti.
Quando eseguite il backup dei nodi utilizzando Gestione pacchetti o Content Zipper, CRX salva le informazioni seguenti:
Durante il backup, AEM perde le seguenti informazioni: