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 il ripristino di una piccola quantità di contenuto, che viene persa, non è necessario un ripristino del sistema:
Per maggiori dettagli, vedi Backup dei pacchetti sotto.
Non eseguire il backup in parallelo con la Garbage Collection del datastore, in quanto potrebbe danneggiare i risultati di entrambi i processi.
Puoi sempre eseguire un backup offline. Questo 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, verrà utilizzata un'istantanea del file system. Per creare un backup offline, esegui questi passaggi:
Poiché il backup dello snapshot richiede in genere solo pochi secondi, l'intero downtime è inferiore a pochi minuti.
Questo metodo di backup crea un backup dell'intero archivio, incluse tutte le applicazioni distribuite al suo interno, ad esempio AEM. Il backup include contenuti, cronologia delle versioni, configurazione, software, hotfix, applicazioni personalizzate, file di registro, indici di ricerca e così via. Se utilizzi il clustering e se la cartella condivisa è una sottodirectory di crx-quickstart
(fisicamente o utilizzando un collegamento software), viene eseguito anche il backup della directory condivisa.
Puoi ripristinare l’intero archivio (e qualsiasi applicazione) in un momento successivo.
Questo metodo funziona come backup "a caldo" o "online" in modo che possa essere eseguito mentre l'archivio è in esecuzione. Pertanto l'archivio è utilizzabile durante l'esecuzione del backup. Questo metodo funziona per le istanze dell'archivio Tar predefinite basate su archiviazione.
Quando crei un backup, hai le seguenti opzioni:
In ogni caso, il backup crea un'immagine (o un'istantanea) dell'archivio. Quindi l'agente di backup dei sistemi dovrebbe fare attenzione a trasferire questa 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 dell'archivio dati in modo che sia all'esterno del " crx-quickstart
" directory e backup del datastore separatamente.
Il backup online esegue solo il backup del file system. Se si memorizzano il contenuto del repository e/o i file del repository in un database, è necessario eseguire il backup separatamente. Se utilizzi AEM con MongoDB, consulta la documentazione su come utilizzare il Strumenti di backup nativi MongoDB.
Un backup online dell'archivio consente di creare, scaricare ed eliminare file di backup. Si tratta di una funzione di backup "hot" o "online", quindi può essere eseguita mentre l'archivio viene utilizzato normalmente in modalità di lettura-scrittura.
Non eseguire AEM backup online contemporaneamente con Raccolta rifiuti di Datastore o Pulizia revisioni. Influirà negativamente sulle prestazioni del sistema.
Quando si avvia un backup è possibile specificare un Percorso di Target e/o a Ritardo.
Percorso di Target I file di backup vengono generalmente salvati nella cartella padre della cartella che contiene il file jar quickstart (.jar). Ad esempio, se il file jar AEM si trova in /InstallationKits/AEM, il backup verrà generato in /InstallationKits. Puoi anche specificare un target per una posizione di tua scelta.
Se la TargetPath è una directory, l'immagine dell'archivio 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 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 devi creare un file ZIP come formato di backup, devi 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 influenzate. Per impostazione predefinita, il backup dell'archivio viene eseguito a piena velocità. È possibile rallentare la creazione di un backup online in modo che non rallenti altre attività.
Quando utilizzi un ritardo molto elevato, assicurati che il backup online non richieda più di 24 ore. Se lo ha fatto, scarta questo backup, in quanto potrebbe non contenere tutti i binari.
Un ritardo di 1 millisecondo in genere si traduce in un utilizzo della CPU del 10% e un ritardo di 10 millisecondi di solito si traduce in meno del 3% dell'utilizzo della CPU. 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 su una directory di un archivio da 200 MB con un ritardo di 1 ms aumenta il tempo di backup di circa 50 secondi.
Vedi Come funziona AEM backup online per informazioni interne sul processo.
Per creare un backup:
Accedi a AEM come amministratore.
Vai a Strumenti - Operazioni - Backup.
Fai clic su Crea. Viene aperta la console di backup.
Nella console di backup, specifica l’ Percorso di Target e Ritardo.
La console di backup è disponibile anche utilizzando:
https://<*hostname*>:<*port-number*>/libs/granite/backup/content/admin.html
Fai clic su Salva, una barra di avanzamento indicherà l’avanzamento del backup.
È possibile Annulla un backup in esecuzione in qualsiasi momento.
Una volta completato il backup, i file zip vengono elencati nella finestra di backup.
I file di backup non più necessari possono essere rimossi tramite la console. Selezionare il file di backup nel riquadro a sinistra, quindi fare clic su Elimina.
Se hai eseguito il backup su una directory: al termine del processo di backup, AEM non scriverà nella directory di destinazione.
Se possibile, il backup online deve essere eseguito quando il sistema non è caricato, ad esempio la mattina.
I backup possono essere automatizzati utilizzando wget
o curl
Client HTTP. Di seguito sono riportati alcuni esempi di come automatizzare il backup utilizzando curl.
Nell’esempio seguente, vari parametri nel curl
potrebbe essere necessario configurare il comando per la tua istanza; ad esempio, il nome host ( localhost
), porta ( 4502
), 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 padre della cartella contenente il crx-quickstart
come se si stesse creando il backup utilizzando il browser. Ad esempio, se hai installato AEM nella directory /InstallationKits/crx-quickstart/
, quindi il backup viene creato nel /InstallationKits
directory.
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 sarà compresso. Esempio:
backup.zip
backup.f4d5.temp
Di solito il file/directory di backup viene creato sul server nella cartella padre della cartella contenente il crx-quickstart
cartella.
Se desideri salvare il backup (di entrambi gli ordini) in una posizione diversa, puoi impostare un percorso assoluto "al target
nel curl
comando.
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 applicativo diverso (come JBoss), il backup online potrebbe non funzionare come previsto, perché la directory di destinazione non è scrivibile. In questo caso, contatta il supporto.
È inoltre possibile attivare un backup utilizzando i MBeans forniti da AEM.
Il processo qui descritto è particolarmente adatto per grandi archivi.
Se desideri utilizzare questo approccio di backup, il sistema deve supportare le istantanee del file system. Ad esempio, per Linux questo significa che i file system devono essere posizionati su un volume logico.
Esegui un'istantanea del AEM del filesystem distribuito in.
Montare lo snapshot del file system.
Esegui un backup e smonta lo snapshot.
AEM Online Backup è costituito da una serie di azioni interne per garantire l'integrità dei dati sottoposti a backup e dei file di backup in fase di creazione. Questi sono elencati di seguito per gli interessati.
Il backup online utilizza il seguente algoritmo:
Quando si crea un file zip, il primo passo è quello di creare o individuare la directory di destinazione.
Se si esegue il backup su un file zip, viene creata una directory temporanea. Il nome della directory inizia con backup.
e termina con .temp
; per esempio backup.f4d3.temp
.
Se si esegue il backup su una directory, viene utilizzato il nome specificato nel percorso di destinazione. È possibile utilizzare una directory esistente, altrimenti 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 directory temporanea durante la creazione di un file zip). Il segmentstore viene copiato prima del datastore per evitare la corruzione dell'archivio. I dati dell'indice e della cache vengono omessi durante la creazione del backup. Di conseguenza, i dati da crx-quickstart/repository/cache
e crx-quickstart/repository/index
non è incluso nel backup. L'indicatore della barra di avanzamento del processo è compreso tra 0% - 70% quando si crea un file zip, o tra 0% - 100% se non viene creato alcun file zip.
Se il backup viene effettuato 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 o 0% - 90% se non viene creato), tutti i file vengono copiati mentre l'archivio è in esecuzione normale. 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) 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 potrebbe variare da nessun file, fino a un numero significativo di file (perché la prima fase di copia del file in genere 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) 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 (perché la seconda fase di copia del file è in genere veloce). Il processo di copia è simile alla seconda fase - fase A e fase B ma senza indugio.
Le fasi da una a tre della copia del file vengono eseguite contemporaneamente mentre l'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à dell’archivio, potrebbe non esserci alcun file da copiare, o un numero molto, molto ridotto di file (perché la seconda fase di copia del file di solito è 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 del target:
backupInProgress.txt
viene eliminato per indicare che il backup è terminato.È possibile ripristinare un backup come segue:
Per eseguire il backup e il ripristino del contenuto, puoi utilizzare una delle 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 sui compromessi di ciascuno di questi formati di pacchetti di contenuti, consulta Come lavorare con i pacchetti.
Quando esegui il backup dei nodi utilizzando Gestione pacchetti o Content Zipper, CRX salva le seguenti informazioni:
Durante il backup, AEM perde le seguenti informazioni: