Skip to content

Commit c0ae316

Browse files
Renuka ApteDean Troyer
authored andcommitted
XenServer new install: modify README
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 parent 0af143b commit c0ae316

File tree

1 file changed

+19
-49
lines changed

1 file changed

+19
-49
lines changed

tools/xen/README.md

Lines changed: 19 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Getting Started With XenServer 5.6 and Devstack
22
===============================================
33
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
55
some pointers on how to get started.
66

77
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):
2525
* XenServer Gateway: 192.168.1.1
2626
* XenServer DNS: 192.168.1.1
2727

28-
Note:
29-
------
30-
It is advisable (and necessary if you are using Xenserver 6.0, due to space
31-
limitations), to create the above mentioned OS domU, on a separate dev machine.
32-
To do this, you will need to run Steps 2 on the dev machine (if required) as
33-
well as the Xenserver host. Steps 3 and 4 should be run on the dev machine.
34-
This process requires you to be root on the dev machine.
35-
36-
Step 2: Prepare DOM0
37-
-------------------
38-
At this point, your host is missing some critical software that you will
39-
need to run devstack (like git). Do this to install required software:
40-
41-
wget --no-check-certificate https://raw.github.com/openstack-dev/devstack/master/tools/xen/prepare_dom0.sh
42-
chmod 755 prepare_dom0.sh
43-
./prepare_dom0.sh
28+
Step 2: Download devstack
29+
--------------------------
30+
On your XenServer host, run the following commands as root:
4431

45-
This step will also clone devstack in $DEVSTACKSRCROOT/devstack.
46-
$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/*/
4735

48-
Step 3: Configure your localrc
49-
-----------------------------
36+
Step 3: Configure your localrc inside the devstack directory
37+
------------------------------------------------------------
5038
Devstack uses a localrc for user-specific configuration. Note that
5139
the XENAPI_PASSWORD must be your dom0 root password.
5240
Of course, use real passwords if this machine is exposed.
5341

54-
cat > $DEVSTACKSRCROOT/devstack/localrc <<EOF
42+
cat > ./localrc <<EOF
5543
MYSQL_PASSWORD=my_super_secret
5644
SERVICE_TOKEN=my_super_secret
5745
ADMIN_PASSWORD=my_super_secret
46+
SERVICE_PASSWORD=$ADMIN_PASSWORD
5847
RABBIT_PASSWORD=my_super_secret
5948
# This is the password for your guest (for both stack and root users)
6049
GUEST_PASSWORD=my_super_secret
@@ -72,37 +61,18 @@ Of course, use real passwords if this machine is exposed.
7261
HOST_IP_IFACE=ethX
7362
EOF
7463

75-
Step 4: Run ./build_xva.sh
76-
--------------------------
77-
This script prepares your nova xva image. If you run this on a different machine,
78-
copy the resulting xva file to tools/xen/xvas/[GUEST_NAME].xva
79-
(by default tools/xen/xvas/ALLINONE.xva) on the Xenserver host.
64+
Step 4: Run ./install_os_domU.sh from the tools/xen directory
65+
-------------------------------------------------------------
66+
cd tools/xen
67+
./install_os_domU.sh
8068

81-
cd $DEVSTACKSRCROOT/devstack/tools/xen
82-
./build_xva.sh
69+
Once this script finishes executing, log into the VM (openstack domU)
70+
that it installed and tail the run.sh.log file. You will need to wait
71+
until it run.sh has finished executing.
8372

84-
You will also need to copy your localrc to the Xenserver host.
8573

86-
Step 5: Run ./build_domU.sh
87-
--------------------------
88-
This script does a lot of stuff, it is probably best to read it in its entirety.
89-
But in a nutshell, it performs the following:
90-
91-
* Configures bridges and vlans for public, private, and management nets
92-
* Creates and installs a OpenStack all-in-one domU in an HA-FlatDHCP configuration
93-
* A script to create a multi-domU (ie. head node separated from compute) configuration is coming soon!
94-
95-
cd $DEVSTACKSRCROOT/devstack/tools/xen
96-
./build_domU.sh
97-
98-
Step 6: Do cloudy stuff!
74+
Step 5: Do cloudy stuff!
9975
--------------------------
10076
* Play with horizon
10177
* Play with the CLI
10278
* Log bugs to devstack and core projects, and submit fixes!
103-
104-
Ubuntu 11.10 VM on Xenserver
105-
----------------------------
106-
Run ./scripts/xenoneirictemplate.sh on your Xenserver host. This creates a
107-
template to be able to install a Ubuntu Oneiric (11.10) virtual machine.
108-
Once the template is created, follow the wizard to complete the network install.

0 commit comments

Comments
 (0)