tyler/proxmox-backup
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

docs: package repos: drop non-tests for now

Browse Source 
they won't work and thus just confuse people, re-add them once we're
releasing final.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
This commit is contained in:
Thomas Lamprecht 2020-07-08 18:17:52 +02:00
parent 24406ebc0c
commit b2bfb46835
1 changed files with 65 additions and 55 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

90
docs/package-repositories.rst
View File

@ -3,17 +3,16 @@
Debian Package Repositories Debian Package Repositories
--------------------------- ---------------------------
All Debian based systems use APT_ as package All Debian based systems use APT_ as package management tool. The list of
management tool. The list of repositories is defined in repositories is defined in ``/etc/apt/sources.list`` and ``.list`` files found
``/etc/apt/sources.list`` and ``.list`` files found in the in the ``/etc/apt/sources.d/`` directory. Updates can be installed directly
``/etc/apt/sources.d/`` directory. Updates can be installed directly with with the ``apt`` command line tool, or via the GUI.
the ``apt`` command line tool, or via the GUI.
APT_ ``sources.list`` files list one package repository per line, with APT_ ``sources.list`` files list one package repository per line, with the most
the most preferred source listed first. Empty lines are ignored and a preferred source listed first. Empty lines are ignored and a ``#`` character
``#`` character anywhere on a line marks the remainder of that line as a anywhere on a line marks the remainder of that line as a comment. The
comment. The information available from the configured sources is information available from the configured sources is acquired by ``apt
acquired by ``apt update``. update``.
.. code-block:: sources.list .. code-block:: sources.list
:caption: File: ``/etc/apt/sources.list`` :caption: File: ``/etc/apt/sources.list``
@ -27,48 +26,56 @@ acquired by ``apt update``.
.. FIXME for 7.0: change security update suite to bullseye-security .. FIXME for 7.0: change security update suite to bullseye-security
In addition, Proxmox provides three different package repositories for In addition, you need a package repositories from Proxmox to get the backup
the backup server binaries. server updates.
`Proxmox Backup`_ Enterprise Repository During the Proxmox Backup beta phase only one repository (pbstest) will be
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ available. Once released, a Enterprise repository for production use and a
no-subscription repository will be provided.
This is the default, stable, and recommended repository. It is available for .. comment
all `Proxmox Backup`_ subscription users. It contains the most stable packages, `Proxmox Backup`_ Enterprise Repository
and is suitable for production use. The ``pbs-enterprise`` repository is ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
enabled by default:
.. code-block:: sources.list This will be the default, stable, and recommended repository. It is available for
all `Proxmox Backup`_ subscription users. It contains the most stable packages,
and is suitable for production use. The ``pbs-enterprise`` repository is
enabled by default:
.. note:: During the Proxmox Backup beta phase only one repository (pbstest)
will be available.
.. code-block:: sources.list
:caption: File: ``/etc/apt/sources.list.d/pbs-enterprise.list`` :caption: File: ``/etc/apt/sources.list.d/pbs-enterprise.list``
deb https://enterprise.proxmox.com/debian/pbs buster pbs-enterprise deb https://enterprise.proxmox.com/debian/pbs buster pbs-enterprise
To never miss important security fixes, the superuser (``root@pam`` user) is To never miss important security fixes, the superuser (``root@pam`` user) is
notified via email about new packages as soon as they are available. The notified via email about new packages as soon as they are available. The
change-log and details of each package can be viewed in the GUI (if available). change-log and details of each package can be viewed in the GUI (if available).
Please note that you need a valid subscription key to access this Please note that you need a valid subscription key to access this
repository. More information regarding subscription levels and pricing can be repository. More information regarding subscription levels and pricing can be
found at https://www.proxmox.com/en/proxmox-backup/pricing. found at https://www.proxmox.com/en/proxmox-backup/pricing.
.. note:: You can disable this repository by commenting out the above .. note:: You can disable this repository by commenting out the above
line using a `#` (at the start of the line). This prevents error line using a `#` (at the start of the line). This prevents error
messages if you do not have a subscription key. Please configure the messages if you do not have a subscription key. Please configure the
``pbs-no-subscription`` repository in that case. ``pbs-no-subscription`` repository in that case.
`Proxmox Backup`_ No-Subscription Repository `Proxmox Backup`_ No-Subscription Repository
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
As the name suggests, you do not need a subscription key to access As the name suggests, you do not need a subscription key to access
this repository. It can be used for testing and non-production this repository. It can be used for testing and non-production
use. It is not recommended to use it on production servers, because these use. It is not recommended to use it on production servers, because these
packages are not always heavily tested and validated. packages are not always heavily tested and validated.
We recommend to configure this repository in ``/etc/apt/sources.list``. We recommend to configure this repository in ``/etc/apt/sources.list``.
.. code-block:: sources.list .. code-block:: sources.list
:caption: File: ``/etc/apt/sources.list`` :caption: File: ``/etc/apt/sources.list``
deb http://ftp.debian.org/debian buster main contrib deb http://ftp.debian.org/debian buster main contrib
@ -82,21 +89,24 @@ We recommend to configure this repository in ``/etc/apt/sources.list``.
deb http://security.debian.org/debian-security buster/updates main contrib deb http://security.debian.org/debian-security buster/updates main contrib
`Proxmox Backup`_ Test Repository `Proxmox Backup`_ Beta Repository
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Finally, there is a repository called ``pbstest``. This one contains the During the public beta, there is a repository called ``pbstest``. This one
latest packages and is heavily used by developers to test new contains the latest packages and is heavily used by developers to test new
features. features.
.. warning:: the ``pbstest`` repository should (as the name implies) .. .. warning:: the ``pbstest`` repository should (as the name implies)
only be used to test new features or bug fixes. only be used to test new features or bug fixes.
You can configure this using ``/etc/apt/sources.list`` by You can configure this using ``/etc/apt/sources.list`` by adding the following
adding the following line: line:
.. code-block:: sources.list .. code-block:: sources.list
:caption: sources.list entry for ``pbstest`` :caption: sources.list entry for ``pbstest``
deb http://download.proxmox.com/debian/pbs buster pbstest deb http://download.proxmox.com/debian/pbs buster pbstest
If you installed Proxmox Backup Server from the official beta ISO you should
have this repository already configured in
``/etc/apt/sources.list.d/pbstest-beta.list``