2012-09-18 OpenStack

OpenStack Test Days


Date	2012-09-18 and 2012-09-25
Time	all day

IRC	#fedora-openstack (webirc)

Can't make the dates?
If you come to this page before or after the test day is completed, your testing is still valuable, and you can use the information on this page to test, file any bugs you find at Bugzilla, and add your results to the results section. If this page is more than a month old when you arrive here, please check the current schedule and see if a similar but more recent Test Day is planned or has already happened.

Who's available

The following cast of characters will be available testing, workarounds, bug fixes, and general discussion ...

Development - Apevec (apevec)
Development - Derekh (derekh)
Development - eglynn (eglynn)
Development - gkotton (garyk)
Consulting - kensey (kensey)
Development - markmc (markmc)
Development - mrunge (mrunge)
Development - Pbrady (pixelbeat)
Deployment - rbuilta (rbuilta)
Deployment - sten (sten)
Deployment - Vaneldik (vaneldik)
Development - ndipanov (ndipanov)
Development - nsantos (nunofsantos)
Development - dprince (dprince)
Development - imain (Slower)
Development - sdake (sdake)
Development - shardy (shardy)
Development - stevebake (stevebake)
Development - jpeeler (jpeeler)

Prerequisite for Test Day

Hardware virtualization support (e.g. Intel VT or AMD-V).
Up to 10-20Gb free disk space. Guest images take up a lot of space.

Hardware Requirements
You can do basic testing of OpenStack in a virtual machine, which is auto detected by the install script below

This is a Fedora 18 test day, but we have OpenStack Folsom packages available for both Fedora 18 and Fedora 17.

Fedora 18

Fedora 18 Alpha live image can be used to install a bare metal or virtual machine. Please record common Fedora 18 issues here:

Video doesn't work in a VM unless video type is set to 'vga' #848930
Auto partitioning wipes the disk without warning #855976
The installing packages step can take over 30 minutes #856993
The "swipe to remove" screen lock causes X corruption #857017

Alternatively, try updating from Fedora 17 to Fedora 18 using yum.

Fedora 17

Recent Fedora 17 live image respins can be used to install a bare metal or virtual machine.

How to test?

Follow the steps below to prepare the machine, then follow each of the test cases in order.

Configure sudo

Add your account to sudoers, which can be done from a root prompt like:

 (umask 337; echo "non_root_user ALL = (ALL) NOPASSWD: ALL" > /etc/sudoers.d/testday)

Update your machine

Make sure you have all the current updates for it installed:

 sudo yum --enablerepo=updates-testing clean all
 sudo yum update -y

Optionally Load nbd

If you don't perform this optional step, then libguestfs will be used to inject files into qcow2 images. Note however that is slower, especially if testing openstack within a VM

sudo modprobe nbd
echo nbd | sudo tee -a /etc/modules-load.d/nbd.conf

Put SELinux into Permissive Mode

While SELinux mostly works with OpenStack services there are a few issues

sudo sed -i 's/^SELINUX=.*/SELINUX=permissive/' /etc/selinux/config
sudo setenforce permissive

Please do note any AVC _denials_ you see in /var/log/audit/audit.log and file them in bugzilla, and update this list:

RHBZ #856548 general - Intermittent failures adding users to groups
RHBZ #856653 glance - api can't access mysql
RHBZ #837330 glance - 'name_connect' accesses on the tcp_socket
RHBZ #809198 rsync/swift replicator - rsync restricted by selinux

Install and setup all Openstack services on a single node

 sudo curl http://repos.fedorapeople.org/repos/openstack/openstack-folsom/fedora-openstack-folsom.repo -o /etc/yum.repos.d/fedora-openstack-folsom.repo

FEDORA 18 ONLY To avoid issues with stale libvirt, netcf, virt-viewer packages in official Fedora 18 repositories please enable this side repository containing the latest such packages:

 sudo curl http://repos.fedorapeople.org/repos/openstack/f18-testing/f18-testing.repo -o /etc/yum.repos.d/fedora-testing.repo

FEDORA 18 ONLY To workaround RHBZ #858311 issue with libvirtd auth:

 sudo yum install -y libvirt-daemon
 sudo sed -i 's/#\(auth_unix_r[ow] = "none"\)/\1/' /etc/libvirt/libvirtd.conf

FEDORA 18 ONLY There is a SELinux bug RHBZ #860201 causing openstack-demo-install to exit early, when installing withing a VM. Please apply this workaround only if installing within a VM:

 sudo yum install -y openstack-utils
 sudo sed -i 's/setsebool -P/setsebool/' /usr/bin/openstack-demo-install

So now the yum repositories are in place, so we'll install the openstack-demo-install script. This script will install all OpenStack services on a single node, including: nova, glance, quantum, cinder, swift, keystone, dashboard. Note it configures and enables all but the quantum service at this time:

 sudo yum install -y openstack-utils
 sudo openstack-demo-install

FEDORA 17 ONLY Correct permissions of /dev/kvm to allow nova to boot VMs (RHBZ #863374), please apply this workaround from F18 (RHBZ #860658):

 sudo udevadm trigger --sysname-match=kvm

Note this is a major test in itself, so please record any issues encountered.

Now copy the keystonerc file created by the install script above to your home directory, so that it can be easily sourced to provide the credentials used by the various OpenStack command line utilities.

 sudo cp /root/keystonerc ~

Known issues

Setup OpenStack volumes

The OpenStack volume service provides persistent block level storage to instances.

This is a commonly used service, so please enable using

Setup Cinder Volumes

Install and setup Quantum on a single node

As an option, you can replace the network manager internal to the OpenStack Nova project with Quantum.

Enable Quantum networking

Test Cases

Basic setup:

Core functionality:

Nova boot-from-volume:

Quantum functionality:

Configure and use a network topology in Quantum

Swift functionality:

Dashboard functionality:

Heat basic functionality (recommended for all developers):

Heat advanced functionality (recommended for heat developers):

Extra credit:

Test Results

If you have problems with any of the tests, report a bug to Bugzilla usually for one of the openstack-nova, openstack-glance, openstack-keystone, openstack-cinder,openstack-quantum, openstack-swift or heat components. If you are unsure about exactly how to file the report or what other information to include, just ask on IRC and we will help you.

Once you have completed the tests, add your results to the Results table below, following the example results from the first line as a template. The first column should be your name with a link to your User page in the Wiki if you have one. For each test case, use the result template to enter your result, as shown in the example result line.