devstack_custom/tools/xen/README.md

71 lines
2.6 KiB
Markdown
Raw Normal View History

2011-10-27 05:29:08 +00:00
Getting Started With XenServer 5.6 and Devstack
===============================================
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.
2011-10-27 06:11:52 +00:00
Step 1: Install Xenserver
------------------------
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
2011-10-27 05:29:08 +00:00
Here are some sample Xenserver network settings for when you are just
2011-10-27 06:48:43 +00:00
getting started (I use settings like this with a lappy + cheap wifi router):
2011-10-27 05:29:08 +00:00
* XenServer Host IP: 192.168.1.10
* XenServer Netmask: 255.255.255.0
* XenServer Gateway: 192.168.1.1
* XenServer DNS: 192.168.1.1
2011-10-27 06:11:52 +00:00
Step 2: Prepare DOM0
-------------------
2011-10-27 05:29:08 +00:00
At this point, your server 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
2011-10-27 06:11:52 +00:00
chmod 755 prepare_dom0.sh
2011-10-28 21:00:21 +00:00
./prepare_dom0.sh
2011-10-27 05:29:08 +00:00
This script will also clone devstack in /root/devstack
2011-10-27 06:11:52 +00:00
Step 3: Configure your localrc
-----------------------------
2011-10-28 21:00:21 +00:00
Devstack uses a localrc for user-specific configuration. Note that
2011-10-27 06:11:52 +00:00
the XENAPI_PASSWORD must be your dom0 root password.
Of course, use real passwords if this machine is exposed.
2011-10-27 05:29:08 +00:00
cat > /root/devstack/localrc <<EOF
MYSQL_PASSWORD=my_super_secret
SERVICE_TOKEN=my_super_secret
ADMIN_PASSWORD=my_super_secret
RABBIT_PASSWORD=my_super_secret
2011-10-27 06:11:52 +00:00
# This is the password for your guest (for both stack and root users)
GUEST_PASSWORD=my_super_secret
2011-10-27 05:29:08 +00:00
# IMPORTANT: The following must be set to your dom0 root password!
XENAPI_PASSWORD=my_super_secret
2011-10-27 06:11:52 +00:00
# Do not download the usual images yet!
IMAGE_URLS=""
# Explicitly set virt driver here
VIRT_DRIVER=xenserver
# Explicitly set multi-host
MULTI_HOST=1
# Give extra time for boot
ACTIVE_TIMEOUT=45
2011-10-27 05:29:08 +00:00
EOF
2011-10-27 06:11:52 +00:00
Step 4: Run ./build_domU.sh
--------------------------
2011-10-27 05:29:08 +00:00
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
2011-10-27 05:34:55 +00:00
* Creates and installs a OpenStack all-in-one domU in an HA-FlatDHCP configuration
2011-10-27 06:11:52 +00:00
* A script to create a multi-domU (ie. head node separated from compute) configuration is coming soon!
Step 5: Do cloudy stuff!
--------------------------
2011-10-28 21:00:21 +00:00
* Play with horizon
2011-10-27 06:11:52 +00:00
* Play with the CLI
* Log bugs to devstack and core projects, and submit fixes!