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

[Thomas Lamprecht]

Am 2/13/19 um 10:43 AM schrieb 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
> 


again, not tested...:

> # make
> ...
> possible xref spanning multiple lines in 'pve-storage-cephfs.adoc':
> (line 22): Add our Ceph repository xref:sysadmin_package_repositories_ceph[Ceph
> pve-doc-generator.mk:68: recipe for target 'chapter-pvesm.html' failed


applied, with a fixup merged into this patch (as I do not like to temporarily
break building for such stuff), so you may not pull cleanly in git if you have
this patch on your master branch.

>  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
>  ~~~~~~~~~~~~~
>