Editing Test Day:2013-04-02 OpenStack

{{Infobox_group
| name = OpenStack Test Day
| date = 2013-04-02
| time = all day
| irc = [irc://irc.freenode.net/#fedora-test-day #fedora-test-day] ([http://webchat.freenode.net/?channels=fedora-test-day, webirc])
}}


{{admon/note | 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 [http://bugzilla.redhat.com 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 [[QA/Test_Days|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 - [[User:Pbrady|Pbrady]] (pixelbeat)
* Development - [[User:Mrunge|Mrunge]] (mrunge)
* Development - [[User:Eglynn|Eglynn]] (eglynn)
* Development - [[User:Apevec|Apevec]] (apevec)
* Development - [[User:Gkotton|GKotton]] (garyk)
* Development - [[User:Eharney|eharney]] (eharney)
* Deployment - [[User:Vaneldik|Vaneldik]] (vaneldik), [[User:spstarr|spstarr]] (spstarr)
* Test - [[User:kashyapc|kashyapc]] (kashyap), [[User:spstarr|spstarr]] (spstarr)

== 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.
{{admon/note|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 19 test day, but we have OpenStack Grizzly packages available for both Fedora 19 and Fedora 18.
It would be advisable to download and install your Fedora 18 or Fedora 19 test systems before the test day if possible.

=== Fedora 19 ===
* [https://dl.fedoraproject.org/pub/alt/stage/ Fedora 19 Alpha live image] can be used to install a virtual machine.
* Currently bare metal installs are not supported [https://bugzilla.redhat.com/show_bug.cgi?id=928228 #928228]
* VMs should have at least 2G RAM and 16G disk made available [https://bugzilla.redhat.com/show_bug.cgi?id=928886 #928886]

Please record common Fedora 19 issues here:
* System doesn't boot after install until /run is manually created [https://bugzilla.redhat.com/show_bug.cgi?id=922988#c27 #922988]
* Screen blanking/locking can't be undone. So disable immediately on first boot [https://bugzilla.redhat.com/show_bug.cgi?id=923364 #923364]

* If you have an F18, machine, since F19 is branched, you can update to f19 using the below way:

 yum update yum; yum clean all ; yum --releasever=19 distro-sync --nogpgcheck -y;

=== Fedora 18 ===
[http://alt.fedoraproject.org/pub/alt/live-respins/ Recent Fedora 18 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 <span style="color:red;">your account</span> to sudoers, which can be done from a root prompt like:

  (umask 337; echo "<span style="color:red;">non_root_user</span> 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

=== SELinux ===

SELinux should work with OpenStack services.
If there are issues you can disable like:

 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:

* {{bz|123456}} general - ....

== Install and setup all Openstack services on a single node ==

'''Test day only''' Please use the official Fedora repositories otherwise
  sudo curl http://repos.fedorapeople.org/repos/openstack/openstack-grizzly/fedora-openstack-grizzly.repo -o /etc/yum.repos.d/fedora-openstack-grizzly.repo

So now the yum repositories are in place, so we'll install packstack.
This can install all OpenStack services on a single node, including:
nova, glance, quantum, cinder, swift, keystone, dashboard, ceilometer.
Note it configures and enables all but the quantum and ceilometer services at this time:
'''Packstack is not working on F19 https://bugzilla.redhat.com/show_bug.cgi?id=927298'''
  sudo yum install -y openstack-packstack
  sudo packstack --gen-answer-file=ans.txt
  # edit ans.txt as required
  sudo packstack --answer-file=ans.txt

'''packstack known issues : '''
  # packstack fails to start keystone, if you hit a keystone error during the packstack run, change the permission of the keystone log file and rerun packstack ([https://bugzilla.redhat.com/show_bug.cgi?id=946915 rhbz#946915])
  sudo chown keystone:keystone /var/log/keystone/keystone.log
  # if sometimes outputs an erorr when trying to start tdtd if this happens start it manually and rerun packstack
  sudo systemctl start tgtd

Alternatively one can use the openstack-demo-install script to do the install:

  sudo yum install -y openstack-utils
  sudo [https://github.com/fedora-openstack/openstack-utils/blob/master/utils/openstack-demo-install openstack-demo-install]

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 ~
  # or if using packstack
  sudo cp /root/keystonerc_admin ~

=== Known issues ===

== Setup OpenStack volumes ==

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

This is a commonly used service automatically setup by packstack.
If you ran openstack-demo-install instead please enable by following:

[[QA:Testcase_Create_Cinder_Volumes | 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.

[[Quantum | Enable Quantum networking]]

'''Note''' if packstack was used then you can use [[Packstack_to_Quantum | these]] instructions.

== Test Cases ==

Basic setup:

# [[QA:Testcase_add_SSH_keypair_to_OpenStack|Add SSH keypair]]
# [[QA:Testcase_register_images_with_OpenStack|Register guest images]]
# [[QA:Testcase_create_OpenStack_nova_network|Create nova network]]

Core functionality:

# [[QA:Testcase_launch_an_instance_on_OpenStack|Launch an instance]]
# [[QA:Testcase_attach_a_cinder_volume_to_an_instance|Attach a volume]]
# [[QA:Testcase_OpenStack_floating_IPs|Floating IPs]]
# [[QA:Testcase_separate_OpenStack_compute_node|Separate compute node]]

Nova boot-from-volume:

# [[QA:Testcase_Nova_Create_Builder_Instance | Create a builder instance]]
# [[QA:Testcase_Nova_Create_Bootable_Volume | Create and boot from a bootable volume]]
# [[QA:Testcase_Nova_Snapshot_Volume_Backed_Instance | Create an image from a running volume-backed instance]]

Quantum functionality:

# [[QA:Testcase_Quantum_V2#How_to_test | Configure and use a network topology in Quantum]]

Swift functionality:

# [[QA:Testcase_Swift_Upload_Download_Files | Upload and download files]]
# [[QA:Testcase_Swift_Upload_Large_File | Upload Segmented File]]
# [[QA:Testcase_Swift_Auditor_Replicator | Test Auditor/Replicator]]
# [[QA:Testcase_Swift_Add_Device | Add Storage Device to ring]]

Dashboard functionality:

# [[QA:Testcase_OpenStack_dashboard_setup|Basic dashboard setup and login]]
# [[QA:Testcase_OpenStack_dashboard_launch_instance|Launch/terminate an instance with the dashboard]]
# [[QA:Testcase_OpenStack_dashboard_add_users|Managing projects and users with the dashboard]]
# [[QA:Testcase_OpenStack_dashboard_vnc|VNC access to instances through the dashboard]]

Heat basic functionality (recommended for all developers):

# [[QA:Testcase_OpenStack_heat_setup|Basic heat setup and configuration]]
# [[QA:Testcase_OpenStack_heat_launch|Launch a basic wordpress stack]]
# [[QA:Testcase_OpenStack_heat_stop|Stop Heat services and uninstall Heat]]

Heat advanced functionality (recommended for all developers):

# [[QA:Testcase_OpenStack_heat_rununit|Run nose unit tests]]
# [[QA:Testcase_OpenStack_heat_run_WordPress_With_LB|Run Load Balancing testcase]]
# [[QA:Testcase_OpenStack_heat_run_WordPress_With_RDS|Run Relational Database service testcase]]
# [[QA:Testcase_OpenStack_heat_run_WordPress_Single_Instance_With_EIP|Run EIP testcase]]
# [[QA:Testcase_OpenStack_heat_run_WordPress_Single_Instance_With_EBS|Run EBS testcase]]
# [[QA:Testcase_OpenStack_heat_run_WordPress_Single_Instance_With_EBS_EIP|Run EBS and EIP testcase]]
# [[QA:Testcase_OpenStack_heat_run_WordPress_Single_Instance|Run Single Instance Wordpress testcase]]
# [[QA:Testcase_OpenStack_heat_run_Composed_Instances|Run Compsed Instances testcase]]
# [[QA:Testcase_OpenStack_heat_run_WordPress_2_Instances_With_EBS|Run 2 instance EBS testcase]]
# [[QA:Testcase_OpenStack_heat_run_WordPress_2_Instances_With_EBS_EIP|Run 2 instances with EBS and EIP]]
# [[QA:Testcase_OpenStack_heat_run_WordPress_2_Instances|Run 2 instance Wordpress testcase]]
# [[QA:Testcase_OpenStack_heat_run_HAProxy_Single_Instance|Run HAProxy Single Instance testcase]]
# [[QA:Testcase_OpenStack_heat_run_CFN_API_Actions|Run CFN API actions testcase]]
# [[QA:Testcase_OpenStack_heat_run_AutoScalingMultiAZSample|Run AutoScaling testcase]]

Ceilometer  functionality (recommended for all developers):

# [[QA:Testcase_OpenStack_ceilometer_install|Install ceilometer]]
# [[QA:Testcase_OpenStack_ceilometer_metering_glance|Enable metering of glance]]
# [[QA:Testcase_OpenStack_ceilometer_metering_nova|Enable metering of nova]]

Extra credit:

# [[QA:Testcase_run_Tempest_tests|Tempest tests]]
# [[QA:Testcase_build_an_OpenStack_guest_image_with_Oz|Build an image with Oz]]
# [[QA:Testcase_run_the_OpenStack_smoke_tests|Smoke tests]]

== Test Results ==

If you have problems with any of the tests, report a bug to [https://bugzilla.redhat.com Bugzilla] usually for one of the [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=18&component=openstack-nova openstack-nova], [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=18&component=openstack-glance openstack-glance], [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=18&component=openstack-keystone openstack-keystone], [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=18&component=openstack-cinder openstack-cinder],[https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=18&component=openstack-quantum openstack-quantum], [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=18&component=openstack-swift openstack-swift] or [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=18&component=openstack-heat openstack-heat] or [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=18&component=openstack-ceilometer openstack-ceilometer] 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 [[Template:result|result template]] to enter your result, as shown in the example result line.

Basic setup:

{|
! User
! openstack-demo-install
! [[QA:Testcase_Create_Cinder_Volumes|Create Cinder Volumes]]
! [[QA:Testcase_add_SSH_keypair_to_OpenStack|Add SSH keypair]]
! [[QA:Testcase_register_images_with_OpenStack|Register images]]
! [[QA:Testcase_create_OpenStack_nova_network|Create nova network]]
! References

|-
| [[User:SampleUser|Sample User]]
| {{result|none}}
| {{result|none}}
| {{result|pass}}
| {{result|warn}} <ref>Test pass, but also encountered {{bz|54321}}</ref>
| {{result|fail}} <ref>{{bz|12345}}</ref>
| <references/>
|-

|-
| [[User:rvaknin|Rami Vaknin]]
| {{result|none}} Packstack installation fails due to "/etc/init.d/xinetd reload" command that it runs
| {{result|none}}
| {{result|none}}
| {{result|none}}
| {{result|fail}} <ref>{{bz|947427}}</ref>
| <references/>
|-

|-
| [[User:rvaknin|Rami Vaknin]]
| {{result|none}} Packstack installation fails due to syntax error in /etc/httpd/conf.d/ssl.conf (Fedora bug)
| {{result|none}}
| {{result|none}}
| {{result|none}}
| {{result|fail}} <ref>{{bz|947421}}</ref>
| <references/>
|-

|-
| [[User:mrceresa|Mario Ceresa]]
| {{result|none}} Packstack on f18 VM<ref> It worked but encountered {{bz|947419}} </ref>
| {{result|pass}} <ref>was already configured</ref>
| {{result|pass}} <ref>credentials in keystonerc_admin no keystonerc</ref>
| {{result|warn}} 
* Directly register a Fedora 16 appliance image got stuck for more than 2h with no network activity on iftop
* tty images failed with "Could not resolve host: images.ansolabs.com; Name or service not known"
* Manually downloading a cirros image + glance add name=cirros is_public=true disk_format=qcow2 container_format=bare < cirros-0.3.0-x86_64-disk.img worked.
| {{result|pass}} 
| <references/>
|-


{|
! User
! [[QA:Testcase_launch_an_instance_on_OpenStack|Launch an instance]]
! [[QA:Testcase_attach_a_cinder_volume_to_an_instance|Attach a volume]]
! [[QA:Testcase_OpenStack_floating_IPs|Floating IPs]]
! [[QA:Testcase_separate_OpenStack_compute_node|Separate compute node]]
! References
|-

|-
| [[User:mrceresa|Mario Ceresa]]
| {{result|pass}} <ref>If you get a wrong ip on the instance, remember to check if packstack silently configured an additional network</ref>
| {{result|fail}} <ref>{{bz|947463}}</ref>
| {{result|none}} 
| {{result|warn}} Should update the test case page: lokkit does not work with firewallD
| <references/>
|-




Core functionality:


{|
! User
! [[QA:Testcase_Nova_Create_Builder_Instance | Create a builder instance]]
! [[QA:Testcase_Nova_Create_Bootable_Volume | Create and boot from a bootable volume]]
! [[QA:Testcase_Nova_Snapshot_Volume_Backed_Instance | Create an image from a running volume-backed instance]]
! References
|-

Nova boot-from-volume:

{|
! User
! [[QA:Testcase_Quantum_V2#How_to_test | Configure and use a network topology in Quantum]]
! References
|-

Quantum functionality:


{|
! User
! [[QA:Testcase_Swift_Upload_Download_Files | Upload and download files]]
! [[QA:Testcase_Swift_Upload_Large_File | Upload Segmented File]]
! [[QA:Testcase_Swift_Auditor_Replicator | Test Auditor/Replicator]]
! [[QA:Testcase_Swift_Add_Device | Add Storage Device to ring]]
! References
|-
Swift functionality:

{|
! User
! [[QA:Testcase_OpenStack_dashboard_setup|Basic dashboard setup and login]]
! [[QA:Testcase_OpenStack_dashboard_launch_instance|Launch/terminate an instance with the dashboard]]
! [[QA:Testcase_OpenStack_dashboard_add_users|Managing projects and users with the dashboard]]
! [[QA:Testcase_OpenStack_dashboard_vnc|VNC access to instances through the dashboard]]
! References
|-
Dashboard functionality:

{|
! User
! [[QA:Testcase_OpenStack_heat_setup|Basic heat setup and login]]
! [[QA:Testcase_OpenStack_heat_launch|Launch a basic wordpress stack]]
! [[QA:Testcase_OpenStack_heat_stop|Stop Heat services and uninstall Heat]]
! References
|-

|-
heat functionality:

{|
! User
! [[QA:Testcase_OpenStack_ceilometer_install|Install ceilometer]]
! [[QA:Testcase_OpenStack_ceilometer_metering_glance|Enable metering of glance]]
! [[QA:Testcase_OpenStack_ceilometer_metering_nova|Enable metering of nova]]
! References
|-
Ceilometer functionality:


{|
! User
! [[QA:Testcase_run_Tempest_tests|Tempest tests]]
! [[QA:Testcase_build_an_OpenStack_guest_image_with_Oz|Build an image with Oz]]
! [[QA:Testcase_run_the_OpenStack_smoke_tests|Smoke tests]]
! References

|-
Extra credit:

[[Category:Test Days]]
[[Category:OpenStack]]