[pve-devel] [PATCH docs v2] Fix #2018: CephFS client needs newer binaries

[Alwin Antreich]

To run cephfs client the debian stock packages need to be updated to
luminous to get it running.

This patch adds a section with our Ceph repositories to our package repo
chapter to where the cephfs storage plugin chapter links to.

Signed-off-by: Alwin Antreich <a.antreich at proxmox.com>
---
V1 -> V2:
    Corrections/Suggestions from Wolfgang added
    https://pve.proxmox.com/pipermail/pve-devel/2019-February/035644.html

 pve-package-repos.adoc  | 28 ++++++++++++++++++++++++++++
 pve-storage-cephfs.adoc |  9 +++++++++
 2 files changed, 37 insertions(+)

diff --git a/pve-package-repos.adoc b/pve-package-repos.adoc
index 77c1690..fd88d86 100644
--- a/pve-package-repos.adoc
+++ b/pve-package-repos.adoc
@@ -95,6 +95,31 @@ deb http://download.proxmox.com/debian/pve stretch pvetest
 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-luminous stretch 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-luminous stretch test
+----
+
 
 SecureApt
 ~~~~~~~~~
@@ -215,3 +240,6 @@ upgrade to latest version as soon as possible.
 
 
 endif::wiki[]
+ifdef::manvolnum[]
+include::pve-copyright.adoc[]
+endif::manvolnum[]
diff --git a/pve-storage-cephfs.adoc b/pve-storage-cephfs.adoc
index 96f4991..9207fa7 100644
--- a/pve-storage-cephfs.adoc
+++ b/pve-storage-cephfs.adoc
@@ -18,6 +18,15 @@ configuring a CephFS storage easier. As recent hardware has plenty of CPU power
 and RAM, running storage services and VMs on same node is possible without a
 big performance impact.
 
+To use the CephFS storage plugin you need update the debian stock Ceph client.
+Add our Ceph repository xref:sysadmin_package_repositories_ceph[Ceph
+repository]. Once added, run an `apt update` and `apt dist-upgrade` cycle to
+get the newest packages.
+
+You need to make sure that there is no other Ceph repository configured,
+otherwise the installation will fail or there will be mixed package
+versions on the node, leading to unexpected behavior.
+
 [[storage_cephfs_config]]
 Configuration
 ~~~~~~~~~~~~~
-- 
2.11.0