gantt/docs/getting.started.rst

Getting Started with Nova

GOTTA HAVE A nova.pth file added or it WONT WORK (will write setup.py file soon)

DEPENDENCIES

• RabbitMQ: messaging queue, used for all communication between components
• OpenLDAP: users, groups (maybe cut)
• Tornado: scalable non blocking web server for api requests
• Twisted: just for the twisted.internet.defer package
• boto: python api for aws api
• M2Crypto: python library interface for openssl
• IPy: library for managing ip addresses
• ReDIS: Remote Dictionary Store (for fast, shared state data)

Recommended

• euca2ools: python implementation of aws ec2-tools and ami tools
• build tornado to use C module for evented section

Installation

# ON ALL SYSTEMS
apt-get install -y python-libvirt libvirt-bin python-setuptools python-dev python-pycurl python-m2crypto python-twisted
apt-get install -y aoetools vlan
modprobe aoe

# ON THE CLOUD CONTROLLER
apt-get install -y rabbitmq-server dnsmasq      
# fix ec2 metadata/userdata uri - where $IP is the IP of the cloud
iptables -t nat -A PREROUTING -s 0.0.0.0/0 -d 169.254.169.254/32 -p tcp -m tcp --dport 80 -j DNAT --to-destination $IP:8773
iptables --table nat --append POSTROUTING --out-interface $PUBLICIFACE -j MASQUERADE     
# setup ldap (slap.sh as root will remove ldap and reinstall it)   
auth/slap.sh     
/etc/init.d/rabbitmq-server start

# ON VOLUME NODE:
apt-get install -y vblade-persist 

# ON THE COMPUTE NODE:
apt-get install -y kpartx kvm

# optional packages
apt-get install -y euca2ools 

# Set up flagfiles with the appropriate hostnames, etc.                                     
# start api_worker, s3_worker, node_worker, storage_worker
# Add yourself to the libvirtd group, log out, and log back in
# Make sure the user who will launch the workers has sudo privileges w/o pass (will fix later)