Admin Guide: Add some more detailed info throughout
- Mention config files for: datastores, users, acl, remotes, syncjobs - Expand a little bit on SMART and smartmontools package - Explain acl config - Include line in network stating why a bond would be set up - Note the use of ifupdown2 for network config, and the potential need to install it on other systems - Add note to PVE integration, specifying where to refer to for VM and CT backups Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>
This commit is contained in:
parent
fe233f3b3d
commit
9d3f183ba9
@ -132,12 +132,13 @@ The command line tool to configure and manage the backup server is called
|
|||||||
:term:`DataStore`
|
:term:`DataStore`
|
||||||
~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
A datastore is a place where backups are stored. The current implementation
|
A datastore refers to a location at which backups are stored. The current
|
||||||
uses a directory inside a standard unix file system (``ext4``, ``xfs``
|
implementation uses a directory inside a standard unix file system (``ext4``,
|
||||||
or ``zfs``) to store the backup data.
|
``xfs`` or ``zfs``) to store the backup data.
|
||||||
|
|
||||||
Datastores are identified by a simple *ID*. You can configure it
|
Datastores are identified by a simple *ID*. You can configure this
|
||||||
when setting up the backup server.
|
when setting up the datastore. The configuration information for datastores
|
||||||
|
is stored in the file ``/etc/proxmox-backup/datastore.cfg``.
|
||||||
|
|
||||||
.. note:: The `File Layout`_ requires the file system to support at least *65538*
|
.. note:: The `File Layout`_ requires the file system to support at least *65538*
|
||||||
subdirectories per directory. That number comes from the 2\ :sup:`16`
|
subdirectories per directory. That number comes from the 2\ :sup:`16`
|
||||||
@ -214,13 +215,19 @@ mounts it on the root directory (default):
|
|||||||
You can use ``disk fs list`` and ``disk zpool list`` to keep track of your
|
You can use ``disk fs list`` and ``disk zpool list`` to keep track of your
|
||||||
filesystems and zpools respectively.
|
filesystems and zpools respectively.
|
||||||
|
|
||||||
If a disk supports S.M.A.R.T. capability, and you have this enabled, you can
|
Proxmox Backup Server uses the package smartmontools. This is a set of tools
|
||||||
|
used to monitor and control the S.M.A.R.T. system for local hard disks. If a
|
||||||
|
disk supports S.M.A.R.T. capability, and you have this enabled, you can
|
||||||
display S.M.A.R.T. attributes from the web interface or by using the command:
|
display S.M.A.R.T. attributes from the web interface or by using the command:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|
||||||
# proxmox-backup-manager disk smart-attributes sdX
|
# proxmox-backup-manager disk smart-attributes sdX
|
||||||
|
|
||||||
|
.. note:: This functionality may also be accessed directly through the use of
|
||||||
|
the ``smartctl`` command, which comes as part of the smartmontools package
|
||||||
|
(see ``man smartctl`` for more details).
|
||||||
|
|
||||||
|
|
||||||
Datastore Configuration
|
Datastore Configuration
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
@ -377,7 +384,8 @@ choose the realm when you add a new user. Possible realms are:
|
|||||||
``/etc/proxmox-backup/shadow.json``.
|
``/etc/proxmox-backup/shadow.json``.
|
||||||
|
|
||||||
After installation, there is a single user ``root@pam``, which
|
After installation, there is a single user ``root@pam``, which
|
||||||
corresponds to the Unix superuser. You can use the
|
corresponds to the Unix superuser. User configuration information is stored in the file
|
||||||
|
``/etc/proxmox-backup/user.cfg``. You can use the
|
||||||
``proxmox-backup-manager`` command line tool to list or manipulate
|
``proxmox-backup-manager`` command line tool to list or manipulate
|
||||||
users:
|
users:
|
||||||
|
|
||||||
@ -486,8 +494,25 @@ following roles exist:
|
|||||||
:align: right
|
:align: right
|
||||||
:alt: Add permissions for user
|
:alt: Add permissions for user
|
||||||
|
|
||||||
You can manage datastore permissions from **Configuration -> Permissions** in
|
Access permission information is stored in ``/etc/proxmox-backup/acl.cfg``. The
|
||||||
the web interface. Likewise, you can use the ``acl`` subcommand to manage and
|
file contains 5 fields, separated using a colon (':') as a delimiter. A typical
|
||||||
|
entry takes the form:
|
||||||
|
|
||||||
|
``acl:1:/datastore:john@pbs:DatastoreBackup``
|
||||||
|
|
||||||
|
The data represented in each field is as follows:
|
||||||
|
|
||||||
|
#. ``acl`` identifier
|
||||||
|
#. A ``1`` or ``0``, representing whether propagation is enabled or disabled,
|
||||||
|
respectively
|
||||||
|
#. The object on which the permission is set. This can be a specific object
|
||||||
|
(single datastore, remote, etc.) or a top level object, which with
|
||||||
|
propagation enabled, represents all children of the object also.
|
||||||
|
#. The user for which the permission is set
|
||||||
|
#. The role being set
|
||||||
|
|
||||||
|
You can manage datastore permissions from **Configuration -> Permissions** in the
|
||||||
|
web interface. Likewise, you can use the ``acl`` subcommand to manage and
|
||||||
monitor user permissions from the command line. For example, the command below
|
monitor user permissions from the command line. For example, the command below
|
||||||
will add the user ``john@pbs`` as a **DatastoreAdmin** for the datastore
|
will add the user ``john@pbs`` as a **DatastoreAdmin** for the datastore
|
||||||
``store1``, located at ``/backup/disk1/store1``:
|
``store1``, located at ``/backup/disk1/store1``:
|
||||||
@ -554,7 +579,8 @@ To get a list of available interfaces, use the following command:
|
|||||||
:alt: Add a network interface
|
:alt: Add a network interface
|
||||||
|
|
||||||
To add a new network interface, use the ``create`` subcommand with the relevant
|
To add a new network interface, use the ``create`` subcommand with the relevant
|
||||||
parameters. The following command shows a template for creating the bond shown
|
parameters. For example, you may want to set up a bond, for the purpose of
|
||||||
|
network redundancy. The following command shows a template for creating the bond shown
|
||||||
in the list above:
|
in the list above:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
@ -596,6 +622,11 @@ is:
|
|||||||
|
|
||||||
# proxmox-backup-manager network reload
|
# proxmox-backup-manager network reload
|
||||||
|
|
||||||
|
.. note:: This command and corresponding GUI button rely on the ``ifreload``
|
||||||
|
command, from the package ``ifupdown2``. This package is included within the
|
||||||
|
Proxmox Backup Server installation, however, you may have to install it yourself,
|
||||||
|
if you have installed Proxmox Backup Server on top of Debian or Proxmox VE.
|
||||||
|
|
||||||
You can also configure DNS settings, from the **DNS** section
|
You can also configure DNS settings, from the **DNS** section
|
||||||
of **Configuration** or by using the ``dns`` subcommand of
|
of **Configuration** or by using the ``dns`` subcommand of
|
||||||
``proxmox-backup-manager``.
|
``proxmox-backup-manager``.
|
||||||
@ -606,7 +637,9 @@ of **Configuration** or by using the ``dns`` subcommand of
|
|||||||
A remote refers to a separate Proxmox Backup Server installation and a user on that
|
A remote refers to a separate Proxmox Backup Server installation and a user on that
|
||||||
installation, from which you can `sync` datastores to a local datastore with a
|
installation, from which you can `sync` datastores to a local datastore with a
|
||||||
`Sync Job`. You can configure remotes in the web interface, under **Configuration
|
`Sync Job`. You can configure remotes in the web interface, under **Configuration
|
||||||
-> Remotes**. Alternatively, you can use the ``remote`` subcommand.
|
-> Remotes**. Alternatively, you can use the ``remote`` subcommand. The
|
||||||
|
configuration information for remotes is stored in the file
|
||||||
|
``/etc/proxmox-backup/remote.cfg``.
|
||||||
|
|
||||||
.. image:: images/screenshots/pbs-gui-remote-add.png
|
.. image:: images/screenshots/pbs-gui-remote-add.png
|
||||||
:align: right
|
:align: right
|
||||||
@ -650,13 +683,16 @@ Sync Jobs
|
|||||||
|
|
||||||
.. image:: images/screenshots/pbs-gui-syncjob-add.png
|
.. image:: images/screenshots/pbs-gui-syncjob-add.png
|
||||||
:align: right
|
:align: right
|
||||||
:alt: Add a remote
|
:alt: Add a Sync Job
|
||||||
|
|
||||||
Sync jobs are configured to pull the contents of a datastore on a **Remote** to a
|
Sync jobs are configured to pull the contents of a datastore on a **Remote** to
|
||||||
local datastore. You can either start a sync job manually on the GUI or
|
a local datastore. You can manage sync jobs under **Configuration -> Sync Jobs**
|
||||||
provide it with a schedule (see :ref:`calendar-events`) to run regularly. You can manage sync jobs
|
in the web interface, or using the ``proxmox-backup-manager sync-job`` command.
|
||||||
under **Configuration -> Sync Jobs** in the web interface, or using the
|
The configuration information for sync jobs is stored at
|
||||||
``proxmox-backup-manager sync-job`` command:
|
``/etc/proxmox-backup/sync.cfg``. To create a new sync job, click the add button
|
||||||
|
in the GUI, or use the ``create`` subcommand. After creating a sync job, you can
|
||||||
|
either start it manually on the GUI or provide it with a schedule (see
|
||||||
|
:ref:`calendar-events`) to run regularly.
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|
||||||
@ -1411,6 +1447,10 @@ After that you should be able to see storage status with:
|
|||||||
Name Type Status Total Used Available %
|
Name Type Status Total Used Available %
|
||||||
store2 pbs active 3905109820 1336687816 2568422004 34.23%
|
store2 pbs active 3905109820 1336687816 2568422004 34.23%
|
||||||
|
|
||||||
|
Having added the PBS datastore to `Proxmox VE`_, you can backup VMs and
|
||||||
|
containers in the same way you would for any other storage device within the
|
||||||
|
environment (see `PVE Admin Guide: Backup and Restore
|
||||||
|
<https://pve.proxmox.com/pve-docs/pve-admin-guide.html#chapter_vzdump>`_.
|
||||||
|
|
||||||
|
|
||||||
.. include:: command-line-tools.rst
|
.. include:: command-line-tools.rst
|
||||||
|
Loading…
x
Reference in New Issue
Block a user