From patchwork Wed Aug 8 21:51:10 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Wido den Hollander X-Patchwork-Id: 1298021 Return-Path: X-Original-To: patchwork-ceph-devel@patchwork.kernel.org Delivered-To: patchwork-process-083081@patchwork2.kernel.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by patchwork2.kernel.org (Postfix) with ESMTP id E5656DF223 for ; Wed, 8 Aug 2012 21:51:23 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751681Ab2HHVvV (ORCPT ); Wed, 8 Aug 2012 17:51:21 -0400 Received: from smtp01.mail.pcextreme.nl ([109.72.87.137]:44650 "EHLO smtp01.mail.pcextreme.nl" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751639Ab2HHVvU (ORCPT ); Wed, 8 Aug 2012 17:51:20 -0400 Received: from amd.ceph.widodh.nl (amd.ceph.widodh.nl [31.25.100.162]) by smtp01.mail.pcextreme.nl (Postfix) with ESMTPA id A68E17616B; Wed, 8 Aug 2012 23:51:17 +0200 (CEST) From: Wido den Hollander To: ceph-devel@vger.kernel.org Cc: Wido den Hollander Subject: [PATCH] docs: Add CloudStack documentation Date: Wed, 8 Aug 2012 23:51:10 +0200 Message-Id: <1344462671-21848-1-git-send-email-wido@widodh.nl> X-Mailer: git-send-email 1.7.9.5 Sender: ceph-devel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: ceph-devel@vger.kernel.org The basic documentation about how you can use RBD with CloudStack Signed-off-by: Wido den Hollander --- 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 libvirt RBD and OpenStack - + RBD and CloudStack