Esistono due modi per eseguire il backup e il ripristino del contenuto dell'archivio in AEM:
L'approccio qui 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, il ripristino del sistema non è necessariamente necessario:
Per ulteriori informazioni, consulta Backup dei pacchetti di seguito.
Non eseguire il backup in parallelo con la raccolta di oggetti inattivi dell’archivio dati, in quanto potrebbe danneggiare i risultati di entrambi i processi.
È sempre possibile eseguire un backup offline. Questo richiede tempi di inattività per l'AEM, ma può essere abbastanza efficiente in termini di tempo richiesto rispetto a un backup online.
Nella maggior parte dei casi si utilizza uno snapshot del file system per creare una copia di sola lettura dello storage in quel momento. Per creare un backup non in linea, effettuare le seguenti operazioni:
Poiché il backup delle copie istantanee richiede in genere solo pochi secondi, l'intero tempo di inattività è 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 contenuto, cronologia delle versioni, configurazione, software, aggiornamenti rapidi, applicazioni personalizzate, file di registro, indici di ricerca e così via. Se si utilizza il clustering e 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 secondo momento.
Questo metodo funziona come backup "a caldo" o "online" e può essere eseguito mentre l’archivio è in esecuzione. Pertanto, l’archivio è utilizzabile durante l’esecuzione del backup. Questo metodo funziona per le istanze predefinite dell’archivio basate su archiviazione Tar.
Durante la creazione di un backup, sono disponibili le seguenti opzioni:
In ogni caso, il backup crea un’immagine (o un’istantanea) dell’archivio. L'agente di backup del sistema deve quindi fare attenzione a trasferire effettivamente questa immagine a un sistema di backup dedicato (unità nastro).
Se la funzione di backup online dell’AEM viene utilizzata in un’istanza AEM con una configurazione personalizzata dell’archivio dati, si consiglia di configurare il percorso dell’archivio dati in modo che sia esterno al " crx-quickstart
" ed eseguire separatamente il backup dell’archivio dati.
Il backup online esegue solo il backup del file system. Se si archivia il contenuto del repository e/o i file del repository in un database, è necessario eseguire separatamente il backup del database. Se sta usando l’AEM con MongoDB, consulti la documentazione sull’utilizzo di 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 "a caldo" o "online", che può essere eseguita mentre l’archivio viene utilizzato normalmente in modalità di lettura-scrittura.
Non eseguire il backup online dell'AEM contemporaneamente a Raccolta oggetti inattivi archivio dati o Pulizia revisioni. Influenzerà negativamente le prestazioni del sistema.
All'avvio di un backup è possibile specificare Percorso di destinazione e/o un Ritardo.
Percorso di destinazione I file di backup vengono in genere salvati nella cartella principale della cartella contenente il file jar quickstart (.jar). Ad esempio, se il file jar dell’AEM si trova in /InstallationKits/AEM, il backup verrà generato in /InstallationKits. Puoi anche specificare un target per una posizione a tua scelta.
Se il 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, viene eseguito il backup dell'archivio in una directory temporanea e quindi il contenuto di questa directory temporanea viene compresso e memorizzato nel file ZIP.
Questo approccio è sconsigliato, 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) che non influisce sulle prestazioni dell’archivio. Per impostazione predefinita, il backup dell’archivio viene eseguito a piena velocità. È possibile rallentare la creazione di un backup online in modo da non rallentare altre attività.
Quando si utilizza un ritardo elevato, assicurarsi che il backup online non richieda più di 24 ore. In caso contrario, eliminare questo backup, poiché potrebbe non contenere tutti i file binari.
Un ritardo di 1 millisecondo comporta in genere un utilizzo della CPU del 10% e un ritardo di 10 millisecondi in genere comporta un utilizzo della CPU inferiore al 3%. Il ritardo totale in secondi può essere stimato come segue: dimensione dell’archivio 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 in una directory). Ciò significa che un backup in una directory di un archivio da 200 MB con un ritardo di 1 ms aumenta il tempo di backup di circa 50 secondi.
Consulta Funzionamento del backup online dell'AEM per i dettagli interni del processo.
Per creare un backup:
Accedi all’AEM come amministratore.
Vai a Strumenti - Operazioni - Backup.
Fai clic su Crea. Viene aperta la console di backup.
Nella console di backup, specifica Percorso di destinazione e Ritardo.
La console di backup è disponibile anche utilizzando:
https://<*hostname*>:<*port-number*>/libs/granite/backup/content/admin.html
Clic Salva, una barra di avanzamento indica l'avanzamento del backup.
È possibile Annulla un backup in esecuzione in qualsiasi momento.
Al termine del backup, i file zip vengono 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 di sinistra, quindi fare clic su Elimina.
Se è stato eseguito il backup in 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 carico sul sistema è ridotto, ad esempio al mattino.
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 vengono illustrati vari parametri di curl
potrebbe essere necessario configurare il comando per la tua istanza; ad esempio, il nome host ( localhost
), porta ( 4502
), password amministratore ( xyz
) e nome 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 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 in /InstallationKits
directory.
Il comando curl viene restituito immediatamente, pertanto è necessario monitorare questa directory per vedere quando il file zip è pronto. Durante la creazione del backup è possibile visualizzare una directory temporanea (con il nome basato su quello del file zip finale), alla fine verrà compresso. Ad esempio:
backup.zip
backup.f4d5.temp
Di solito il file/la directory di backup viene creato sul server nella cartella principale della cartella contenente crx-quickstart
cartella.
Se si desidera salvare il backup (di entrambi i tipi) in una posizione diversa, è possibile impostare un percorso assoluto "per target
parametro in 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 applicazioni diverso (ad esempio JBoss), il backup online potrebbe non funzionare come previsto, perché la directory di destinazione non è scrivibile. In questo caso, contatta il supporto tecnico.
È inoltre possibile attivare un backup utilizzando gli MBean forniti dall’AEM.
Il processo qui descritto è particolarmente adatto per archivi di grandi dimensioni.
Se si desidera 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.
Crea un’istantanea del file system su cui è implementato AEM.
Montare lo snapshot del file system.
Eseguire un backup e smontare la copia istantanea.
Il servizio Backup online AEM è costituito da una serie di azioni interne volte a garantire l'integrità dei dati di cui viene eseguito il backup e dei file di backup creati. Di seguito sono elencati i nomi delle persone interessate.
Il backup online utilizza il seguente algoritmo:
Quando si crea un file zip, il primo passaggio consiste nel creare o individuare la directory di destinazione.
Se si esegue il backup in 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 si esegue il backup in 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 alla directory temporanea durante la 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 provenienti 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% e 70% quando si crea un file zip, oppure tra 0% e 100% se non viene creato alcun file zip.
Se il backup viene eseguito in una directory preesistente, i file "vecchi" nella directory di destinazione vengono eliminati. I file obsoleti 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% durante la creazione di un file zip o 0% - 90% se non viene creato alcun file zip), tutti i file vengono copiati mentre l’archivio è in esecuzione normalmente. Il processo si articola in due fasi:
Nella seconda fase di copia (indicatore di avanzamento 63% - 65,8% durante la creazione di 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 (perché la prima fase di copia dei file in genere richiede più 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, potrebbero non esserci file da copiare o un numero molto ridotto di file (perché la seconda fase di copia dei file è in genere veloce). Il processo di copia è simile alla seconda fase - Fase A e Fase B ma senza ritardi.
Le fasi da uno a tre della copia dei file vengono tutte eseguite contemporaneamente durante l'esecuzione dell'archivio. 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, potrebbero non esserci file da copiare o un numero molto, molto ridotto di file (perché la seconda fase di copia dei 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 nel modo seguente:
Per eseguire il backup e il ripristino del contenuto, è possibile utilizzare uno dei Gestori pacchetti, che utilizza il formato Pacchetto di contenuti per eseguire il backup e il ripristino del contenuto. Gestione pacchetti offre maggiore flessibilità nella definizione e nella gestione dei pacchetti.
Per maggiori informazioni sulle caratteristiche e sulle scelte rapide di ciascuno di questi formati, consultare Come utilizzare i pacchetti.
Quando esegui il backup dei nodi utilizzando Gestione pacchetti o Content Zipper, CRX salva le seguenti informazioni:
Durante il backup, l'AEM perde le seguenti informazioni: