console: add serial console module

[OpenStack Infra]

https://review.openstack.org/116582
commit 5cfe77a2f43bd6ed9514c2afe670cc9eedb9edf6
Author: Sahid Orentino Ferdjaoui <email address hidden>
Date: Mon Aug 25 12:37:11 2014 +0000

    console: add serial console module

    Adds new module console/serial.py to handle configuration
    and TCP ports management for the feature serial-ports.

    Co-Authored-By: Vladan Popovic <email address hidden>
    Co-Authored-By: Ian Wells <email address hidden>
    Co-Authored-By: Sushma Korati <email address hidden>

    DocImpact: new group of option 'serial_console'
    Partial-Implements: blueprint serial-ports
    Change-Id: Icb7f3569a29a5fab9aaa3a2d441f5fe4e5b55b9f

[Tom Fifield (fifieldt)]

great blog post on how to do this here: http://blog.oddbit.com/2014/12/22/accessing-the-serial-console-of-your-nova-servers/

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/149533
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=44b0f54298f21a1efaded6110542a488aa3ecf07
Submitter: Jenkins
Branch: master

commit 44b0f54298f21a1efaded6110542a488aa3ecf07
Author: Joseph Robinson <email address hidden>
Date: Fri Jan 23 18:35:19 2015 +1000

    Serial Console Procedure

    Adding a procedure for setting up and configuring
    access to the Serial Console, allowing users to
    access nova servers.

    Change-Id: I2427f94d60cc5a4b8425312fadb8266e11017160
    backport: none
    Closes-Bug: #1363954
    Co-Authored-By: Matt Kassawara <email address hidden>

[Matt Kassawara (ionosphere80)]

Andreas,

Can you update the config-reference scripts?

[Tony Breeds (o-tony)]

While trying to simplify the developer docs in devstack and nova we see that [1] links to [2]

I noticed 2 issues that appear to be somewhat related to this bug:

1) Some of the 'serial_console' options are not present in table 3.52. serial_console options from from
 nova/console/serial.py and nova/cmd/serial-proxy.py It looks to me that that options from serial-proxy.py are missing.

2) There is no way to directly link to a table on that page[2].

[1]: http://docs.openstack.org/developer/nova/devref/testing/serial-console.html
[2]: http://docs.openstack.org/trunk/config-reference/content/list-of-compute-config-options.html

[Matt Kassawara (ionosphere80)]

Andreas,

Apparently these options also apply to Juno.

[Andreas Jaeger (jaegerandi)]

Gauvain is the current config reference master - but anybody can do this as well...

[Gauvain Pocentek (gpocentek)]

The /cmd/ folders are explicitly excluded from the folders parsed by our autohelp.py script, because the scripts in these folders usually only bring command-line options.

But it looks like nova/cmd/serialproxy.py is an exception to this rule. I'll update autohelp.py to handle this file.

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/157514
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=89b0c506f45b2837882165a5bfe7982ba3d8667c
Submitter: Jenkins
Branch: master

commit 89b0c506f45b2837882165a5bfe7982ba3d8667c
Author: Gauvain Pocentek <email address hidden>
Date: Thu Feb 19 21:14:33 2015 +0100

    Update nova reference tables

    Change-Id: I004a7280ba686028bc5afab754cdb01e58d8a1fe
    Closes-Bug: #1363954

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/157513
Committed: https://git.openstack.org/cgit/openstack/openstack-doc-tools/commit/?id=3d2f91cf8efe68a11965f2328874418966d018d5
Submitter: Jenkins
Branch: master

commit 3d2f91cf8efe68a11965f2328874418966d018d5
Author: Gauvain Pocentek <email address hidden>
Date: Thu Feb 19 21:06:24 2015 +0100

    autohelp: don't ignore cmd/ folders

    These folders used to bring command line options that we don't want to
    have in the generated tables, but the behavior has changed. This patch
    restores the import of files in the cmd/ folders, and handles special
    cases where the import is problematic.

    Change-Id: I0779e0f689d2f6f64149c3d111a8dd1ecd6cfc20
    Partial-Bug: #1363954

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/openstack-manuals 15.0.0 release.