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:
Dylan Whyte 2020-09-18 15:32:02 +02:00 committed by Dietmar Maurer
parent fe233f3b3d
commit 9d3f183ba9

View File

@ -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