Configure controller node in OpenStack Installation Guide for Red Hat Enterprise Linux, CentOS, and Fedora - icehouse

[Kodiak Firesmith]

Current documentation for manual install of Neutron w/ ML2 plugin on RHEL is missing some steps that were prior thought to not be needed but have recently been confirmed to still be needed for a basic manual installation.

First missing steps are to configure (modify) the ml2 and router plugin lines in /etc/neutron/plugins/ml2/ml2_conf.ini:

(These steps should be added to the "To configure the Modular Layer 2 (ML2) plug-in" portion of the instructions)

openstack-config --set /etc/neutron/plugins/ml2/ml2_conf.ini ml2 \
core_plugin neutron.plugins.ml2.plugin.Ml2Plugin
(this is because the plugin cannot be referenced simply as 'ml2', if you leave it as 'ml2', neutron-db-manage will traceback)

openstack-config --set /etc/neutron/plugins/ml2/ml2_conf.ini ml2 \
service_plugins neutron.services.l3_router.l3_router_plugin.L3RouterPlugin
(this is because service_plugins cannot simply be 'router', if you leave it just as 'router', neutron-db-manage will traceback)

Example traceback saved here: http://paste.openstack.org/show/86759/

Now, during the "To finalize installation" portion of the docs, after the nova restarts, but *before* the neutron-server start, the user must execute:

# neutron-db-manage --config-file /etc/neutron/neutron.conf \
--config-file /etc/neutron/plugin.ini upgrade head

This will result in output like the following (which I've abbreviated...)

No handlers could be found for logger "neutron.common.legacy"
INFO [alembic.migration] Context impl MySQLImpl.
INFO [alembic.migration] Will assume non-transactional DDL.
INFO [alembic.migration] Running upgrade None -> folsom
INFO [alembic.migration] Running upgrade folsom -> 2c4af419145b
...
INFO [alembic.migration] Running upgrade 1341ed32cc1e -> grizzly
INFO [alembic.migration] Running upgrade grizzly -> f489cf14a79c
INFO [alembic.migration] Running upgrade f489cf14a79c -> 176a85fc7d79
...
INFO [alembic.migration] Running upgrade 49f5e553f61f -> 40b0aff0302e
INFO [alembic.migration] Running upgrade 40b0aff0302e -> havana
INFO [alembic.migration] Running upgrade havana -> e197124d4b9
...
INFO [alembic.migration] Running upgrade 538732fa21e1 -> 5ac1c354a051
INFO [alembic.migration] Running upgrade 5ac1c354a051 -> icehouse

With these steps, Neutron should work on RHEL via a manual installation (rather than packstack which does do these steps for the user already)

Big thanks to Jakub Libosvar and Ihar Hrachyshka @ Redhat for helping me limp through this rough patch in the process.

 - Kodiak Firesmith

-----------------------------------
Built: 2014-07-17T08:09:51 00:00
git SHA: 3144c8b2fabd57012d88fc9fd39d00c9cc64fb00
URL: http://docs.openstack.org/icehouse/install-guide/install/yum/content/neutron-ml2-controller-node.html
source File: file:/home/jenkins/workspace/openstack-manuals-tox-doc-publishdocs/doc/install-guide/section_neutron-ml2-controller-node.xml
xml:id: neutron-ml2-controller-node

[Matt Kassawara (ionosphere80)]

Pre-release Icehouse packages for RHEL required running the "neutron-db-manage" command, but not the release packages. I need to deploy OpenStack on RHEL to validate this issue.

[Kodiak Firesmith (kfiresmith)]

Hi Matt,
Sorry to be the bearer of bad news but our experience showed that the release RDO Icehouse packages still needed the step described in the bug report.

We observed this twice at our organization. Hopefully your tests can confirm this.

[Matt Kassawara (ionosphere80)]

I did not need to run the "neutron-db-manage" command in my lab before starting the neutron-server service.

[Matt Kassawara (ionosphere80)]

Given the sporadic nature of this issue, I think we should provide a note in the Icehouse guide about it.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: stable/icehouse
Review: https://review.openstack.org/118666

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/118666
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=b92739c8222aa7f1a6be577d728d8f1af9dbb6d9
Submitter: Jenkins
Branch: stable/icehouse

commit b92739c8222aa7f1a6be577d728d8f1af9dbb6d9
Author: Matthew Kassawara <email address hidden>
Date: Wed Sep 3 15:43:56 2014 +0000

    Add note about neutron-db-manage

    I added a note to cover occasional instances where users
    may need to run neutron-db-manage to populate the neutron
    database. I want to leave this note out of the Juno version
    for now.

    Change-Id: Ia80f8f8f3768467c59dab98e0e5569aeb211206e
    Closes-Bug: #1343277