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:
| Parametro | Descrizione |
|---|---|
| logicaldoc.home | Percorso assoluto di installazione di LogicalDOC |
| backup.targetdir | Percorso assoluto della cartella che riceverà gli archivi di backup |
| db.username | Lo username da usare per collegarsi al database |
| db.password | La 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.dir | Percorso 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.