Select hosts where instances are launched in Administrator Guide

[Matt Riedemann]

- [x] This doc is inaccurate in this way:

The doc has a note which says:

"HOST is an optional parameter. In such cases, use the --availability-zone ZONE::NODE."

It fails to mention that NODE is also optional, as seen in the parsing code in the compute API:

https://github.com/openstack/nova/blob/15.0.0/nova/compute/api.py#L525

So you can have:

1. --availability-zone ZONE (no host or node)
2. --availabllity-zone ZONE:HOST (no node)
3. --availability-zone ZONE::NODE (no host)
4. --availability-zone ZONE:HOST:NODE

-----------------------------------
Release: 0.9 on 2017-03-15 13:28
SHA: 93c84538179c2a73d311e6e485eb1b5b12c4ee9d
Source: https://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/admin-guide/source/cli-nova-specify-host.rst
URL: https://docs.openstack.org/admin-guide/cli-nova-specify-host.html

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/446281
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=2171464e0f06851930eafe5845fb7f346b610883
Submitter: Jenkins
Branch: master

commit 2171464e0f06851930eafe5845fb7f346b610883
Author: chenxing <[e-mail]>
Date: Thu Mar 16 02:27:50 2017 +0000

    [admin-guide] Fix the inaccurate description

    Change-Id: I639c79ba2ddd9282482f0fdfb3bdcda2184286d2
    Closes-Bug: #1673252

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/448156
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=9696ec9310051263add71f94464c7edc6b02a332
Submitter: Jenkins
Branch: master

commit 9696ec9310051263add71f94464c7edc6b02a332
Author: Matt Riedemann <email address hidden>
Date: Tue Mar 21 11:25:37 2017 -0400

    Fix note on specifying a specific host for nova

    The parsing goes like this in Nova:

    1. --availability-zone ZONE (no host or node)
    2. --availabllity-zone ZONE:HOST (no node)
    3. --availability-zone ZONE::NODE (no host)
    4. --availability-zone ZONE:HOST:NODE

    So we need to fix the docs to match case #2.

    Change-Id: Iedb8d221d0a33f18a7e4e10dff7b35823eef90a7
    Closes-Bug: #1673252

[OpenStack Infra (hudson-openstack)]

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