Jump to: navigation, search

Difference between revisions of "JunoDocTesting"

(Install Guide)
 
(47 intermediate revisions by 4 users not shown)
Line 2: Line 2:
 
style="color: black" | [[File:Warning.svg|15px]]           
 
style="color: black" | [[File:Warning.svg|15px]]           
 
-->
 
-->
==Install Guide==
+
 
To test the install guide, follow the install guide for your distribution (from http://docs.openstack.org/trunk/) exactly without deviation, and update the table - lodging bugs in http://bugs.launchpad.net/openstack-manuals as necessary.
+
<big><span style="color:red">*** Deprecated ***</span></big>
 +
 
 +
== Install Guide ==
 +
To test the install guide, follow the [http://docs.openstack.org/trunk/ instructions] for your distribution exactly and update the table. If you come across an issue, search for an existing bug on [http://bugs.launchpad.net/openstack-manuals Launchpad] and open a new bug if necessary. Also, provide a link to your bug in the "Issues" section below the table.
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! Section !! CentOS 6.5 !! RHEL 6.5 !! Scientific 6.5 !! Fedora 20 !! RHEL 7 !! openSUSE 13.1 !! SLES 11 ||  Debian 7 !! Ubuntu 14.04
+
! Section !! RHEL 7 !! CentOS/Scientific 7 !! Fedora 20 !! openSUSE 13.1 !! SLES 11 !! Debian 7 !! Ubuntu 14.04
 
|-
 
|-
| Overview and architecture ||style="color: black" |  [[File:Warning.svg|15px]]          ||style="color: black" | [[File:Warning.svg|15px]]    ||style="color: black" |  [[File:Warning.svg|15px]]            ||style="color: black" |  [[File:Warning.svg|15px]]  || style="color: black" |  [[File:Warning.svg|15px]]          ||style="color: black" |  [[File:Warning.svg|15px]]      ||style="color: black" |  [[File:Warning.svg|15px]]    ||style="color: black" |  [[File:Warning.svg|15px]]   ||style="color: black" |  [[File:Warning.svg|15px]]
+
| Overview and architecture || style="color: green" |  || style="color: green" |  || style="color: green" |  || style="color: green" |  ✔    || style="color: green" |  ✔    || style="color: green" |    ||style="color: green" | 
 
|-
 
|-
| Basic Operating System Configuration || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] ||style="color: black" |  [[File:Warning.svg|15px]]  ||style="color: black" |  [[File:Warning.svg|15px]] ||style="color: black" |  [[File:Warning.svg|15px]]   ||style="color: black" |  [[File:Warning.svg|15px]]   || style="color: black" | [[File:Warning.svg|15px]]  || style="color: black" | [[File:Warning.svg|15px]]
+
| Basic environment || style="color: green" |  || style="color: green" |  || style="color: green" |  || style="color: green" |    || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]]  || style="color: green" |
 
|-
 
|-
| Configuring the Identity Service  || style="color: black" | [[File:Warning.svg|15px]] ||style="color: black" |  [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]]  || [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]]  || style="color: black" | [[File:Warning.svg|15px]]
+
| Identity || style="color: orange" | || style="color: orange" |  || style="color: orange" | || style="color: green" |  ✚rc1 ||  [[File:Warning.svg|15px]] || style="color: green" |  ✔  || style="color: green" | 
 
|-
 
|-
| Install and Configure OpenStack Clients ||style="color: black" | [[File:Warning.svg|15px]]    || style="color: black" |  [[File:Warning.svg|15px]]  || style="color: black" |  [[File:Warning.svg|15px]] ||style="color: black" |  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]]
+
| Image Service || style="color: green" |  || style="color: green" |  || style="color: green" |  || style="color: red" | ||  [[File:Warning.svg|15px]] || style="color: green" |  || style="color: green" | 
 
|-
 
|-
| Configuring the Image Service  || style="color: black" | [[File:Warning.svg|15px]] ||style="color: black" | [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]]    ||[[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]] ||style="color: black" |  [[File:Warning.svg|15px]]  || style="color: black" | [[File:Warning.svg|15px]]
+
| Compute || style="color: green" | || style="color: green" |  || style="color: green" |  || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: green" |  ✔  || style="color: green" | 
 
|-
 
|-
| Configuring the Compute Services  || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]]|| style="color: black" | [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]]  || style="color: black" | [[File:Warning.svg|15px]]
+
| Nova-network || style="color: green" | || style="color: green" | || style="color: green" |  || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]]|| [[File:Warning.svg|15px]] || style="color: green" | 
 
|-
 
|-
| ...using Legacy Networking || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]]|| style="color: black" |  [[File:Warning.svg|15px]]  || style="color: black" | [[File:Warning.svg|15px]]
+
| Networking (neutron) || style="color: orange" | || style="color: orange" |  || style="color: orange" | || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]]|| [[File:Warning.svg|15px]] || style="color: green" | 
 
|-
 
|-
| ...using Neutron ML2 || style="color: black" | [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]]  || [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]]|| style="color: black" |  [[File:Warning.svg|15px]]  || style="color: black" | [[File:Warning.svg|15px]]
+
| Dashboard  || style="color: green" | || style="color: green" | || style="color: orange" | || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: green" |  || style="color: green" |
 
|-
 
|-
| Adding a Dashboard  || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] ||[[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]]
+
| Block Storage || style="color: orange" | || style="color: orange" | || style="color: orange" | || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: green" |
 
|-
 
|-
| Adding Block Storage ||style="color: black" |  [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]]||  [[File:Warning.svg|15px]]  ||  style="color: black" |  [[File:Warning.svg|15px]]  ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]]  || [[File:Warning.svg|15px]]
+
| Object Storage || style="color: orange" |  || style="color: orange" |  || style="color: orange" |  ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: orange" | 
 
|-
 
|-
| Adding Object Storage || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]]  || [[File:Warning.svg|15px]]  ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]]
+
| Heat || style="color: green" | || style="color: green" | || style="color: green" | ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]]  || style="color: green" |
 
|-
 
|-
| Using Heat  ||[[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]]  ||  [[File:Warning.svg|15px]]  ||  style="color: black" |  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: black" |  [[File:Warning.svg|15px]]  || [[File:Warning.svg|15px]]
+
| Ceilometer || [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]]  ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: green" | 
 
|-
 
|-
| Using Ceilometer || [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]]  ||  [[File:Warning.svg|15px]]  ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]]
+
| Trove ||  [[File:Warning.svg|15px]]  ||  [[File:Warning.svg|15px]]  ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: red" |
 
|-
 
|-
| Using Trove  || [[File:Warning.svg|15px]] ||  style="color: black" | [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]]
+
| Launch instance (Nova-network) || style="color: green" |  || style="color: green" || style="color: green" ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: green" |
 
|-
 
|-
| Overall Guide || [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]]  ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || style="color: black" | [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]]
+
| Launch instance (Networking) ||  style="color: green" |  ✔  || style="color: green" | || style="color: green" | ✔ ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: green" |
 +
|-
 +
| Overall Guide ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] ||  [[File:Warning.svg|15px]] || style="color: red" | ✗ ||  [[File:Warning.svg|15px]] || [[File:Warning.svg|15px]] || style="color: red" | ✗
 
|}
 
|}
  
[[File:Warning.svg|15px]] doc not tested
+
[[File:Warning.svg|15px]] Untested <br />
<span style="color: red"> ✗has some failures</span>
+
<span style="color: red">✗ = One or more issues - Please describe below</span><br />
<span style="color: green"> ✔ tested 100% OK</span>
+
<span style="color: green">✚X = Verified with milestone(x) or release candidate(rcX)</span><br />
<span style="color: green"> ✚X tested OK with release candidate(rcX)/milestone(X)</span>
+
<span style="color: orange">✚X = Implemented workaround, verified with milestone(x) or release candidate(rcX)</span><br />
N/A - not available for this distribution
+
<span style="color: green">✔ = Verified with official release</span><br />
 +
<span style="color: orange">✔ = Implemented workaround, verified with official release</span><br />
 +
N/A = not available for this distribution
 +
 
 +
=== Issues ===
 +
 
 +
Please describe issues at [[Documentation/InstallationGuideJuno]] and include bug numbers as necessary.
 +
 
 +
==== General SLES/openSUSE ====
 +
Numerous small issues. See [https://review.openstack.org/#/q/status:open+project:openstack/openstack-manuals,n,z patches].
 +
 
 +
==== Basic Environment on Ubuntu ====
 +
* <strike>The 'add-apt-repository cloud-archive:juno' command does not work yet. See [https://bugs.launchpad.net/bugs/1362521 bug] and [https://review.openstack.org/#/c/129642/ workaround].</strike>
 +
 
 +
==== Keystone on RHEL/CentOS/Fedora ====
 +
* The default (dist) configuration uses deprecated [token] "provider" and "driver" options in keystone.conf. See [https://review.openstack.org/#/c/131832/ workaround].
 +
 
 +
==== Glance on SLES/openSUSE ====
 +
* Default "notification_driver = messaging" option in glance-api.conf causes AMQP errors without further configuration. Glance only uses AMQP with ceilometer and the ceilometer agent configuration includes the appropriate glance options. Consider commenting out this option. See [https://bugs.launchpad.net/glance/+bug/1379775 bug].
 +
 
 +
==== Nova Compute ====
 +
* Nova compute looks for utilities provided by the "sysfsutils" packages when using cinder volumes with instances. However, the nova compute package does not install this package as a dependency. See [https://review.openstack.org/#/c/131832/ workaround].
 +
 
 +
==== Horizon on RHEL/CentOS/Fedora ====
 +
* CSS fails to render because default permissions of /usr/share/openstack-dashboard/static deny write access by the web server user (apache). See [https://bugzilla.redhat.com/show_bug.cgi?id=1150678 bug] and [https://review.openstack.org/#/c/127738/ workaround]. Perhaps fixed in release packages on RHEL/CentOS? Need to try a release installation on Fedora.
 +
 
 +
==== Horizon on Ubuntu ====
 +
* <strike>CSS fails to render unless "DEBUG = True". See [https://bugs.launchpad.net/ubuntu/+source/horizon/+bug/1379761 bug] and [https://review.openstack.org/#/c/127852/ workaround].</strike>
 +
 
 +
==== General neutron ====
 +
* The L3 agent may depend on the "conntrack" utility for L3 HA and/or DVR, but packages don't install it as a dependency. See [https://bugs.launchpad.net/ubuntu/+source/neutron/+bug/1380751 bug].
 +
 
 +
==== Neutron on Ubuntu ====
 +
* <strike>The "neutron-server" RC2 package requires running the "neutron-db-manage" script to populate database.</strike>
 +
 
 +
==== Neutron on RHEL/CentOS/Fedora ====
 +
* <strike>Security groups use "ipset" utility, but packages don't install it as a dependency.</strike>
 +
 
 +
==== Cinder on Ubuntu ====
 +
* <strike>An error in the "cinder_sudoers" file breaks privileged cinder-volume commands. See [https://bugs.launchpad.net/ubuntu/+source/cinder/+bug/1380425 bug] and [https://review.openstack.org/#/c/128036/ workaround].</strike>
 +
 
 +
==== Cinder on RHEL/CentOS/Fedora ====
 +
* The "openstack-cinder" package needs the "python-oslo-db" packages, but does not install it. See [https://bugzilla.redhat.com/show_bug.cgi?id=1152350 bug] and [https://review.openstack.org/#/c/128152/ workaround].
 +
 
 +
==== Swift on RHEL/CentOS/Fedora/Ubuntu ====
 +
* The packages include ancient configuration files with deprecated/defunct options. The guide sources upstream configuration files as a workaround.
 +
 
 +
==== Trove on Ubuntu ====
 +
* The Cloud archive repository only includes Icehouse (2014.1) packages. Contacting Chuck Short for more information.
 +
 
 +
==Config Reference==
 +
 
 +
 
 +
{| class="wikitable"
 +
|-
 +
! Section !! Updated?
 +
|-
 +
| ceilometer ||style="color: black" |  [[File:Warning.svg|15px]]   
 +
|-
 +
| cinder ||style="color: black" |  [[File:Warning.svg|15px]]   
 +
|-
 +
| glance ||style="color: black" |  [[File:Warning.svg|15px]]   
 +
|-
 +
| heat ||style="color: black" |  [[File:Warning.svg|15px]]   
 +
|-
 +
| keystone ||style="color: black" |  [[File:Warning.svg|15px]]   
 +
|-
 +
| neutron ||style="color: black" |  [[File:Warning.svg|15px]]   
 +
|-
 +
| nova ||style="color: black" |  [[File:Warning.svg|15px]]   
 +
|-
 +
| swift ||style="color: black" |  [[File:Warning.svg|15px]]   
 +
|-
 +
| trove ||style="color: black" |  [[File:Warning.svg|15px]]   
 +
|-
 +
| firewalls and default ports ||style="color: black" |  [[File:Warning.svg|15px]]   
 +
|}
  
 +
[[File:Warning.svg|15px]] = Not updated<br />
 +
<span style="color: green"> ✚X = Verified with milestone(x) or release candidate(rcX)</span><br />
 +
<span style="color: green"> ✔ = Verified with official release</span><br />
  
 
----
 
----
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Latest revision as of 23:53, 22 September 2015


*** Deprecated ***

Install Guide

To test the install guide, follow the instructions for your distribution exactly and update the table. If you come across an issue, search for an existing bug on Launchpad and open a new bug if necessary. Also, provide a link to your bug in the "Issues" section below the table.

Section RHEL 7 CentOS/Scientific 7 Fedora 20 openSUSE 13.1 SLES 11 Debian 7 Ubuntu 14.04
Overview and architecture
Basic environment Warning.svg Warning.svg
Identity ✚rc1 Warning.svg
Image Service Warning.svg
Compute Warning.svg Warning.svg
Nova-network Warning.svg Warning.svg Warning.svg
Networking (neutron) Warning.svg Warning.svg Warning.svg
Dashboard Warning.svg Warning.svg
Block Storage Warning.svg Warning.svg Warning.svg
Object Storage Warning.svg Warning.svg Warning.svg
Heat Warning.svg Warning.svg Warning.svg
Ceilometer Warning.svg Warning.svg Warning.svg Warning.svg Warning.svg Warning.svg
Trove Warning.svg Warning.svg Warning.svg Warning.svg Warning.svg Warning.svg
Launch instance (Nova-network) Warning.svg Warning.svg Warning.svg
Launch instance (Networking) Warning.svg Warning.svg Warning.svg
Overall Guide Warning.svg Warning.svg Warning.svg Warning.svg Warning.svg

Warning.svg Untested
✗ = One or more issues - Please describe below
✚X = Verified with milestone(x) or release candidate(rcX)
✚X = Implemented workaround, verified with milestone(x) or release candidate(rcX)
✔ = Verified with official release
✔ = Implemented workaround, verified with official release
N/A = not available for this distribution

Issues

Please describe issues at Documentation/InstallationGuideJuno and include bug numbers as necessary.

General SLES/openSUSE

Numerous small issues. See patches.

Basic Environment on Ubuntu

  • The 'add-apt-repository cloud-archive:juno' command does not work yet. See bug and workaround.

Keystone on RHEL/CentOS/Fedora

  • The default (dist) configuration uses deprecated [token] "provider" and "driver" options in keystone.conf. See workaround.

Glance on SLES/openSUSE

  • Default "notification_driver = messaging" option in glance-api.conf causes AMQP errors without further configuration. Glance only uses AMQP with ceilometer and the ceilometer agent configuration includes the appropriate glance options. Consider commenting out this option. See bug.

Nova Compute

  • Nova compute looks for utilities provided by the "sysfsutils" packages when using cinder volumes with instances. However, the nova compute package does not install this package as a dependency. See workaround.

Horizon on RHEL/CentOS/Fedora

  • CSS fails to render because default permissions of /usr/share/openstack-dashboard/static deny write access by the web server user (apache). See bug and workaround. Perhaps fixed in release packages on RHEL/CentOS? Need to try a release installation on Fedora.

Horizon on Ubuntu

  • CSS fails to render unless "DEBUG = True". See bug and workaround.

General neutron

  • The L3 agent may depend on the "conntrack" utility for L3 HA and/or DVR, but packages don't install it as a dependency. See bug.

Neutron on Ubuntu

  • The "neutron-server" RC2 package requires running the "neutron-db-manage" script to populate database.

Neutron on RHEL/CentOS/Fedora

  • Security groups use "ipset" utility, but packages don't install it as a dependency.

Cinder on Ubuntu

  • An error in the "cinder_sudoers" file breaks privileged cinder-volume commands. See bug and workaround.

Cinder on RHEL/CentOS/Fedora

  • The "openstack-cinder" package needs the "python-oslo-db" packages, but does not install it. See bug and workaround.

Swift on RHEL/CentOS/Fedora/Ubuntu

  • The packages include ancient configuration files with deprecated/defunct options. The guide sources upstream configuration files as a workaround.

Trove on Ubuntu

  • The Cloud archive repository only includes Icehouse (2014.1) packages. Contacting Chuck Short for more information.

Config Reference

Section Updated?
ceilometer Warning.svg
cinder Warning.svg
glance Warning.svg
heat Warning.svg
keystone Warning.svg
neutron Warning.svg
nova Warning.svg
swift Warning.svg
trove Warning.svg
firewalls and default ports Warning.svg

Warning.svg = Not updated
✚X = Verified with milestone(x) or release candidate(rcX)
✔ = Verified with official release