openstack/devstack
Code Issues Proposed changes

XenServer new install: modify README

Browse Source 
Modify the README to specify the new steps to install Openstack on
XenServer. Specifically, the new install will use a network-installed
Ubuntu VM on the XenServer host and install the OpenStack services on it.
This eliminates the need for the dev machine (which was required
with XenServer 6.0 and above).

Change-Id: I5f86aa7929754e04ec4a959053c3fb871e3cda76
This commit is contained in:
Renuka Apte 2012-04-05 17:18:27 -07:00 committed by Dean Troyer
parent 0af143b34e
commit c0ae316430
1 changed files with 19 additions and 49 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

68
tools/xen/README.md
View File

@ -1,7 +1,7 @@
Getting Started With XenServer 5.6 and Devstack Getting Started With XenServer 5.6 and Devstack
=============================================== ===============================================
The purpose of the code in this directory it to help developers bootstrap The purpose of the code in this directory it to help developers bootstrap
a XenServer 5.6 + Openstack development environment. This file gives a XenServer 5.6 (or greater) + Openstack development environment. This file gives
some pointers on how to get started. some pointers on how to get started.
Xenserver is a Type 1 hypervisor, so it needs to be installed on bare metal. Xenserver is a Type 1 hypervisor, so it needs to be installed on bare metal.
@ -25,36 +25,25 @@ getting started (I use settings like this with a lappy + cheap wifi router):
* XenServer Gateway: 192.168.1.1 * XenServer Gateway: 192.168.1.1
* XenServer DNS: 192.168.1.1 * XenServer DNS: 192.168.1.1
Note: Step 2: Download devstack
------ --------------------------
It is advisable (and necessary if you are using Xenserver 6.0, due to space On your XenServer host, run the following commands as root:
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 wget --no-check-certificate https://github.com/openstack-dev/devstack/zipball/master
------------------- unzip -o master -d ./devstack
At this point, your host is missing some critical software that you will cd devstack/*/
need to run devstack (like git). Do this to install required software:
wget --no-check-certificate https://raw.github.com/openstack-dev/devstack/master/tools/xen/prepare_dom0.sh Step 3: Configure your localrc inside the devstack directory
chmod 755 prepare_dom0.sh ------------------------------------------------------------
./prepare_dom0.sh
This step will also clone devstack in $DEVSTACKSRCROOT/devstack.
$DEVSTACKSRCROOT=/root by default.
Step 3: Configure your localrc
-----------------------------
Devstack uses a localrc for user-specific configuration. Note that Devstack uses a localrc for user-specific configuration. Note that
the XENAPI_PASSWORD must be your dom0 root password. the XENAPI_PASSWORD must be your dom0 root password.
Of course, use real passwords if this machine is exposed. Of course, use real passwords if this machine is exposed.
cat > $DEVSTACKSRCROOT/devstack/localrc <<EOF cat > ./localrc <<EOF
MYSQL_PASSWORD=my_super_secret MYSQL_PASSWORD=my_super_secret
SERVICE_TOKEN=my_super_secret SERVICE_TOKEN=my_super_secret
ADMIN_PASSWORD=my_super_secret ADMIN_PASSWORD=my_super_secret
SERVICE_PASSWORD=$ADMIN_PASSWORD
RABBIT_PASSWORD=my_super_secret RABBIT_PASSWORD=my_super_secret
# This is the password for your guest (for both stack and root users) # This is the password for your guest (for both stack and root users)
GUEST_PASSWORD=my_super_secret GUEST_PASSWORD=my_super_secret
@ -72,37 +61,18 @@ Of course, use real passwords if this machine is exposed.
HOST_IP_IFACE=ethX HOST_IP_IFACE=ethX
EOF EOF
Step 4: Run ./build_xva.sh Step 4: Run ./install_os_domU.sh from the tools/xen directory
-------------------------- -------------------------------------------------------------
This script prepares your nova xva image. If you run this on a different machine, cd tools/xen
copy the resulting xva file to tools/xen/xvas/[GUEST_NAME].xva ./install_os_domU.sh
(by default tools/xen/xvas/ALLINONE.xva) on the Xenserver host.
cd $DEVSTACKSRCROOT/devstack/tools/xen Once this script finishes executing, log into the VM (openstack domU)
./build_xva.sh that it installed and tail the run.sh.log file. You will need to wait
until it run.sh has finished executing.
You will also need to copy your localrc to the Xenserver host.
Step 5: Run ./build_domU.sh Step 5: Do cloudy stuff!
--------------------------
This script does a lot of stuff, it is probably best to read it in its entirety.
But in a nutshell, it performs the following:
* Configures bridges and vlans for public, private, and management nets
* Creates and installs a OpenStack all-in-one domU in an HA-FlatDHCP configuration
* A script to create a multi-domU (ie. head node separated from compute) configuration is coming soon!
cd $DEVSTACKSRCROOT/devstack/tools/xen
./build_domU.sh
Step 6: Do cloudy stuff!
-------------------------- --------------------------
* Play with horizon * Play with horizon
* Play with the CLI * Play with the CLI
* Log bugs to devstack and core projects, and submit fixes! * Log bugs to devstack and core projects, and submit fixes!
Ubuntu 11.10 VM on Xenserver
----------------------------
Run ./scripts/xenoneirictemplate.sh on your Xenserver host. This creates a
template to be able to install a Ubuntu Oneiric (11.10) virtual machine.
Once the template is created, follow the wizard to complete the network install.