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
... | ... |
@@ -1,7 +1,7 @@ |
1 | 1 |
Getting Started With XenServer 5.6 and Devstack |
2 | 2 |
=============================================== |
3 | 3 |
The purpose of the code in this directory it to help developers bootstrap |
4 |
-a XenServer 5.6 + Openstack development environment. This file gives |
|
4 |
+a XenServer 5.6 (or greater) + Openstack development environment. This file gives |
|
5 | 5 |
some pointers on how to get started. |
6 | 6 |
|
7 | 7 |
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): |
25 | 25 |
* XenServer Gateway: 192.168.1.1 |
26 | 26 |
* XenServer DNS: 192.168.1.1 |
27 | 27 |
|
28 |
-Note: |
|
29 |
-It is advisable (and necessary if you are using Xenserver 6.0, due to space |
|
30 |
-limitations), to create the above mentioned OS domU, on a separate dev machine. |
|
31 |
-To do this, you will need to run Steps 2 on the dev machine (if required) as |
|
32 |
-well as the Xenserver host. Steps 3 and 4 should be run on the dev machine. |
|
33 |
-This process requires you to be root on the dev machine. |
|
34 |
- |
|
35 |
-Step 2: Prepare DOM0 |
|
36 |
-At this point, your host is missing some critical software that you will |
|
37 |
-need to run devstack (like git). Do this to install required software: |
|
38 |
- |
|
39 |
- wget --no-check-certificate https://raw.github.com/openstack-dev/devstack/master/tools/xen/prepare_dom0.sh |
|
40 |
- chmod 755 prepare_dom0.sh |
|
41 |
- ./prepare_dom0.sh |
|
28 |
+Step 2: Download devstack |
|
29 |
+-------------------------- |
|
30 |
+On your XenServer host, run the following commands as root: |
|
42 | 31 |
|
43 |
-This step will also clone devstack in $DEVSTACKSRCROOT/devstack. |
|
44 |
-$DEVSTACKSRCROOT=/root by default. |
|
32 |
+wget --no-check-certificate https://github.com/openstack-dev/devstack/zipball/master |
|
33 |
+unzip -o master -d ./devstack |
|
34 |
+cd devstack/*/ |
|
45 | 35 |
|
46 |
-Step 3: Configure your localrc |
|
36 |
+Step 3: Configure your localrc inside the devstack directory |
|
37 |
+------------------------------------------------------------ |
|
47 | 38 |
Devstack uses a localrc for user-specific configuration. Note that |
48 | 39 |
the XENAPI_PASSWORD must be your dom0 root password. |
49 | 40 |
Of course, use real passwords if this machine is exposed. |
50 | 41 |
|
51 |
- cat > $DEVSTACKSRCROOT/devstack/localrc <<EOF |
|
42 |
+ cat > ./localrc <<EOF |
|
52 | 43 |
MYSQL_PASSWORD=my_super_secret |
53 | 44 |
SERVICE_TOKEN=my_super_secret |
54 | 45 |
ADMIN_PASSWORD=my_super_secret |
46 |
+ SERVICE_PASSWORD=$ADMIN_PASSWORD |
|
55 | 47 |
RABBIT_PASSWORD=my_super_secret |
56 | 48 |
# This is the password for your guest (for both stack and root users) |
57 | 49 |
GUEST_PASSWORD=my_super_secret |
... | ... |
@@ -72,37 +61,18 @@ Of course, use real passwords if this machine is exposed. |
72 | 72 |
HOST_IP_IFACE=ethX |
73 | 73 |
EOF |
74 | 74 |
|
75 |
-Step 4: Run ./build_xva.sh |
|
76 |
-This script prepares your nova xva image. If you run this on a different machine, |
|
77 |
-copy the resulting xva file to tools/xen/xvas/[GUEST_NAME].xva |
|
78 |
-(by default tools/xen/xvas/ALLINONE.xva) on the Xenserver host. |
|
75 |
+Step 4: Run ./install_os_domU.sh from the tools/xen directory |
|
76 |
+------------------------------------------------------------- |
|
77 |
+cd tools/xen |
|
78 |
+./install_os_domU.sh |
|
79 | 79 |
|
80 |
-cd $DEVSTACKSRCROOT/devstack/tools/xen |
|
81 |
-./build_xva.sh |
|
80 |
+Once this script finishes executing, log into the VM (openstack domU) |
|
81 |
+that it installed and tail the run.sh.log file. You will need to wait |
|
82 |
+until it run.sh has finished executing. |
|
82 | 83 |
|
83 |
-You will also need to copy your localrc to the Xenserver host. |
|
84 | 84 |
|
85 |
-Step 5: Run ./build_domU.sh |
|
86 |
-This script does a lot of stuff, it is probably best to read it in its entirety. |
|
87 |
-But in a nutshell, it performs the following: |
|
88 |
- |
|
89 |
-* Configures bridges and vlans for public, private, and management nets |
|
90 |
-* Creates and installs a OpenStack all-in-one domU in an HA-FlatDHCP configuration |
|
91 |
-* A script to create a multi-domU (ie. head node separated from compute) configuration is coming soon! |
|
92 |
- |
|
93 |
-cd $DEVSTACKSRCROOT/devstack/tools/xen |
|
94 |
-./build_domU.sh |
|
95 |
- |
|
96 |
-Step 6: Do cloudy stuff! |
|
85 |
+Step 5: Do cloudy stuff! |
|
97 | 86 |
-------------------------- |
98 | 87 |
* Play with horizon |
99 | 88 |
* Play with the CLI |
100 | 89 |
* Log bugs to devstack and core projects, and submit fixes! |
101 |
- |
|
102 |
-Ubuntu 11.10 VM on Xenserver |
|
103 |
-Run ./scripts/xenoneirictemplate.sh on your Xenserver host. This creates a |
|
104 |
-template to be able to install a Ubuntu Oneiric (11.10) virtual machine. |
|
105 |
-Once the template is created, follow the wizard to complete the network install. |