neutron.conf needs lock_path set for router to operate

[Artur Ruta]

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)]

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. :)

[Artur Ruta (artur-ruta)]

Thanks a lot!

[Artur Ruta (artur-ruta)]

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.

[Sapna Jadhav (sapana45)]

Sure @Artur.

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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)

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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)

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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)

[Realtime (peter-icb)]

This bug ist still here:
https://docs.openstack.org/neutron/rocky/install/compute-install-ubuntu.html

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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)

[OpenStack Infra (hudson-openstack)]

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)

[OpenStack Infra (hudson-openstack)]

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)

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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