docs: Improve CloudStack documentation.

Add a section about creating a CephX user for CloudStack.

diff --git a/doc/rbd/rbd-cloudstack.rst b/doc/rbd/rbd-cloudstack.rst
index 49a903a5a63feb635a34202d90b0308f09210455..c39bcc359f1fe0f7b132ffed8f9fd7d7b95f19c7 100644 (file)
--- a/doc/rbd/rbd-cloudstack.rst
+++ b/doc/rbd/rbd-cloudstack.rst
@@ -72,6 +72,18 @@ See `Create a Pool`_ for details on specifying the number of placement groups
 for your pools, and `Placement Groups`_ for details on the number of placement
 groups you should set for your pools.
 
+Create a CephX user
+===================
+
+To access the Ceph cluster we require a CephX user which has the correct credentials
+to access the ``cloudstack`` pool we just created.
+
+Although we could use ``client.admin`` for this, it's recommended to create a user
+with only access to the ``cloudstack`` pool.
+
+  ceph auth get-or-create client.cloudstack mon 'allow r' osd 'allow allow rwx pool=cloudstack'
+
+Use the information returned by the command in the next step when adding the Primary Storage.
 
 Add Primary Storage
 ===================
@@ -89,7 +101,7 @@ include:
 #. Follow the CloudStack instructions.
 
    - For **Protocol**, select ``RBD``.
-   - Add cluster information (cephx is supported).
+   - Add cluster information (cephx is supported). Note: Do not include the ``client.`` part of the user.
    - Add ``rbd`` as a tag.
 
 
@@ -108,8 +120,6 @@ Limitations
 ===========
 
 - CloudStack will only bind to one monitor (You can however create a Round Robin DNS record over multiple monitors)
-- CloudStack does not support cloning snapshots.
-- You still need a (small) NFS based Primary Storage for the SystemVMs
 - You may need to compile ``libvirt`` to use version 0.9.13 with Ubuntu.