All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH] docs: Add CloudStack documentation
@ 2012-08-08 21:51 Wido den Hollander
  2012-09-04 23:49 ` Sage Weil
  2012-09-05 15:21 ` Calvin Morrow
  0 siblings, 2 replies; 10+ messages in thread
From: Wido den Hollander @ 2012-08-08 21:51 UTC (permalink / raw)
  To: ceph-devel; +Cc: Wido den Hollander

The basic documentation about how you can use RBD with CloudStack

Signed-off-by: Wido den Hollander <wido@widodh.nl>
---
 doc/rbd/rbd-cloudstack.rst |   49 ++++++++++++++++++++++++++++++++++++++++++++
 doc/rbd/rbd.rst            |    2 +-
 2 files changed, 50 insertions(+), 1 deletion(-)
 create mode 100644 doc/rbd/rbd-cloudstack.rst

diff --git a/doc/rbd/rbd-cloudstack.rst b/doc/rbd/rbd-cloudstack.rst
new file mode 100644
index 0000000..04e1a7c
--- /dev/null
+++ b/doc/rbd/rbd-cloudstack.rst
@@ -0,0 +1,49 @@
+===================
+ RBD and Apache CloudStack
+===================
+You can use RBD to run instances on in Apache CloudStack.
+
+This can be done by adding a RBD pool as Primary Storage.
+
+There are a couple of prerequisites:
+* You need to CloudStack 4.0 or higher
+* Qemu on the Hypervisor has to be compiled with RBD enabled
+* The libvirt version on the Hypervisor has to be at least 0.10 with RBD enabled
+
+Make sure you meet this requirements before installing the CloudStack Agent on the Hypervisor(s)!
+
+.. important:: To use RBD with CloudStack, you must have a running Ceph cluster!
+
+Limitations
+-------------
+Running instances from RBD has a couple of limitations:
+
+* An additional NFS Primary Storage pool is required for running System VM's
+* Snapshotting RBD volumes is not possible (at this moment)
+* Only one monitor can be configured
+
+Add Hypervisor
+-------------
+Please follow the official CloudStack documentation how to do this.
+
+There is no special way of adding a Hypervisor when using RBD, nor is any configuration needed on the hypervisor.
+
+Add RBD Primary Storage
+-------------
+Once the hypervisor has been added, log on to the CloudStack UI.
+
+* Infrastructure 
+* Primary Storage
+* "Add Primary Storage"
+* Select "Protocol" RBD
+* Fill in your cluster information (cephx is supported)
+* Optionally add the tag 'rbd'
+
+Now you should be able to deploy instances on RBD.
+
+RBD Disk Offering
+-------------
+Create a special "Disk Offering" which needs to match the tag 'rbd' so you can make sure the StoragePoolAllocator
+chooses the RBD pool when searching for a suiteable storage pool.
+
+Since there is also a NFS storage pool it's possible that instances get deployed on NFS instead of RBD.
diff --git a/doc/rbd/rbd.rst b/doc/rbd/rbd.rst
index af1682f..6fd1999 100644
--- a/doc/rbd/rbd.rst
+++ b/doc/rbd/rbd.rst
@@ -31,7 +31,7 @@ the Ceph FS filesystem, and RADOS block devices simultaneously.
 	QEMU and RBD <qemu-rbd>
 	libvirt <libvirt>
 	RBD and OpenStack <rbd-openstack>
-	
+	RBD and CloudStack <rbd-cloudstack>
 	
 	
 	
-- 
1.7.9.5


^ permalink raw reply related	[flat|nested] 10+ messages in thread

end of thread, other threads:[~2012-09-05 22:52 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-08-08 21:51 [PATCH] docs: Add CloudStack documentation Wido den Hollander
2012-09-04 23:49 ` Sage Weil
2012-09-05 15:21 ` Calvin Morrow
2012-09-05 15:28   ` Wido den Hollander
2012-09-05 15:42     ` Sage Weil
2012-09-05 16:14     ` Tommi Virtanen
2012-09-05 17:05       ` Wido den Hollander
2012-09-05 18:22         ` Tommi Virtanen
2012-09-05 22:39           ` Wido den Hollander
2012-09-05 22:52             ` Tommi Virtanen

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.