From Fedora Project Wiki

Line 88: Line 88:


   sudo wget http://repos.fedorapeople.org/repos/openstack/openstack-folsom/fedora-openstack-folsom.repo -O /etc/yum.repos.d/fedora-openstack-folsom.repo
   sudo wget http://repos.fedorapeople.org/repos/openstack/openstack-folsom/fedora-openstack-folsom.repo -O /etc/yum.repos.d/fedora-openstack-folsom.repo
   sudo yum install http://kojipkgs.fedoraproject.org/packages/openstack-utils/2012.2/2.fc18/noarch/openstack-utils-2012.2-2.fc18.noarch.rpm
   sudo yum install http://kojipkgs.fedoraproject.org/packages/openstack-utils/2012.2/3.fc18/noarch/openstack-utils-2012.2-3.fc18.noarch.rpm
 
'''FEDORA 18 ONLY''' openstack-demo-install can fail with installing virt-viewer/spike-gtk3 on Fedora 18
As a workaround install a specific version of virt-viewer:
  sudo yum install -y http://kojipkgs.fedoraproject.org//packages/virt-viewer/0.5.4/1.fc18/x86_64/virt-viewer-0.5.4-1.fc18.x86_64.rpm


'''FEDORA 18 ONLY''' There is currently a issue with miss matching versions of libvirtd and netcf in Fedora 18
'''FEDORA 18 ONLY''' There is currently a issue with miss matching versions of libvirtd and netcf in Fedora 18
Install a specific version of netcf-libs '''only if using Fedora 18'''
As a workaround install a specific version of netcf-libs:
   wget http://kojipkgs.fedoraproject.org/packages/netcf/0.2.1/1.fc18/x86_64/netcf-libs-0.2.1-1.fc18.x86_64.rpm
   yum install http://kojipkgs.fedoraproject.org/packages/netcf/0.2.1/1.fc18/x86_64/netcf-libs-0.2.1-1.fc18.x86_64.rpm
  yum install netcf-libs-0.2.1-1.fc18.x86_64.rpm


So now the yum repositories are in place as is the openstack-demo-install script.
So now the yum repositories are in place as is the openstack-demo-install script.
Line 104: Line 107:
Note this is a major test in itself, so please record any issues encountered.
Note this is a major test in itself, so please record any issues encountered.


Known issues:
=== Known issues ===
* If openstack-demo-install fails with installing virt-viewer/spike-gtk3 on Fedora 18, do the following and then retry:
 
  sudo yum install -y http://kojipkgs.fedoraproject.org//packages/virt-viewer/0.5.4/1.fc18/x86_64/virt-viewer-0.5.4-1.fc18.x86_64.rpm


* If you're running in a VM, then Nova needs this tweak to support nested virtualization,
* If you're running in a VM, then Nova needs this tweak to support nested virtualization,

Revision as of 10:41, 18 September 2012

OpenStack Test Days
}}}

Date 2012-09-18
Time all day

IRC #fedora-openstack (webirc)


Can't make the date?
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 ...

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

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

Install and setup all Openstack services on a single node

 sudo wget http://repos.fedorapeople.org/repos/openstack/openstack-folsom/fedora-openstack-folsom.repo -O /etc/yum.repos.d/fedora-openstack-folsom.repo
 sudo yum install http://kojipkgs.fedoraproject.org/packages/openstack-utils/2012.2/3.fc18/noarch/openstack-utils-2012.2-3.fc18.noarch.rpm

FEDORA 18 ONLY openstack-demo-install can fail with installing virt-viewer/spike-gtk3 on Fedora 18 As a workaround install a specific version of virt-viewer:

 sudo yum install -y http://kojipkgs.fedoraproject.org//packages/virt-viewer/0.5.4/1.fc18/x86_64/virt-viewer-0.5.4-1.fc18.x86_64.rpm

FEDORA 18 ONLY There is currently a issue with miss matching versions of libvirtd and netcf in Fedora 18 As a workaround install a specific version of netcf-libs:

 yum install http://kojipkgs.fedoraproject.org/packages/netcf/0.2.1/1.fc18/x86_64/netcf-libs-0.2.1-1.fc18.x86_64.rpm

So now the yum repositories are in place as is 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 openstack-demo-install

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

Known issues

  • If you're running in a VM, then Nova needs this tweak to support nested virtualization,

or otherwise you get 'libvirtError: unsupported configuration: CPU specification not supported by hypervisor' when starting instances:

 sudo openstack-config --set /etc/nova/nova.conf DEFAULT libvirt_cpu_mode none

Setup OpenStack volumes

The OpenStack volume service provides persistent block level storage to instances. This is a commonly used service, so please enable using QA:Testcase_Create_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. To enable follow QA:Testcase_Quantum_V2#Setup

Test Cases

Basic setup:

  1. Add SSH keypair
  2. Register guest images
  3. Create nova network

Core functionality:

  1. Launch an instance
  2. Attach a volume
  3. Floating IPs
  4. Separate compute node

Nova boot-from-volume:

  1. Create a builder instance
  2. Create and boot from a bootable volume
  3. Create an image from a running volume-backed instance

Quantum functionality:

  1. Configure and use a network topology in Quantum

Swift functionality:

  1. Upload and download files
  2. Upload Segmented File
  3. Test Auditor/Replicator
  4. Add Storage Device to ring

Dashboard functionality:

  1. Basic dashboard setup and login
  2. Launch/terminate an instance with the dashboard
  3. Managing projects and users with the dashboard
  4. VNC access to instances through the dashboard

Extra credit:

  1. Tempest tests
  2. Build an image with Oz
  3. Smoke tests

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 or openstack-swift 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.

Basic setup:

User openstack-demo-install Add SSH keypair Register images Create nova network References
Sample User
none
Pass pass
Warning warn
[1]
Fail fail
[2]
  1. Test pass, but also encountered RHBZ #54321
  2. RHBZ #12345
Gary Kotton
Pass pass
Pass pass
[1]
Pass pass
[2]
  1. Missing package euca2ools, and old keystone syntax.
  2. Test pass, whilst in state SAVING command glance image-list takes a very long time (f16 image)
Jan van Eldik
Pass pass
[1]
Pass pass
Pass pass
[2] [3]
Pass pass
  1. Typo in openstack-status script RHBZ #858174
  2. Test pass, whilst in state SAVING command glance image-list takes a very long time (f16 image)
  3. upload of ami-tty leaves image in state "queued" (with size 0)
Pádraig Brady
Pass pass
[1]
Pass pass
[2]
  1. On an F17 VM
  2. Updated test to address issues mentioned by Gary Kotton
Nikola Đipanov
Pass pass
[1]
Pass pass
Warning warn
[2]
Pass pass
  1. On an F17 VM
  2. ami-tty shows size 0
Core functionality:
User Launch an instance Attach a volume Floating IPs Separate compute node References
Nova boot-from-volume:
User Create and boot from a bootable volume Create an image from a running volume-backed instance References
Quantum functionality:
User Configure and use a network topology in Quantum References
Swift functionality:
User Upload and download files Upload Segmented File Test Auditor/Replicator Add Storage Device to ring References
Dashboard functionality:
User Basic dashboard setup and login Launch/terminate an instance with the dashboard Managing projects and users with the dashboard VNC access to instances through the dashboard References
Extra credit:
User Tempest tests Build an image with Oz Smoke tests References