alexxnica / upstream-institute-virtual-environment

A VirtualBox image that has all the tools needed to begin OpenStack upstream contribution

OpenStack Upstream Institute Virtual Environment

bit.ly/upstream-institute-vm

Instructions

Using VirtualBox

1. Set up VirtualBox
2. Go to the releases page and download the latest VM image.
3. Import the ova file (File -> Import appliance...)

   on Windows? look here.)

4. Start up the VM

Using VMware player

1. Set up VMware player
2. Go to the releases page and download the latest VM image.
3. Open the ova file (File -> Open a Virtual Machine)

   A warning dialog might appear. Click on Retry

4. Start up the VM

Minimum requirements

• 5GB of free RAM (so at least 8GB in your laptop)
• Recent CPU with at least 4 cores
• 15GB disk space

Getting around in the VM

1. Explore the environment. The four main software you will be using from the desktop during the training are:

   • Firefox web browser
   • Xfce4-terminal terminal emulator
   • Geany text editor
   • HexChat IRC client

     please make sure that you replace the default user ubuntu upon first start before logging in to Freenode channels.

2. When stack.sh has finished running, you can open your Horizon Dashboard (http://localhost/) or on VirtualBox using the DevStack bookmark

   • Login: demo
   • Password: openstack

3. Select the demo project

4. Start a VM. Use a tiny flavor. A CirrOS image is already set up by devstack

5. Assign a floating IP

6. Enable SSH and ICMP ports on the security groups

Learn how to set up devstack

These are the steps used to provision the vm:

• install-base.sh - Git and dependent packages
• install-devstack.sh - Devstack
• install-gui.sh - Xfce desktop environment, GUI applications
• files/ - configuration files copied into the vm

Using latest devstack

Please do not update your openstack installation during the training. It requires bandwidth.

If you want to keep on using the training VM for devstacking, you should disable offline mode in local.conf. Also reconsider git related settings here.

Screenshots

devstack	text editor	git and irc

Advanced Topics

This section is mainly for developers of the VM, on the training you won't need this.

Using Vagrant

1. Set up VirtualBox
2. Set up Vagrant
3. git clone https://github.com/kmARC/openstack-training-virtual-environment
4. cd openstack-training-virtual-environment
5. vagrant up
6. vagrant reload
7. vagrant ssh

Follow instructions as for the prebuilt image

Roll your own image

Essentially the same procedure, with exporting an ova archive at the end which then can be distributed and easily import into VirtualBox

1. install libssl098:i386 (required for vmware vdiskmanager to shrink disks)

   wget http://security.ubuntu.com/ubuntu/ubuntu/pool/universe/o/openssl098/libssl0.9.8_0.9.8o-7ubuntu4_i386.deb
   sudo dpkg -i libssl0.9.8_0.9.8o-7ubuntu4_i386.deb

2. ./create-training-box.sh Provisions the VM and creates the distributable ova archive.

License

MIT