pmg-docs/pmgbackup.adoc
Thomas Lamprecht a695a527fd use big thumbnails for all screenshots
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-11-20 09:33:15 +01:00

100 lines
2.1 KiB
Plaintext

[[chapter_pmgbackup]]
ifdef::manvolnum[]
pmgbackup(1)
============
:pmg-toplevel:
NAME
----
pmgbackup - Proxmox Mail Gateway Backup and Restore Utility
SYNOPSIS
--------
include::pmgbackup.1-synopsis.adoc[]
DESCRIPTION
-----------
endif::manvolnum[]
ifndef::manvolnum[]
Backup and Restore
==================
:pmg-toplevel:
endif::manvolnum[]
ifndef::manvolnum[]
[thumbnail="pmg-gui-backup.png", big=1]
endif::manvolnum[]
{pmg} includes the ability to backup and restore the
configuration. This includes the complete config from `/etc/pmg/`, the
mail filter rules and the statistic database.
NOTE: The backup does not include the network setup, and also no mail
data from the postfix queue or the spam or virus quarantine.
You can create a backup by simply pressing the 'Backup' button on the
GUI, or by using the command line interface:
----
# pmgbackup backup
starting backup to: /var/lib/pmg/backup/pmg-backup_2018_01_04_5A4E0436.tgz
backup finished
----
Backups are stored inside directory `/var/lib/pmg/backup/`. It is
usually best to mount a remote file system to that directory, so that
the resulting backups gets stored remotely.
You can list the contents of that directory with:
----
# pmgbackup list
....
pmg-backup_2017_11_10_5A05D4B9.tgz 17012
pmg-backup_2017_11_13_5A09676A.tgz 16831
pmg-backup_2018_01_04_5A4E0436.tgz 21514
----
Restores are also possible using the GUI or command line, and you can
select what parts you want to restore:
System Configuration::
Basically the contents of `/etc/pmg/`.
Rule Database::
The mail filter rule database.
Statistic::
All statistical data.
For examply, you can selectively restore the mail filter rules from an
older backup:
----
# pmgbackup restore --filename pmg-backup_2018_01_04_5A4E0436.tgz --database
starting restore: /var/lib/pmg/backup/pmg-backup_2018_01_04_5A4E0436.tgz
config_backup.tar: OK
Proxmox_ruledb.sql: OK
Proxmox_statdb.sql: OK
version.txt: OK
Destroy existing rule database
Create new database
run analyze to speed up database queries
Analyzing/Upgrading existing Databases...done
restore finished
----
ifdef::manvolnum[]
include::pmg-copyright.adoc[]
endif::manvolnum[]