openstack/upstream-institute-virtual-environment
Code Issues Proposed changes
A VirtualBox image that has all the tools needed to begin OpenStack upstream contribution
71 Commits 1 Branch 6 Tags 1.4 MiB
Shell 85.4%
JavaScript 14.6%
b51c0fe8ca
Go to file
Mark Korondi b51c0fe8ca import-virsh script for qemu/kvm 
This change introduces import-virsh.sh which is a convenience script
that helps converting the downloaded ova file to be imported by virsh,
thus providing an easy way to start the trainig VM using virt-manager.

Change-Id: I8012cfd13126acd08410d58568fb86a0a0469b27
2018-12-04 21:50:30 +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
create-training-box.sh Allow users to override output format in create-training-box.sh 2018-08-29 08:14:12 +02:00
import-virsh.sh import-virsh script for qemu/kvm 2018-12-04 21:50:30 +00:00
LICENSE Initial commit 2016-06-03 14:25:26 +02:00
prereqs.sh Upgrading Virtual Machine to Ubuntu Xenial 2018-11-26 12:12:56 +00: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
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

  1. Set up VirtualBox with Extension Pack
  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 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:

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 geany git-hexchat
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.

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

License

MIT