[pve-devel] [PATCH docs] Fix #2015: How to update ceph client packages only

[Alwin Antreich]

Signed-off-by: Alwin Antreich <a.antreich at proxmox.com>
---
 pve-storage-cephfs.adoc |  2 ++
 pveceph.adoc            | 19 +++++++++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/pve-storage-cephfs.adoc b/pve-storage-cephfs.adoc
index 5111ad1..3d495fc 100644
--- a/pve-storage-cephfs.adoc
+++ b/pve-storage-cephfs.adoc
@@ -18,6 +18,8 @@ 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 you need update the Debian stock Ceph client. For this see xref:pve_ceph_update_client_only[Update Ceph client packages only].
+
 [[storage_cephfs_config]]
 Configuration
 ~~~~~~~~~~~~~
diff --git a/pveceph.adoc b/pveceph.adoc
index 68399ad..48901aa 100644
--- a/pveceph.adoc
+++ b/pveceph.adoc
@@ -106,6 +106,25 @@ pveceph install
 This sets up an `apt` package repository in
 `/etc/apt/sources.list.d/ceph.list` and installs the required software.
 
+[[pve_ceph_update_client_only]]
+Update Ceph client packages only
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+If you would like to only update the default shipped ceph client, you can add
+Proxmox's Ceph repository by hand and run an `apt update`, followed by an `apt
+dist-upgrade` to get the latest supported Ceph client packages from Proxmox.
+
+Open a terminal on the respective Proxmox VE node and run the following line as
+root. This will add Proxmox's Ceph repository.
+
+[source,bash]
+----
+echo deb http://download.proxmox.com/debian/ceph-luminous stretch main > /etc/apt/sources.list.d/ceph.list
+----
+
+You need to make sure that there is no other Ceph repository configured,
+otherwise the installation will fail or there will be different package
+versions on the node, leading to unexpected behavior.
+
 
 Creating initial Ceph configuration
 -----------------------------------
-- 
2.11.0