Skip to main content

Ripristino

Attenzione

La procedura di ripristino prima distrugge fisicamente la tua attuale installazione di LogicalDOC e solo dopo aver tenta di ripristinare i dati dal tuo backup.

Data la delicatezza della questione, vi consigliamo vivamente di pianificare attentamente tale azione e in caso di dubbi rivolgetevi al servizio di supporto.

Per ripristinare i dati da un backup precedente, apri una console nella cartella di installazione di LogicalDOC Backup ed esegui il seguente comando:

Windows:

restore.bat

Linux and OSX:

restore.sh

Ripristinare fino a una certa data

Invece di ripristinare tutto dall'inizio fino all'ultimo backup, è possibile ripristinare il sistema fino a una determinata data semplicemente specificandola utilizzando il formato ISO aaaa-MM-gg (es. 2020-09-27):

Windows:

restore.bat 2020-09-27

Linux and OSX:

restore.sh 2020-09-27

Esegui come utente Administrator

In Windows la procedura di ripristino deve essere lanciata da una finestra di comando come Administrator, perché deve interagire con servizi di sistema. In particolare, la procedura di recupero interrompe il processo LogicalDOC per ripristinare i dati correttamente. Al termine della procedura di ripristino il servizio LogicalDOC viene riavviato automaticamente.

Backup

Per eseguire il backup, apri una console, naviga nella cartella di installazione di LogicalDOC Backup e digita il seguente comando:

Windows:

backup.bat

Linux and Mac:

backup.sh

Prodotto del backup

Lo strumento di backup produce una serie di sottocartelle nella cartella di destinazione. Così avremo un albero di sottocartelle in cui ogni nodo rappresenta il prodotto del backup dedicato ad una certa risorsa. A seconda del tipo di risorsa il programma esegue un tipo di backup specifico, in particolare:

configuration incrementale, singolo file .zip
plugins incrementale, singolo file .zip
user preferences incrementale, singolo file .zip
index immagine, singolo file .zip
database delta, file .zip m ultipli
storage incrementale, file .zip m ultipli

Spazio disco per i backup

Per eseguire il backup è necessario disporre di un disco con almeno l'80% dello spazio occupato dai documenti in LogicalDOC.

Installazione del Backup

LogicalDOC Backup deve essere installato nello stesso server in cui è installato LogicalDOC.

Scarica il pacchetto di installazione per il tuo sistema dal sito di download.

Durante l'installazione ti verrà richiesto di fornire la cartella in cui è installato LogicalDOC e la cartella di destinazione che riceverà i pacchetti di backup.

Configurazione

Il programma di installazione configura lo strumento di backup con impostazioni comuni, ma è possibile modificarle in qualsiasi momento modificando il file di configurazione situato in <Backup_Home>/conf/context.properties:

ParametroDescrizione
logicaldoc.homePercorso assoluto di installazione di LogicalDOC
backup.targetdirPercorso assoluto della cartella che riceverà gli archivi di backup
db.usernameLo username da usare per collegarsi al database
db.passwordLa password da usare per collegarsi al database
db.host

Hostname o indirizzo IP del database. Valore di default: localhost

db.port

Porta del database. Valore di default: 3306 per MySQL, 5342 per PostgreSQL

db.name

Nome del database. Valore di default: logicaldoc

backup.db.dirPercorso assoluto della cartella temporanea che riceverà i dump del database
backup.db.command

Percorso assoluto del comando di dump. Valore di default: mysqldump per MySQL, pg_dump per PostgreSQL

backup.db.arguments

Argomenti per il comando di dump.

Valore di default per MySQL: -h ${db.host} -P ${db.port] -u ${db.username} -p${db.password} ${db.name}

Valore di default per PostgreSQL: -h ${db.host} -p ${db.port} -U ${db.username} -d ${db.name}

backup.db.data.command

Percorso completo del comando del database per estrarre i dati. Valore di default: mysqldump per MySQL, pg_dump per PostgreSQL

backup.db.data.arguments

Argomenti da passare al comando di dump dei dati.

Valore di default per MySQL: -h ${db.host} -P ${db.port} -u ${db.username} -p"${db.password}" --tab ${backup.db.dir} ${db.name}

Valore di default per PostgreSQL: -h ${db.host} -p ${db.port} -U ${db.username} -d ${db.name}

restore.db.command

Percorso assoluto del comando di restore. Valore di default: mysql per MySQL, psql per PostgreSQL

restore.db.arguments

Argomenti per il comando di restore.

Valore di default per MySQL: -h ${db.host} -P ${db.port] -u ${db.username} -p${db.password} ${db.name}

Valore di default per PostgreSQL: -h ${db.host} -p ${db.port} -U ${db.username} -d ${db.name}

restore.db.data.command

Percorso completo del comando del database per ripristinare i dati. Valore di default: mysqlimport per MySQL, psql per PostgreSQL

restore.db.data.arguments

Argomenti da passare al comando di ripristino dei dati.

Valore di default per MySQL: -h ${db.host} -P ${db.port} -u ${db.username} -p"${db.password}" -i --ignore-foreign-keys=true --use-threads=4 ${db.name}

Valore di default per PostgreSQL: -h ${db.host} -p ${db.port} -U ${db.username} -d ${db.name}

MySQL Secure File Priv

LogicalDOC Backup deve esportare i tuoi dati nella cartella temporanea configurata nell'impostazione backup.db.dir, ma se stai utilizzando MySQL o MariaDB, c'è la variabile di configurazione secure-file-priv utilizzata per limitare l'effetto delle operazioni d'importazione ed esportazione dei dati. Queste operazioni sono consentite solo agli utenti che dispongono del privilegio FILE sul percorso specificato.

Per fare in modo che LogicalDOC Backup possa estrarre i tuoi dati, scommenta la variabile secure-file-priv nel tuo file di configurazione my.ini o my.cnf e impostala su una stringa vuota o sullo stesso percorso specificato in backup.db .dir:

secure-file-priv = ""

-- oppure --

secure-file-priv = "same path of backup.db.dir"

Log dell'applicazione

Il tool di backup invia il suo output alla console. Inoltre crea file di log nella cartella logs. All'interno di questa cartella, il sistema scrive dei file di log che descrivono le attività di backup. Un nuovo file di log viene creato ad ogni esecuzione.

Ricevere rapporti di backup per Email

LogicalDOC Backup può inviare ad un elenco di destinatari di una relazione contenente i risultati di ogni elaborazione. Questo ti tiene aggiornato sullo stato del backup del sistema senza la necessità di ispezionare periodicamente i registri.

Per consentire allo strumento di inviare i rapporti e-mail, basta collegarlo a un server SMTP in <Backup Home>/conf/context.properties:
IMPOSTAZIONI DEL BACKUP PER L'EMAIL
Parametro Descrizione
smtp.enabled Metti true se vuoi ricevere il rapporto via email
smtp.host Hostname o indirizzo IP del server SMTP
smtp.port Porta di connessione al server SMTP
smtp.username Username per collegarsi al server SMTP
smtp.password Password per collegarsi al server SMTP
smtp.sender Indirizzo Email usato per inviare i rapporti
smtp.recipient Lista separata da virgole degli indirizzi che riceveranno i rapporti
 

 

LogicalDOC Backup

LogicalDOC Backup è un componente opzionale che può essere installato se avete bisogno di una soluzione di backup dedicata per il vostro archivio documentale.

Queste sono le caratteristiche più importanti del modulo LogicalDOC Backup:

  • Compressione e criptazione degli archivi
  • Adatto per repositori di grandi dimensioni
  • Salvataggio su disco locale, disco di rete, chiave USB, server FTP o SFTP
  • Supporto per backup incrementali
  • Supporto per backup delta
  • Tutti i processi sono transazionali (questo garantisce l'integrità dei tuoi backup)
  • Interfaccia a riga di comando
  • Rapporto attività per email
  • Supporto multi-piattaforma: Windows, Unix, Linux, Mac OSX