diff --git a/README.md b/README.md index e311bb805b..90becf830c 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,10 @@ Read more at http://devstack.org (built from the gh-pages branch) IMPORTANT: Be sure to carefully read stack.sh and any other scripts you execute before you run them, as they install software and may alter your networking configuration. We strongly recommend that you run stack.sh in a clean and disposable vm when you are first getting started. +# Devstack on Xenserver + +If you would like to use Xenserver as the hypervisor, please refer to the instructions in ./tools/xen/README.md. + # Versions The devstack master branch generally points to trunk versions of OpenStack components. For older, stable versions, look for branches named stable/[release]. For example, you can do the following to create a diablo OpenStack cloud: diff --git a/tools/xen/README.md b/tools/xen/README.md index a3398a7879..d487a99675 100644 --- a/tools/xen/README.md +++ b/tools/xen/README.md @@ -4,12 +4,19 @@ The purpose of the code in this directory it to help developers bootstrap a XenServer 5.6 + Openstack development environment. This file gives some pointers on how to get started. +Xenserver is a Type 1 hypervisor, so it needs to be installed on bare metal. +The Openstack services are configured to run within a "privileged" virtual +machine on the Xenserver host (called OS domU). The VM uses the XAPI toolstack +to communicate with the host. + Step 1: Install Xenserver ------------------------ -Install XenServer 5.6 on a clean box. You can get XenServer by signing +Install XenServer 5.6+ on a clean box. You can get XenServer by signing up for an account on citrix.com, and then visiting: https://www.citrix.com/English/ss/downloads/details.asp?downloadId=2311504&productId=683148 +For details on installation, see: http://wiki.openstack.org/XenServer/Install + Here are some sample Xenserver network settings for when you are just getting started (I use settings like this with a lappy + cheap wifi router): @@ -18,16 +25,25 @@ getting started (I use settings like this with a lappy + cheap wifi router): * XenServer Gateway: 192.168.1.1 * XenServer DNS: 192.168.1.1 +Note: +------ +It is advisable (and necessary if you are using Xenserver 6.0, due to space +limitations), to create the above mentioned OS domU, on a separate dev machine. +To do this, you will need to run Steps 2 on the dev machine (if required) as +well as the Xenserver host. Steps 3 and 4 should be run on the dev machine. +This process requires you to be root on the dev machine. + Step 2: Prepare DOM0 ------------------- -At this point, your server is missing some critical software that you will +At this point, your host is missing some critical software that you will need to run devstack (like git). Do this to install required software: - wget --no-check-certificate https://github.com/cloudbuilders/devstack/raw/xen/tools/xen/prepare_dom0.sh + wget --no-check-certificate https://raw.github.com/openstack-dev/devstack/master/tools/xen/prepare_dom0.sh chmod 755 prepare_dom0.sh ./prepare_dom0.sh -This script will also clone devstack in /root/devstack +This step will also clone devstack in $DEVSTACKSRCROOT/devstack. +$DEVSTACKSRCROOT=/root by default. Step 3: Configure your localrc ----------------------------- @@ -35,7 +51,7 @@ Devstack uses a localrc for user-specific configuration. Note that the XENAPI_PASSWORD must be your dom0 root password. Of course, use real passwords if this machine is exposed. - cat > /root/devstack/localrc < $DEVSTACKSRCROOT/devstack/localrc <