[Pkg-ceph-commits] [ceph] 01/03: added upgrade and caveats notes to README.Debian

[Dmitry Smirnov]

This is an automated email from the git hooks/post-receive script.

onlyjob pushed a commit to branch experimental
in repository ceph.

commit 3081b28
Author: Dmitry Smirnov <onlyjob at member.fsf.org>
Date:   Tue Mar 25 10:33:27 2014

    added upgrade and caveats notes to README.Debian
---
 debian/README.Debian | 57 ++++++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 49 insertions(+), 8 deletions(-)

diff --git a/debian/README.Debian b/debian/README.Debian
index 7594799..5b9b4d1 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -1,22 +1,63 @@
-## CephFS is not production quality yet.
-
-----
-
 ## See online installation and setup documentation at
 
     http://ceph.com/docs/master/install/manual-deployment/
 
-----
+-------- -------- --------
+
+## rbdmap caveats
+
+ Rbd kernel driver do not support authentication so the following setting
+ in "/etc/ceph/ceph.conf" may be used to relax client auth. requirements:
+
+    cephx cluster require signatures = true
+    cephx service require signatures = false
+
+-------- -------- --------
+
+## Upgrade procedure (0.72.2 to 0.78):
+
+ * Upgrade.
+ * Restart all OSDs.
+ * Run `ceph osd crush tunables default`.
+ * Restart MONs.
+ * (Restart MDSes).
+
+ Read more about tunables in
+
+    http://ceph.com/docs/master/rados/operations/crush-map/#tunables
+
+ Upgrading all OSDs and setting correct tunables is necessary to avoid the errors like:
+
+    ## rbdmap errors:
+    libceph: mon2 192.168.0.222:6789 socket error on read
+
+ Wrong tunables may produce the following error:
+
+    libceph: mon0 192.168.0.222:6789 socket error on read
+    libceph: mon2 192.168.0.250:6789 feature set mismatch, my 4a042a42 < server's 2004a042a42, missing 20000000000
+
+    ## MDS errors:
+    one or more OSDs do not support TMAP2OMAP; upgrade OSDs before starting MDS (or downgrade MDS)
+
+ See also:
+
+    http://ceph.com/docs/master/install/upgrading-ceph/
+
+-------- -------- --------
+
+## CephFS
+
+ **CephFS is not production quality yet.**
 
 > How to mount CephFS using fuse client from "/etc/fstab"?
 
-Add (and modify) the following sample to "/etc/fstab":
+ Add (and modify) the following sample to "/etc/fstab":
 
     mount.fuse.ceph#conf=/etc/ceph/ceph.conf,id=admin    /mnt/ceph     fuse     _netdev,noatime,allow_other     0    0
 
-This is equivalent of running
+ This is equivalent of running
 
     ceph-fuse /mnt/ceph --id=admin -o noatime,allow_other
 
-as root.
+ as root.
 

-- 
Alioth's hooks/post-receive on /srv/git.debian.org/git/pkg-ceph/ceph.git