neutron.conf needs lock_path set for router to operate

Bug #1796976 reported by Artur Ruta
20
This bug affects 2 people
Affects Status Importance Assigned to Milestone
neutron
Fix Released
Low
Sapna Jadhav

Bug Description

This bug tracker is for errors with the documentation, use the following as a template and remove or add fields as you see fit. Convert [ ] into [x] to check boxes:

- [X] This doc is inaccurate in this way: Using self-service network. Router fails to operate if lock_path is not set.
- [ ] This is a doc addition request.
- [ ] I have a fix to the document that I can paste below including example: input and output.

Detail:
- Rocky clean install followinf the self-service network model
- While creating the sample networks and router the following issues arise when running throug the verifications
    1) ip netns <-- shows qdhcp namespaces but no qrouter
    2) openstack port list --router router <-- shows the interdaces in down states
After researching the log files i see in /var/log/neutron/neutron-l3-agent.log that the required parameter lock_path is missing

I've edited the /etc/neutron/neutron.conf and in the [oslo_concurrency] have set
lock_path = /var/lib/neutron/tmp

After reinit:
- /var/log/neutron/neutron-l3-agent.log is clean,
- ip netns shows 2 qdhcp and one qrouter as expected
- openstack port list --router router <- Ports are shown as active

Therefore my guess is that neutron install guide should be updated to reflect this needed paramenter.

Thanks a lot in advance.

-----------------------------------
Release: on 2018-10-08 10:46
SHA: 6084f10333d7662a4f98994db49fd52bf9bf68f2
Source: https://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/install-guide/source/launch-instance-networks-selfservice.rst
URL: https://docs.openstack.org/install-guide/launch-instance-networks-selfservice.html

Chason Chan (chen-xing)
affects: openstack-manuals → neutron
Revision history for this message
Chason Chan (chen-xing) wrote :

Artur, Please check here: https://docs.openstack.org/neutron/latest/install/compute-install-rdo.html#configure-the-common-component
There is a step to configure the lock_path option. :)

Changed in neutron:
importance: Undecided → Low
status: New → Confirmed
tags: added: doc
tags: added: low-hanging-fruit
Revision history for this message
Artur Ruta (artur-ruta) wrote :

Thanks a lot!

Sapna Jadhav (sapana45)
Changed in neutron:
assignee: nobody → Sapna Jadhav (sapana45)
Revision history for this message
Artur Ruta (artur-ruta) wrote :

Hi,
Just found out that the docs are only partially corrected.
I was setting up the compute node following the self-service network model.
When trying to lauch an instance in the provider network it remained in build status until timeout 300 seconds was reached and then went to error status.
Digging in the logs i found that this was happening because nova never received notification that the virtual interface was plugged in with no apparent cause.
I also found in the neutron logs the same depicted before in this bug poiting to a missing lock_path parameter.
As set ip up as in the controller node and then the instance started with no issues.
Looking into the documentation web pages i found no all of them are updated. For example:
- https://docs.openstack.org/neutron/latest/install/compute-install-rdo.html#configure-the-common-component properly states the need for setting up the lock_path variable in the [oslo_concurrency] section
- https://docs.openstack.org/neutron/latest/install/compute-install-ubuntu.html which is the sama page but for ubuntu install still lacks that info...which leads to the behavior described above.
Could you please update it?

Thanks a lot in advance.

Revision history for this message
Sapna Jadhav (sapana45) wrote :

Sure @Artur.

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to neutron (master)

Fix proposed to branch: master
Review: https://review.openstack.org/612196

Changed in neutron:
status: Confirmed → In Progress
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to neutron (master)

Reviewed: https://review.openstack.org/612196
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=f4d438019e3bd2f9b6c64badb9533168e583d8af
Submitter: Zuul
Branch: master

commit f4d438019e3bd2f9b6c64badb9533168e583d8af
Author: SapanaJadhav <email address hidden>
Date: Sun Oct 21 21:46:32 2018 +0530

    neutron.conf needs lock_path set for router to operate
    This change is adding required configuration in neutron.conf
    to set the lock_path parameter, which was missing in
    compute-install-ubuntu.rst

    Change-Id: If090bdf060dfe21d11b1a5dfd010dc8167d9e45e
    Closes-Bug: #1796976

Changed in neutron:
status: In Progress → Fix Released
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix included in openstack/neutron 14.0.0.0b1

This issue was fixed in the openstack/neutron 14.0.0.0b1 development milestone.

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix proposed to neutron (master)

Related fix proposed to branch: master
Review: https://review.openstack.org/632316

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix merged to neutron (master)

Reviewed: https://review.openstack.org/632316
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=534e85039271d91647173527cd4c4905b9532537
Submitter: Zuul
Branch: master

commit 534e85039271d91647173527cd4c4905b9532537
Author: Lajos Katona <email address hidden>
Date: Tue Jan 22 09:42:51 2019 +0100

    Add lock_path in installation guide

    Oslo_concurrency needs lock_path option, make it consistent in
    documentation for Suse, Redhat and Ubuntu installation guides.

    Change-Id: Ib675d7bf399f2aa7eba9d343fa0f06281d33089a
    Related-Bug: #1796976
    Closes-Bug: #1812497

tags: added: pike-backport-potential queens-backport-potential rocky-backport-potential
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix proposed to neutron (stable/rocky)

Related fix proposed to branch: stable/rocky
Review: https://review.openstack.org/633169

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix merged to neutron (stable/rocky)

Reviewed: https://review.openstack.org/633169
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=573b0be3e86905853b104647ff237fae191eed0b
Submitter: Zuul
Branch: stable/rocky

commit 573b0be3e86905853b104647ff237fae191eed0b
Author: Lajos Katona <email address hidden>
Date: Tue Jan 22 09:42:51 2019 +0100

    Add lock_path in installation guide

    Oslo_concurrency needs lock_path option, make it consistent in
    documentation for Suse, Redhat and Ubuntu installation guides.

    Change-Id: Ib675d7bf399f2aa7eba9d343fa0f06281d33089a
    Related-Bug: #1796976
    Closes-Bug: #1812497
    (cherry picked from commit 534e85039271d91647173527cd4c4905b9532537)

tags: added: in-stable-rocky
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix proposed to neutron (stable/queens)

Related fix proposed to branch: stable/queens
Review: https://review.openstack.org/634680

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix merged to neutron (stable/queens)

Reviewed: https://review.openstack.org/634680
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=de9f813928d11b9048d0201caa3cbff60ccbf37b
Submitter: Zuul
Branch: stable/queens

commit de9f813928d11b9048d0201caa3cbff60ccbf37b
Author: Lajos Katona <email address hidden>
Date: Tue Jan 22 09:42:51 2019 +0100

    Add lock_path in installation guide

    Oslo_concurrency needs lock_path option, make it consistent in
    documentation for Suse, Redhat and Ubuntu installation guides.

    Change-Id: Ib675d7bf399f2aa7eba9d343fa0f06281d33089a
    Related-Bug: #1796976
    Closes-Bug: #1812497
    (cherry picked from commit 534e85039271d91647173527cd4c4905b9532537)
    (cherry picked from commit 573b0be3e86905853b104647ff237fae191eed0b)

tags: added: in-stable-queens
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix proposed to neutron (stable/pike)

Related fix proposed to branch: stable/pike
Review: https://review.openstack.org/636295

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix merged to neutron (stable/pike)

Reviewed: https://review.openstack.org/636295
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=6098f54722d849d1635436272a87146a273531ec
Submitter: Zuul
Branch: stable/pike

commit 6098f54722d849d1635436272a87146a273531ec
Author: Lajos Katona <email address hidden>
Date: Tue Jan 22 09:42:51 2019 +0100

    Add lock_path in installation guide

    Oslo_concurrency needs lock_path option, make it consistent in
    documentation for Suse, Redhat and Ubuntu installation guides.

    Change-Id: Ib675d7bf399f2aa7eba9d343fa0f06281d33089a
    Related-Bug: #1796976
    Closes-Bug: #1812497
    (cherry picked from commit 534e85039271d91647173527cd4c4905b9532537)
    (cherry picked from commit 573b0be3e86905853b104647ff237fae191eed0b)
    (cherry picked from commit de9f813928d11b9048d0201caa3cbff60ccbf37b)

tags: added: in-stable-pike
Revision history for this message
Realtime (peter-icb) wrote :
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to neutron (stable/rocky)

Fix proposed to branch: stable/rocky
Review: https://review.openstack.org/653004

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to neutron (stable/queens)

Fix proposed to branch: stable/queens
Review: https://review.openstack.org/653005

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to neutron (stable/pike)

Fix proposed to branch: stable/pike
Review: https://review.openstack.org/653006

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to neutron (stable/rocky)

Reviewed: https://review.openstack.org/653004
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=bdeae633651f5779ac5489532e96025af6c4c116
Submitter: Zuul
Branch: stable/rocky

commit bdeae633651f5779ac5489532e96025af6c4c116
Author: SapanaJadhav <email address hidden>
Date: Sun Oct 21 21:46:32 2018 +0530

    neutron.conf needs lock_path set for router to operate
    This change is adding required configuration in neutron.conf
    to set the lock_path parameter, which was missing in
    compute-install-ubuntu.rst

    Change-Id: If090bdf060dfe21d11b1a5dfd010dc8167d9e45e
    Closes-Bug: #1796976
    (cherry picked from commit f4d438019e3bd2f9b6c64badb9533168e583d8af)

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to neutron (stable/queens)

Reviewed: https://review.openstack.org/653005
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=8693aede0731061b30499920f04a4382cea39e16
Submitter: Zuul
Branch: stable/queens

commit 8693aede0731061b30499920f04a4382cea39e16
Author: SapanaJadhav <email address hidden>
Date: Sun Oct 21 21:46:32 2018 +0530

    neutron.conf needs lock_path set for router to operate
    This change is adding required configuration in neutron.conf
    to set the lock_path parameter, which was missing in
    compute-install-ubuntu.rst

    Change-Id: If090bdf060dfe21d11b1a5dfd010dc8167d9e45e
    Closes-Bug: #1796976
    (cherry picked from commit f4d438019e3bd2f9b6c64badb9533168e583d8af)

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to neutron (stable/pike)

Reviewed: https://review.openstack.org/653006
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=0561671125a97f375a2ea75a4bc8e509ec4067c7
Submitter: Zuul
Branch: stable/pike

commit 0561671125a97f375a2ea75a4bc8e509ec4067c7
Author: SapanaJadhav <email address hidden>
Date: Sun Oct 21 21:46:32 2018 +0530

    neutron.conf needs lock_path set for router to operate
    This change is adding required configuration in neutron.conf
    to set the lock_path parameter, which was missing in
    compute-install-ubuntu.rst

    Change-Id: If090bdf060dfe21d11b1a5dfd010dc8167d9e45e
    Closes-Bug: #1796976
    (cherry picked from commit f4d438019e3bd2f9b6c64badb9533168e583d8af)

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix included in openstack/neutron 13.0.4

This issue was fixed in the openstack/neutron 13.0.4 release.

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix included in openstack/neutron 12.1.0

This issue was fixed in the openstack/neutron 12.1.0 release.

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix included in openstack/neutron pike-eol

This issue was fixed in the openstack/neutron pike-eol release.

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Duplicates of this bug

Other bug subscribers