make dinstall: skip mediawiki deb for now

[pve-docs.git] / pve-package-repos.adoc

diff --git a/pve-package-repos.adoc b/pve-package-repos.adoc
index a9b428d2d90d421c2d83f3b685e09dafe51ca6a8..06d1b2fb022a46f51a4e846d3b4651cff6923504 100644 (file)
--- a/pve-package-repos.adoc
+++ b/pve-package-repos.adoc
@@ -1,26 +1,30 @@
+[[sysadmin_package_repositories]]

 Package Repositories
 --------------------
 Package Repositories
 --------------------

-include::attributes.txt[]
+ifdef::wiki[]
+:pve-toplevel:
+endif::wiki[]

 
 All Debian based systems use
 http://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as package
 management tool. The list of repositories is defined in
 
 All Debian based systems use
 http://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as package
 management tool. The list of repositories is defined in

-'/etc/apt/sources.list' and '.list' files found inside
-'/etc/apt/sources.d/'. Updates can be installed directly using
-'apt-get', or via the GUI.
+`/etc/apt/sources.list` and `.list` files found inside
+`/etc/apt/sources.d/`. Updates can be installed directly using
+`apt-get`, 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 preferred source listed first. Empty lines are ignored, and a
 the most preferred source listed first. Empty lines are ignored, and a

-'#' character anywhere on a line marks the remainder of that line as a
+`#` character anywhere on a line marks the remainder of that line as a

 comment. The information available from the configured sources is
 comment. The information available from the configured sources is

-acquired by 'apt-get update'.
+acquired by `apt-get update`.

 
 

-.File '/etc/apt/sources.list'
+.File `/etc/apt/sources.list`

 ----
 ----

-deb http://ftp.debian.org/debian jessie main contrib
+deb http://ftp.debian.org/debian buster main contrib
+deb http://ftp.debian.org/debian buster-updates main contrib

 
 # security updates
 
 # security updates

-deb http://security.debian.org jessie/updates main contrib
+deb http://security.debian.org buster/updates main contrib

 ----
 
 In addition, {pve} provides three different package repositories.
 ----
 
 In addition, {pve} provides three different package repositories.


@@ -33,9 +37,9 @@ all {pve} subscription users. It contains the most stable packages,
 and is suitable for production use. The `pve-enterprise` repository is
 enabled by default:
 
 and is suitable for production use. The `pve-enterprise` repository is
 enabled by default:
 

-.File '/etc/apt/sources.list.d/pve-enterprise.list'
+.File `/etc/apt/sources.list.d/pve-enterprise.list`

 ----
 ----

-deb https://enterprise.proxmox.com/debian jessie pve-enterprise
+deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise

 ----
 
 As soon as updates are available, the `root@pam` user is notified via
 ----
 
 As soon as updates are available, the `root@pam` user is notified via


@@ -43,12 +47,12 @@ email about the available new packages. On the GUI, the change-log of
 each package can be viewed (if available), showing all details of the
 update. So you will never miss important security fixes.
 
 each package can be viewed (if available), showing all details of the
 update. So you will never miss important security fixes.
 

-Please note that and you need a valid subscription key to access this
+Please note that you need a valid subscription key to access this

 repository. We offer different support levels, and you can find further
 repository. We offer different support levels, and you can find further

-details at http://www.proxmox.com/en/proxmox-ve/pricing.
+details at https://www.proxmox.com/en/proxmox-ve/pricing.

 
 NOTE: You can disable this repository by commenting out the above line
 
 NOTE: You can disable this repository by commenting out the above line

-using a '#' (at the start of the line). This prevents error messages
+using a `#` (at the start of the line). This prevents error messages

 if you do not have a subscription key. Please configure the
 `pve-no-subscription` repository in that case.
 
 if you do not have a subscription key. Please configure the
 `pve-no-subscription` repository in that case.
 


@@ -61,18 +65,19 @@ this repository. It can be used for testing and non-production
 use. Its not recommended to run on production servers, as these
 packages are not always heavily tested and validated.
 
 use. Its not recommended to run on production servers, as these
 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`.

 
 

-.File '/etc/apt/sources.list'
+.File `/etc/apt/sources.list`

 ----
 ----

-deb http://ftp.debian.org/debian jessie main contrib
+deb http://ftp.debian.org/debian buster main contrib
+deb http://ftp.debian.org/debian buster-updates main contrib

 
 # PVE pve-no-subscription repository provided by proxmox.com,
 # NOT recommended for production use
 
 # PVE pve-no-subscription repository provided by proxmox.com,
 # NOT recommended for production use

-deb http://download.proxmox.com/debian jessie pve-no-subscription
+deb http://download.proxmox.com/debian/pve buster pve-no-subscription

 
 # security updates
 
 # security updates

-deb http://security.debian.org jessie/updates main contrib
+deb http://security.debian.org buster/updates main contrib

 ----
 
 
 ----
 
 


@@ -82,21 +87,57 @@ deb http://security.debian.org jessie/updates main contrib
 Finally, there is a repository called `pvetest`. This one contains the
 latest packages and is heavily used by developers to test new
 features. As usual, you can configure this using
 Finally, there is a repository called `pvetest`. This one contains the
 latest packages and is heavily used by developers to test new
 features. As usual, you can configure this using

-'/etc/apt/sources.list' by adding the following line:
+`/etc/apt/sources.list` by adding the following line:

 
 .sources.list entry for `pvetest`
 ----
 
 .sources.list entry for `pvetest`
 ----

-deb http://download.proxmox.com/debian jessie pvetest
+deb http://download.proxmox.com/debian/pve buster pvetest

 ----
 
 WARNING: the `pvetest` repository should (as the name implies) only be used
 for testing new features or bug fixes.
 
 ----
 
 WARNING: the `pvetest` repository should (as the name implies) only be used
 for testing new features or bug fixes.
 

+[[sysadmin_package_repositories_ceph]]
+{pve} Ceph Repository
+~~~~~~~~~~~~~~~~~~~~~
+
+This is {pve}'s main Ceph repository and holds the Ceph packages for
+production use. You can also use this repository to update only the Ceph
+client.
+
+.File `/etc/apt/sources.list.d/ceph.list`
+----
+deb http://download.proxmox.com/debian/ceph-nautilus buster main
+----
+
+
+{pve} Ceph Testing Repository
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This Ceph repository contains the Ceph packages before they are moved into the
+main repository and is used to test new Ceph release on {pve}.
+
+.File `/etc/apt/sources.list.d/ceph.list`
+----
+deb http://download.proxmox.com/debian/ceph-nautilus buster test
+----
+
+{pve} Ceph Luminous Repository For Upgrade
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This is a build of tje Ceph Luminous release for {pve} 6.0, this can be used to
+upgrade a {pve} cluster with Ceph Luminous deployed first to our 6.0 release,
+based on Debian Buster, and only afterwards upgrade the Ceph on it's own.
+
+.File `/etc/apt/sources.list.d/ceph.list`
+----
+deb http://download.proxmox.com/debian/ceph-luminous buster main
+----

 
 SecureApt
 ~~~~~~~~~
 
 
 SecureApt
 ~~~~~~~~~
 

-We use GnuPG to sign the 'Release' files inside those repositories,
+We use GnuPG to sign the `Release` files inside those repositories,

 and APT uses that signatures to verify that all packages are from a
 trusted source.
 
 and APT uses that signatures to verify that all packages are from a
 trusted source.
 


@@ -104,31 +145,72 @@ The key used for verification is already installed if you install from
 our installation CD. If you install by other means, you can manually
 download the key with:
 
 our installation CD. If you install by other means, you can manually
 download the key with:
 

- # wget http://download.proxmox.com/debian/key.asc
+ # wget http://download.proxmox.com/debian/proxmox-ve-release-6.x.gpg -O /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg

 
 

-Please verify the fingerprint afterwards:
+Please verify the checksum afterwards:

 
 ----
 
 ----

-# gpg --with-fingerprint key.asc
-pub  1024D/9887F95A 2008-10-28 Proxmox Release Key <proxmox-release@proxmox.com>
-      Key fingerprint = BE25 7BAA 5D40 6D01 157D  323E C23A C7F4 9887 F95A
-sub  2048g/A87A1B00 2008-10-28
+# sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
+acca6f416917e8e11490a08a1e2842d500b3a5d9f322c6319db0927b2901c3eae23cfb5cd5df6facf2b57399d3cfa52ad7769ebdd75d9b204549ca147da52626 /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg

 ----
 
 ----
 

-If this shows the exact same fingerprint, you can add the key to the
-list of trusted APT keys:
+or

 
 

- # apt-key add key.asc
+----
+# md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
+f3f6c5a3a67baf38ad178e5ff1ee270c /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
+----

 
 
 ifdef::wiki[]
 
 // include note about older releases, but only for wiki
 
 
 
 ifdef::wiki[]
 
 // include note about older releases, but only for wiki
 

+
+{pve} 5.x Repositories
+~~~~~~~~~~~~~~~~~~~~~~
+
+{pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release
+is out of date, and you should update your installation.
+Nevertheless, we still provide access to those repositories at our download
+servers.
+
+[width="100%",cols="<d,3m",options="header"]
+|===========================================================
+|Repository                 | sources.list entry
+|{pve} 5.x Enterprise       |
+deb https://enterprise.proxmox.com/debian stretch pve-enterprise
+|{pve} 5.x No-Subscription  |
+deb http://download.proxmox.com/debian stretch pve-no-subscription
+|{pve} 5.x Test             |
+deb http://download.proxmox.com/debian stretch pvetest
+|===========================================================
+
+
+{pve} 4.x Repositories
+~~~~~~~~~~~~~~~~~~~~~~
+
+{pve} 4.x is based on Debian 8.x (``jessie''). Please note that this
+release is out of date, and you should update your
+installation. Nevertheless, we still provide access to those
+repositories at our download servers.
+
+[width="100%",cols="<d,3m",options="header"]
+|===========================================================
+|Repository                 | sources.list entry
+|{pve} 4.x Enterprise       |
+deb https://enterprise.proxmox.com/debian jessie pve-enterprise
+|{pve} 4.x No-Subscription  |
+deb http://download.proxmox.com/debian jessie pve-no-subscription
+|{pve} 4.x Test             |
+deb http://download.proxmox.com/debian jessie pvetest
+|===========================================================
+
+

 {pve} 3.x Repositories
 ~~~~~~~~~~~~~~~~~~~~~~
 
 {pve} 3.x Repositories
 ~~~~~~~~~~~~~~~~~~~~~~
 

-{pve} 3.x is based on Debian 7.x ('wheezy'). Please note that this
+{pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this

 release is out of date, and you should update your
 installation. Nevertheless, we still provide access to those
 repositories at our download servers.
 release is out of date, and you should update your
 installation. Nevertheless, we still provide access to those
 repositories at our download servers.


@@ -144,17 +226,15 @@ deb http://download.proxmox.com/debian wheezy pve-no-subscription
 deb http://download.proxmox.com/debian wheezy pvetest
 |===========================================================
 
 deb http://download.proxmox.com/debian wheezy pvetest
 |===========================================================
 

-NOTE: Apt 'sources.list' configuration files are basically the same as
-in newer 4.x versions - just replace 'jessie' with 'wheezy'.

 
 

-Outdated: 'stable' Repository 'pve'
+Outdated: `stable` Repository `pve`

 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This repository is a leftover to easy the update to 3.1. It will not
 get any updates after the release of 3.1. Therefore you need to remove
 this repository after you upgraded to 3.1.
 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This repository is a leftover to easy the update to 3.1. It will not
 get any updates after the release of 3.1. Therefore you need to remove
 this repository after you upgraded to 3.1.
 

-.File '/etc/apt/sources.list'
+.File `/etc/apt/sources.list`

 ----
 deb http://ftp.debian.org/debian wheezy main contrib
 
 ----
 deb http://ftp.debian.org/debian wheezy main contrib
 


@@ -169,11 +249,11 @@ deb http://security.debian.org/ wheezy/updates main contrib
 Outdated: {pve} 2.x Repositories
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Outdated: {pve} 2.x Repositories
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

-{pve} 2.x is based on Debian 6.0 ('squeeze') and outdated. Please
+{pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please

 upgrade to latest version as soon as possible. In order to use the
 upgrade to latest version as soon as possible. In order to use the

-stable 'pve' 2.x repository, check your sources.list:
+stable `pve` 2.x repository, check your sources.list:

 
 

-.File '/etc/apt/sources.list'
+.File `/etc/apt/sources.list`

 ----
 deb http://ftp.debian.org/debian squeeze main contrib
 
 ----
 deb http://ftp.debian.org/debian squeeze main contrib
 


@@ -188,8 +268,11 @@ deb http://security.debian.org/ squeeze/updates main contrib
 Outdated: {pve} VE 1.x Repositories
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Outdated: {pve} VE 1.x Repositories
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

-{pve} 1.x is based on Debian 5.0 (Lenny) and very outdated. Please
+{pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please

 upgrade to latest version as soon as possible.
 
 
 endif::wiki[]
 upgrade to latest version as soon as possible.
 
 
 endif::wiki[]

+ifdef::manvolnum[]
+include::pve-copyright.adoc[]
+endif::manvolnum[]