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

Go to file

Mark Korondi e904278e50 Upgrading Virtual Machine to Ubuntu Xenial During the Berlin summit, 2018 November, we used an updated version of the training VM, with always-latest devstack running on Ubuntu 18.04 LTS. This patch fixes issues coming with installing devstack on the new operating system, and also introduces some bug fixes. For a full list of changes, refer to CHANGELOG.md Change-Id: I822f68d5aba5721d6eb7dd9066e10dff81bcd736		2018-11-26 12:12:56 +00:00
dist	Vagrant provisioning with XFCE, devstack, and some GUI apps and settings	2016-06-03 14:27:30 +02:00
docs	Adding VirtualBox import screen	2016-10-20 17:02:20 +02:00
elements/upstream-training	Upgrading Virtual Machine to Ubuntu Xenial	2018-11-26 12:12:56 +00:00
vm-creator-vm	Upgrading Virtual Machine to Ubuntu Xenial	2018-11-26 12:12:56 +00:00
.gitignore	Upgrading Virtual Machine to Ubuntu Xenial	2018-11-26 12:12:56 +00:00
.gitreview	Fixes for Sydney. Removed re-stacking instructions. Gitreview set up.	2017-11-02 19:33:04 +00:00
CHANGELOG.md	Upgrading Virtual Machine to Ubuntu Xenial	2018-11-26 12:12:56 +00:00
LICENSE	Initial commit	2016-06-03 14:25:26 +02:00
README-virtualbox-import.md	Update README-virtualbox-import.md	2017-04-28 09:19:31 +02:00
README.md	Mention VirtualBox extension pack	2018-03-27 20:22:10 +02:00
create-training-box.sh	Allow users to override output format in create-training-box.sh	2018-08-29 08:14:12 +02:00
prereqs.sh	Upgrading Virtual Machine to Ubuntu Xenial	2018-11-26 12:12:56 +00:00
upstream-training.ovf	Moving to diskimage-builder	2018-03-12 20:47:44 +01:00

README.md

OpenStack Upstream Institute Virtual Environment

bit.ly/upstream-institute-vm

Instructions

Using VirtualBox

Set up VirtualBox with Extension Pack
Go to the releases page and download the latest VM image.
Import the ova file (File -> Import appliance...)

on Windows? look here.)
Start up the VM

Using VMware player

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

A warning dialog might appear. Click on Retry
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

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.
When stack.sh finished running, you can open your Horizon Dashboard (http://localhost/) or on VirtualBox using the DevStack bookmark
- Login: demo
- Password: openstack
Select the demo project
Start a VM. Use a tiny flavor. A CirrOS image is already set up by devstack
Assign a floating IP
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.

Roll your own image

The image can be built using diskimage-builder.

Install prerequisites
```
./prereqs.sh
```
This step needs root/sudo rights to install tools like qemu-img
Activate the python virtual environment
```
. .env/bin/activate
```
Create disk image with provided convenience script
```
./create-training-box.sh
```
The generated image can be found under dist/

License

MIT