devstack_custom/stack.sh

441 lines
16 KiB
Bash
Raw Normal View History

#!/usr/bin/env bash
2011-09-12 18:59:38 +00:00
# **stack.sh** is rackspace cloudbuilder's opinionated openstack dev installation.
2011-09-16 05:54:52 +00:00
# To keep this script simple we assume you are running on an **Ubuntu 11.04
2011-09-16 04:28:23 +00:00
# Natty** machine. It should work in a VM or physical server. Additionally we
# put the list of *apt* and *pip* dependencies and other configuration files in
# this repo. So start by grabbing this script and the dependencies.
2011-09-16 05:19:42 +00:00
# Sanity Check
# ============
2011-09-16 05:54:52 +00:00
# Warn users who aren't on natty, but allow them to override check and attempt
2011-09-16 05:19:42 +00:00
# installation with ``FORCE=yes ./stack``
if ! grep -q natty /etc/lsb-release; then
echo "WARNING: this script has only been tested on natty"
if [[ "$FORCE" != "yes" ]]; then
echo "If you wish to run this script anyway run with FORCE=yes"
exit 1
fi
fi
# stack.sh keeps the list of **apt** and **pip** dependencies in files.
# Additionally we have a few config templates and other useful files useful
# installation. They are needed to be located at ``apts``, ``files`` and
2011-09-16 05:54:52 +00:00
# ``pips`` in the ``DEVSTACK`` directory (next to this script).
2011-09-16 05:19:42 +00:00
DEVSTACK=`pwd`
if [ ! -d $DEVSTACK/apts ] || [ ! -d $DEVSTACK/files ] || [ ! -d $DEVSTACK/pips ]; then
echo "ERROR: missing devstack files - did you grab more than just stack.sh?"
exit 1
fi
# Settings
# ========
2011-09-13 08:24:50 +00:00
# This script is customizable through setting environment variables. If you
# want to override a setting you can either::
#
# export MYSQL_PASS=anothersecret
# ./stack.sh
#
2011-09-16 05:19:42 +00:00
# You can also pass options on a single line ``MYSQL_PASS=simple ./stack.sh``
#
# We try to have sensible defaults, so you should be able to run ``./stack.sh``
# in most cases.
2011-09-16 05:19:42 +00:00
# So that errors don't compound we exit on any errors so you see only the
# first error that occured.
set -o errexit
2011-09-13 08:24:50 +00:00
# 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
2011-09-16 05:19:42 +00:00
# Destination path for installation ``DEST``
DEST=${DEST:-/opt}
2011-09-12 18:59:38 +00:00
# Set the destination directories for openstack projects
NOVA_DIR=$DEST/nova
DASH_DIR=$DEST/dash
2011-09-16 04:46:20 +00:00
NIXON_DIR=$DEST/dash/openstack-dashboard/dashboard/nixon
GLANCE_DIR=$DEST/glance
KEYSTONE_DIR=$DEST/keystone
NOVACLIENT_DIR=$DEST/python-novaclient
API_DIR=$DEST/openstackx
NOVNC_DIR=$DEST/noVNC
2011-09-13 20:37:50 +00:00
MUNIN_DIR=$DEST/openstack-munin
2011-09-14 03:07:44 +00:00
# Specify which services to launch. These generally correspond to screen tabs
ENABLED_SERVICES=${ENABLED_SERVICES:-g-api,g-reg,key,n-api,n-cpu,n-net,n-sch,n-vnc,dash,mysql,rabbit}
2011-09-13 08:24:50 +00:00
# Use the first IP unless an explicit is set by ``HOST_IP`` environment variable
if [ ! -n "$HOST_IP" ]; then
2011-09-13 18:22:14 +00:00
HOST_IP=`LC_ALL=C /sbin/ifconfig | grep -m 1 'inet addr:'| cut -d: -f2 | awk '{print $1}'`
fi
2011-09-13 08:24:50 +00:00
# Nova network configuration
INTERFACE=${INTERFACE:-eth0}
FLOATING_RANGE=${FLOATING_RANGE:-10.6.0.0/27}
FIXED_RANGE=${FIXED_RANGE:-10.0.0.0/24}
NET_MAN=${NET_MAN:-VlanManager}
2011-09-14 03:07:44 +00:00
EC2_DMZ_HOST=${EC2_DMZ_HOST:-$HOST_IP}
2011-09-13 08:24:50 +00:00
# If you are using FlatDHCP on multiple hosts, set the ``FLAT_INTERFACE``
# variable but make sure that the interface doesn't already have an
# ip or you risk breaking things.
# FLAT_INTERFACE=eth0
2011-09-13 08:24:50 +00:00
# Nova hypervisor configuration
LIBVIRT_TYPE=${LIBVIRT_TYPE:-qemu}
2011-09-14 03:07:44 +00:00
# Mysql connection info
2011-09-14 09:39:10 +00:00
MYSQL_USER=${MYSQL_USER:-root}
MYSQL_PASS=${MYSQL_PASS:-nova}
2011-09-14 03:07:44 +00:00
MYSQL_HOST=${MYSQL_HOST:-localhost}
# don't specify /db in this string, so we can use it for multiple services
2011-09-14 03:11:42 +00:00
BASE_SQL_CONN=${BASE_SQL_CONN:-mysql://$MYSQL_USER:$MYSQL_PASS@$MYSQL_HOST}
2011-09-14 03:07:44 +00:00
# Rabbit connection info
RABBIT_HOST=${RABBIT_HOST:-localhost}
2011-09-14 16:55:31 +00:00
# Glance connection info. Note the port must be specified.
GLANCE_HOSTPORT=${GLANCE_HOSTPORT:-0.0.0.0:9292}
# Install Packages
2011-09-13 08:24:50 +00:00
# ================
#
# Openstack uses a fair number of other projects.
2011-09-13 08:24:50 +00:00
# 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
2011-09-13 02:29:56 +00:00
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/start_on_boot boolean true
MYSQL_PRESEED
2011-09-13 00:09:08 +00:00
# install apt requirements
sudo apt-get install -y -q `cat $DEVSTACK/apts/* | cut -d\# -f1 | grep -Ev "mysql-server|rabbitmq-server"`
2011-09-13 00:09:08 +00:00
# install python requirements
2011-09-16 05:19:42 +00:00
sudo PIP_DOWNLOAD_CACHE=/var/cache/pip pip install `cat $DEVSTACK/pips/*`
2011-09-13 00:09:08 +00:00
# git clone only if directory doesn't exist already
function git_clone {
if [ ! -d $2 ]; then
git clone $1 $2
fi
}
2011-09-13 00:09:08 +00:00
# compute service
git_clone https://github.com/cloudbuilders/nova.git $NOVA_DIR
2011-09-13 00:09:08 +00:00
# image catalog service
git_clone https://github.com/cloudbuilders/glance.git $GLANCE_DIR
2011-09-13 00:09:08 +00:00
# unified auth system (manages accounts/tokens)
git_clone https://github.com/cloudbuilders/keystone.git $KEYSTONE_DIR
2011-09-13 00:09:08 +00:00
# a websockets/html5 or flash powered VNC console for vm instances
git_clone https://github.com/cloudbuilders/noVNC.git $NOVNC_DIR
2011-09-13 00:09:08 +00:00
# django powered web control panel for openstack
git_clone https://github.com/cloudbuilders/openstack-dashboard.git $DASH_DIR
2011-09-16 05:42:43 +00:00
# add nixon, will use this to show munin graphs in dashboard
2011-09-16 05:58:06 +00:00
git_clone https://github.com/cloudbuilders/nixon.git $NIXON_DIR
2011-09-13 00:09:08 +00:00
# python client library to nova that dashboard (and others) use
git_clone https://github.com/cloudbuilders/python-novaclient.git $NOVACLIENT_DIR
2011-09-13 00:09:08 +00:00
# openstackx is a collection of extensions to openstack.compute & nova
# that is *deprecated*. The code is being moved into python-novaclient & nova.
git_clone https://github.com/cloudbuilders/openstackx.git $API_DIR
2011-09-13 20:37:50 +00:00
# openstack-munin is a collection of munin plugins for monitoring the stack
git_clone https://github.com/cloudbuilders/openstack-munin.git $MUNIN_DIR
2011-09-13 00:09:08 +00:00
# Initialization
2011-09-13 08:24:50 +00:00
# ==============
2011-09-13 00:09:08 +00:00
# setup our checkouts so they are installed into python path
2011-09-13 08:24:50 +00:00
# allowing ``import nova`` or ``import glance.client``
2011-09-13 20:37:50 +00:00
cd $NOVA_DIR; sudo python setup.py develop
cd $NOVACLIENT_DIR; sudo python setup.py develop
cd $KEYSTONE_DIR; sudo python setup.py develop
cd $GLANCE_DIR; sudo python setup.py develop
cd $API_DIR; sudo python setup.py develop
cd $DASH_DIR/django-openstack; sudo python setup.py develop
cd $DASH_DIR/openstack-dashboard; sudo python setup.py develop
2011-09-13 00:09:08 +00:00
2011-09-16 05:19:42 +00:00
# Add a useful screenrc. This isn't required to run openstack but is we do
# it since we are going to run the services in screen for simple
cp $DEVSTACK/files/screenrc ~/.screenrc
2011-09-13 20:17:22 +00:00
2011-09-16 05:19:42 +00:00
## TODO: update current user to allow sudo for all commands in files/sudo/*
2011-09-13 00:09:08 +00:00
# Rabbit
# ---------
#
if [[ "$ENABLED_SERVICES" =~ "rabbit" ]]; then
# Install and start rabbitmq-server
2011-09-16 06:17:44 +00:00
sudo apt-get install -y -q rabbitmq-server
fi
2011-09-16 04:28:23 +00:00
# Mysql
# ---------
#
if [[ "$ENABLED_SERVICES" =~ "mysql" ]]; then
# Install and start mysql-server
2011-09-16 06:17:44 +00:00
sudo apt-get -y -q install mysql-server
2011-09-16 04:28:23 +00:00
# Update the DB to give user $MYSQL_USER@% full control of the all databases:
sudo mysql -uroot -p$MYSQL_PASS -e "GRANT ALL PRIVILEGES ON *.* TO '$MYSQL_USER'@'%' identified by '$MYSQL_PASS';"
# Edit /etc/mysql/my.cnf to change bind-address from localhost (127.0.0.1) to any (0.0.0.0) and restart the mysql service:
sudo sed -i 's/127.0.0.1/0.0.0.0/g' /etc/mysql/my.cnf
sudo service mysql restart
fi
2011-09-13 08:24:50 +00:00
# Dashboard
# ---------
#
# Setup the django application to serve via apache/wsgi
2011-09-13 00:09:08 +00:00
if [[ "$ENABLED_SERVICES" =~ "dash" ]]; then
2011-09-16 04:28:23 +00:00
# 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
# initial imports
sudo mkdir -p $DASH_DIR/openstack-dashboard/quantum || true
sudo touch $DASH_DIR/openstack-dashboard/quantum/__init__.py
sudo touch $DASH_DIR/openstack-dashboard/quantum/client.py
cd $DASH_DIR/openstack-dashboard
2011-09-16 05:42:43 +00:00
# Includes settings for Nixon, to expose munin charts.
2011-09-16 06:28:52 +00:00
sudo cp $DEVSTACK/files/dash_settings.py local/local_settings.py
2011-09-16 04:46:20 +00:00
dashboard/manage.py syncdb
# create an empty directory that apache uses as docroot
sudo mkdir -p $DASH_DIR/.blackhole
## Configure apache's 000-default to run dashboard
2011-09-16 05:19:42 +00:00
sudo cp $DEVSTACK/files/000-default.template /etc/apache2/sites-enabled/000-default
sudo sed -e "s,%DASH_DIR%,$DASH_DIR,g" -i /etc/apache2/sites-enabled/000-default
# ``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
# dashboard can run
sudo chown -R www-data:www-data $DASH_DIR
fi
2011-09-13 02:29:56 +00:00
2011-09-13 20:37:50 +00:00
# Munin
# -----
2011-09-16 04:28:23 +00:00
# Munin is accessable via apache and was configured in the dashboard section.
2011-09-13 20:37:50 +00:00
if [[ "$ENABLED_SERVICES" =~ "munin" ]]; then
# allow connections from other hosts
sudo sed -i -e '/Allow from localhost/s/localhost.*$/all/' /etc/munin/apache.conf
cat >/tmp/nova <<EOF
2011-09-13 20:37:50 +00:00
[keystone_*]
2011-09-14 15:20:57 +00:00
user `whoami`
2011-09-13 20:37:50 +00:00
[nova_*]
2011-09-14 15:20:57 +00:00
user `whoami`
2011-09-13 20:37:50 +00:00
EOF
sudo mv /tmp/nova /etc/munin/plugin-conf.d/nova
# configure Munin for Nova plugins
PLUGINS="keystone_stats nova_floating_ips nova_instance_launched nova_instance_ nova_instance_timing nova_services"
for i in $PLUGINS; do
sudo cp -p $MUNIN_DIR/$i /usr/share/munin/plugins
sudo ln -sf /usr/share/munin/plugins/$i /etc/munin/plugins
done
sudo mv /etc/munin/plugins/nova_instance_ /etc/munin/plugins/nova_instance_launched
sudo restart munin-node
fi
2011-09-13 20:37:50 +00:00
2011-09-13 08:24:50 +00:00
# Glance
# ------
if [[ "$ENABLED_SERVICES" =~ "g-reg" ]]; then
# Glance uses ``/var/lib/glance`` and ``/var/log/glance`` by default, so
# we need to insure that our user has permissions to use them.
sudo mkdir -p /var/log/glance
sudo chown -R `whoami` /var/log/glance
sudo mkdir -p /var/lib/glance
sudo chown -R `whoami` /var/lib/glance
# Delete existing images/database as glance will recreate the db on startup
rm -rf /var/lib/glance/images/*
# (re)create glance database
mysql -u$MYSQL_USER -p$MYSQL_PASS -e 'DROP DATABASE glance;' || true
mysql -u$MYSQL_USER -p$MYSQL_PASS -e 'CREATE DATABASE glance;'
# Copy over our glance-registry.conf
GLANCE_CONF=$GLANCE_DIR/etc/glance-registry.conf
2011-09-16 05:19:42 +00:00
cp $DEVSTACK/files/glance-registry.conf $GLANCE_CONF
sudo sed -e "s,%SQL_CONN%,$BASE_SQL_CONN/glance,g" -i $GLANCE_CONF
fi
2011-09-13 00:09:08 +00:00
2011-09-13 08:24:50 +00:00
# Nova
# ----
function add_nova_flag {
echo "$1" >> $NOVA_DIR/bin/nova.conf
}
2011-09-13 00:09:08 +00:00
# (re)create nova.conf
rm -f $NOVA_DIR/bin/nova.conf
add_nova_flag "--verbose"
add_nova_flag "--nodaemon"
add_nova_flag "--dhcpbridge_flagfile=$NOVA_DIR/bin/nova.conf"
add_nova_flag "--network_manager=nova.network.manager.$NET_MAN"
add_nova_flag "--my_ip=$HOST_IP"
add_nova_flag "--public_interface=$INTERFACE"
add_nova_flag "--vlan_interface=$INTERFACE"
2011-09-14 03:07:44 +00:00
add_nova_flag "--sql_connection=$BASE_SQL_CONN/nova"
2011-09-13 00:09:08 +00:00
add_nova_flag "--libvirt_type=$LIBVIRT_TYPE"
add_nova_flag "--osapi_extensions_path=$API_DIR/extensions"
add_nova_flag "--vncproxy_url=http://$HOST_IP:6080"
2011-09-13 10:35:00 +00:00
add_nova_flag "--vncproxy_wwwroot=$NOVNC_DIR/"
2011-09-13 00:09:08 +00:00
add_nova_flag "--api_paste_config=$KEYSTONE_DIR/examples/paste/nova-api-paste.ini"
add_nova_flag "--image_service=nova.image.glance.GlanceImageService"
2011-09-14 03:07:44 +00:00
add_nova_flag "--ec2_dmz_host=$EC2_DMZ_HOST"
add_nova_flag "--rabbit_host=$RABBIT_HOST"
2011-09-14 16:55:31 +00:00
add_nova_flag "--glance_api_servers=$GLANCE_HOSTPORT"
2011-09-13 00:09:08 +00:00
if [ -n "$FLAT_INTERFACE" ]; then
add_nova_flag "--flat_interface=$FLAT_INTERFACE"
fi
2011-09-13 00:09:08 +00:00
# create a new named screen to store things in
screen -d -m -S nova -t nova
sleep 1
if [[ "$ENABLED_SERVICES" =~ "n-cpu" ]]; then
2011-09-13 20:17:22 +00:00
# attempt to load modules: kvm (hardware virt) and nbd (network block
# device - used to manage qcow images)
sudo modprobe nbd || true
sudo modprobe kvm || true
# user needs to be member of libvirtd group for nova-compute to use libvirt
sudo usermod -a -G libvirtd `whoami`
# if kvm wasn't running before we need to restart libvirt to enable it
sudo /etc/init.d/libvirt-bin restart
2011-09-13 20:17:22 +00:00
## FIXME(ja): should LIBVIRT_TYPE be kvm if kvm module is loaded?
2011-09-13 00:09:08 +00:00
# setup nova instance directory
mkdir -p $NOVA_DIR/instances
2011-09-13 00:09:08 +00:00
# if there is a partition labeled nova-instances use it (ext filesystems
# can be labeled via e2label)
## FIXME: if already mounted this blows up...
if [ -L /dev/disk/by-label/nova-instances ]; then
sudo mount -L nova-instances $NOVA_DIR/instances
sudo chown -R `whoami` $NOVA_DIR/instances
fi
# Clean out the instances directory
rm -rf $NOVA_DIR/instances/*
fi
if [[ "$ENABLED_SERVICES" =~ "n-net" ]]; then
# delete traces of nova networks from prior runs
killall dnsmasq || true
rm -rf $NOVA_DIR/networks
mkdir -p $NOVA_DIR/networks
fi
if [[ "$ENABLED_SERVICES" =~ "mysql" ]]; then
# (re)create nova database
mysql -u$MYSQL_USER -p$MYSQL_PASS -e 'DROP DATABASE nova;' || true
mysql -u$MYSQL_USER -p$MYSQL_PASS -e 'CREATE DATABASE nova;'
$NOVA_DIR/bin/nova-manage db sync
2011-09-13 22:16:26 +00:00
# create a small network
$NOVA_DIR/bin/nova-manage network create private $FIXED_RANGE 1 32
2011-09-13 22:16:26 +00:00
# create some floating ips
$NOVA_DIR/bin/nova-manage floating create $FLOATING_RANGE
fi
2011-09-13 22:16:26 +00:00
# Keystone
# --------
if [[ "$ENABLED_SERVICES" =~ "key" ]]; then
# (re)create keystone database
mysql -u$MYSQL_USER -p$MYSQL_PASS -e 'DROP DATABASE keystone;' || true
mysql -u$MYSQL_USER -p$MYSQL_PASS -e 'CREATE DATABASE keystone;'
2011-09-13 00:09:08 +00:00
# FIXME (anthony) keystone should use keystone.conf.example
KEYSTONE_CONF=$KEYSTONE_DIR/etc/keystone.conf
2011-09-16 05:19:42 +00:00
cp $DEVSTACK/files/keystone.conf $KEYSTONE_CONF
sudo sed -e "s,%SQL_CONN%,$BASE_SQL_CONN/keystone,g" -i $KEYSTONE_CONF
2011-09-13 19:01:45 +00:00
# initialize keystone with default users/endpoints
2011-09-16 05:19:42 +00:00
BIN_DIR=$KEYSTONE_DIR/bin bash $DEVSTACK/files/keystone_data.sh
fi
2011-09-13 00:09:08 +00:00
2011-09-13 08:24:50 +00:00
# Launch Services
# ===============
2011-09-13 02:29:56 +00:00
# nova api crashes if we start it with a regular screen command,
# so send the start command by forcing text into the window.
2011-09-13 20:17:22 +00:00
# Only run the services specified in ``ENABLED_SERVICES``
NL=`echo -ne '\015'`
2011-09-13 02:29:56 +00:00
function screen_it {
2011-09-13 18:28:56 +00:00
if [[ "$ENABLED_SERVICES" =~ "$1" ]]; then
screen -S nova -X screen -t $1
screen -S nova -p $1 -X stuff "$2$NL"
fi
2011-09-13 02:29:56 +00:00
}
2011-09-13 00:09:08 +00:00
screen_it g-api "cd $GLANCE_DIR; bin/glance-api --config-file=etc/glance-api.conf"
screen_it g-reg "cd $GLANCE_DIR; bin/glance-registry --config-file=etc/glance-registry.conf"
screen_it key "$KEYSTONE_DIR/bin/keystone --config-file $KEYSTONE_CONF"
screen_it n-api "$NOVA_DIR/bin/nova-api"
screen_it n-cpu "$NOVA_DIR/bin/nova-compute"
screen_it n-net "$NOVA_DIR/bin/nova-network"
screen_it n-sch "$NOVA_DIR/bin/nova-scheduler"
2011-09-13 10:35:00 +00:00
# nova-vncproxy binds a privileged port, and so needs sudo
screen_it n-vnc "sudo $NOVA_DIR/bin/nova-vncproxy"
2011-09-13 16:20:58 +00:00
screen_it dash "sudo /etc/init.d/apache2 restart; sudo tail -f /var/log/apache2/error.log"
2011-09-13 00:09:08 +00:00
2011-09-13 08:24:50 +00:00
# Install Images
# ==============
if [[ "$ENABLED_SERVICES" =~ "g-reg" ]]; then
# Downloads a tty image (ami/aki/ari style), then extracts it. Upon extraction
# we upload to glance with the glance cli tool.
mkdir -p $DEST/images
cd $DEST/images
if [ ! -f $DEST/tty.tgz ]; then
wget -c http://images.ansolabs.com/tty.tgz -O $DEST/tty.tgz
fi
# extract ami-tty/image, aki-tty/image & ari-tty/image
tar -zxf $DEST/tty.tgz
# add images to glance
# FIXME: kernel/ramdisk is hardcoded - use return result from add
glance add name="tty-kernel" is_public=true container_format=aki disk_format=aki < aki-tty/image
glance add name="tty-ramdisk" is_public=true container_format=ari disk_format=ari < ari-tty/image
glance add name="tty" is_public=true container_format=ami disk_format=ami kernel_id=1 ramdisk_id=2 < ami-tty/image
fi
2011-09-16 04:28:23 +00:00
# Using the cloud
# ===============
# If you installed the dashboard on this server, then you should be able
# to access the site using your browser.
if [[ "$ENABLED_SERVICES" =~ "dash" ]]; then
echo "dashboard is now available at http://$HOST_IP/"
fi
# If keystone is present, you can point nova cli to this server
if [[ "$ENABLED_SERVICES" =~ "key" ]]; then
echo "keystone is serving at http://$HOST_IP:5000/v2.0/"
echo "examples on using novaclient command line is in exercise.sh"
fi