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

Alwin Antreich a.antreich at proxmox.com
Wed Feb 13 10:43:28 CET 2019

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

 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.
+{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
+.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
@@ -215,3 +240,6 @@ upgrade to latest version as soon as possible.
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.

More information about the pve-devel mailing list