more doc updates

This commit is contained in:
Jesse Andrews 2011-09-13 01:24:50 -07:00
parent 30f68e9658
commit d74257d0da

View file

@ -2,19 +2,27 @@
# **stack.sh** is rackspace cloudbuilder's opinionated openstack dev installation. # **stack.sh** is rackspace cloudbuilder's opinionated openstack dev installation.
# FIXME: commands should be: stack.sh should allow specifying a subset of services
# Settings/Options # Settings/Options
# ---------------- # ================
# Quit script on error # This script is customizable through setting environment variables. If you
# want to override a setting you can either::
#
# export MYSQL_PASS=anothersecret
# ./stack.sh
#
# or run on a single line ``MYSQL_PASS=simple ./stack.sh``
# This script exits on an error so that errors don't compound and you see
# only the first error that occured.
set -o errexit set -o errexit
# Log commands as they are run for debugging # Print the commands being run so that we can see the command that triggers
# an error. It is also useful for following allowing as the install occurs.
set -o xtrace set -o xtrace
# Important paths: `DIR` is where we are executing from and `DEST` is where we # Important paths: ``DIR`` is where we are executing from and ``DEST`` is
# are installing openstack. # where we are installing openstack.
DIR=`pwd` DIR=`pwd`
DEST=/opt DEST=/opt
@ -27,34 +35,38 @@ NOVACLIENT_DIR=$DEST/python-novaclient
API_DIR=$DEST/openstackx API_DIR=$DEST/openstackx
NOVNC_DIR=$DEST/noVNC NOVNC_DIR=$DEST/noVNC
# Use the first IP unless an explicit is set by a HOST_IP environment variable # Use the first IP unless an explicit is set by ``HOST_IP`` environment variable
if [ ! -n "$HOST_IP" ]; then if [ ! -n "$HOST_IP" ]; then
HOST_IP=`LC_ALL=C ifconfig | grep -m 1 'inet addr:'| cut -d: -f2 | awk '{print $1}'` HOST_IP=`LC_ALL=C ifconfig | grep -m 1 'inet addr:'| cut -d: -f2 | awk '{print $1}'`
fi fi
# NOVA network / hypervisor configuration # Nova network configuration
INTERFACE=${INTERFACE:-eth0} INTERFACE=${INTERFACE:-eth0}
FLOATING_RANGE=${FLOATING_RANGE:-10.6.0.0/27} FLOATING_RANGE=${FLOATING_RANGE:-10.6.0.0/27}
FIXED_RANGE=${FIXED_RANGE:-10.0.0.0/24} FIXED_RANGE=${FIXED_RANGE:-10.0.0.0/24}
LIBVIRT_TYPE=${LIBVIRT_TYPE:-qemu}
NET_MAN=${NET_MAN:-VlanManager} NET_MAN=${NET_MAN:-VlanManager}
# NOTE(vish): If you are using FlatDHCP on multiple hosts, set the interface # If you are using FlatDHCP on multiple hosts, set the ``FLAT_INTERFACE``
# below but make sure that the interface doesn't already have an # variable but make sure that the interface doesn't already have an
# ip or you risk breaking things. # ip or you risk breaking things.
# FLAT_INTERFACE=eth0 # FLAT_INTERFACE=eth0
# Nova hypervisor configuration
LIBVIRT_TYPE=${LIBVIRT_TYPE:-qemu}
# TODO: switch to mysql for all services # TODO: switch to mysql for all services
MYSQL_PASS=${MYSQL_PASS:-nova} MYSQL_PASS=${MYSQL_PASS:-nova}
SQL_CONN=${SQL_CONN:-mysql://root:$MYSQL_PASS@localhost/nova} SQL_CONN=${SQL_CONN:-mysql://root:$MYSQL_PASS@localhost/nova}
# TODO: set rabbitmq conn string explicitly as well # TODO: set rabbitmq conn string explicitly as well
# Install Packages # Install Packages
# ---------------- # ================
# #
# Openstack uses a fair number of other projects. # Openstack uses a fair number of other projects.
# seed configuration with mysql password # Seed configuration with mysql password so that apt-get install doesn't
# prompt us for a password upon install.
cat <<MYSQL_PRESEED | sudo debconf-set-selections cat <<MYSQL_PRESEED | sudo debconf-set-selections
mysql-server-5.1 mysql-server/root_password password $MYSQL_PASS mysql-server-5.1 mysql-server/root_password password $MYSQL_PASS
mysql-server-5.1 mysql-server/root_password_again password $MYSQL_PASS mysql-server-5.1 mysql-server/root_password_again password $MYSQL_PASS
@ -91,10 +103,10 @@ git_clone https://github.com/cloudbuilders/python-novaclient.git $NOVACLIENT_DIR
git_clone https://github.com/cloudbuilders/openstackx.git $API_DIR git_clone https://github.com/cloudbuilders/openstackx.git $API_DIR
# Initialization # Initialization
# -------------- # ==============
# setup our checkouts so they are installed into python path # setup our checkouts so they are installed into python path
# allowing `import nova` or `import glance.client` # allowing ``import nova`` or ``import glance.client``
cd $NOVACLIENT_DIR; sudo python setup.py develop cd $NOVACLIENT_DIR; sudo python setup.py develop
cd $KEYSTONE_DIR; sudo python setup.py develop cd $KEYSTONE_DIR; sudo python setup.py develop
cd $GLANCE_DIR; sudo python setup.py develop cd $GLANCE_DIR; sudo python setup.py develop
@ -124,7 +136,10 @@ if [ -L /dev/disk/by-label/nova-instances ]; then
sudo chown -R `whoami` $NOVA_DIR/instances sudo chown -R `whoami` $NOVA_DIR/instances
fi fi
# *Dashboard*: setup django application to serve via apache/wsgi # Dashboard
# ---------
#
# Setup the django application to serve via apache/wsgi
# Dash currently imports quantum even if you aren't using it. Instead # Dash currently imports quantum even if you aren't using it. Instead
# of installing quantum we can create a simple module that will pass the # of installing quantum we can create a simple module that will pass the
@ -145,11 +160,14 @@ mkdir $DASH_DIR/.blackhole
cat $DIR/files/000-default.template | sed 's/%DASH_DIR%/\/opt\/dash/g' > /tmp/000-default cat $DIR/files/000-default.template | sed 's/%DASH_DIR%/\/opt\/dash/g' > /tmp/000-default
sudo mv /tmp/000-default /etc/apache2/sites-enabled sudo mv /tmp/000-default /etc/apache2/sites-enabled
# `python setup.py develop` left some files owned by root in $DASH_DIR and # ``python setup.py develop`` left some files owned by root in $DASH_DIR and
# others by the original owner. We need to change the owner to apache so # others by the original owner. We need to change the owner to apache so
# dashboard can run # dashboard can run
sudo chown -R www-data:www-data $DASH_DIR sudo chown -R www-data:www-data $DASH_DIR
# Glance
# ------
sudo mkdir -p /var/log/glance sudo mkdir -p /var/log/glance
sudo chown `whoami` /var/log/glance sudo chown `whoami` /var/log/glance
@ -158,6 +176,9 @@ cp $DIR/files/screenrc ~/.screenrc
# TODO: update current user to allow sudo for all commands in files/sudo/* # TODO: update current user to allow sudo for all commands in files/sudo/*
# Nova
# ----
NL=`echo -ne '\015'` NL=`echo -ne '\015'`
@ -222,8 +243,8 @@ sudo chown -R `whoami` /var/lib/glance
rm -rf /var/lib/glance/images/* rm -rf /var/lib/glance/images/*
rm -f $GLANCE_DIR/glance.sqlite rm -f $GLANCE_DIR/glance.sqlite
# Launching Services # Launch Services
# ------------------ # ===============
# nova api crashes if we start it with a regular screen command, # nova api crashes if we start it with a regular screen command,
# so send the start command by forcing text into the window. # so send the start command by forcing text into the window.
@ -244,8 +265,8 @@ screen_it n-sch "$NOVA_DIR/bin/nova-scheduler"
screen_it n-vnc "$NOVA_DIR/bin/nova-vncproxy" screen_it n-vnc "$NOVA_DIR/bin/nova-vncproxy"
screen_it dash "sudo /etc/init.d/apache2 restart; tail -f /var/log/apache2/error.log" screen_it dash "sudo /etc/init.d/apache2 restart; tail -f /var/log/apache2/error.log"
# Installing Images # Install Images
# ----------------- # ==============
# Downloads a tty image (ami/aki/ari style), then extracts it. Upon extraction # Downloads a tty image (ami/aki/ari style), then extracts it. Upon extraction
# we upload to glance with the glance cli tool. # we upload to glance with the glance cli tool.