From 060bde0235c549fcd9dba54cb0690d6206ebe6fe Mon Sep 17 00:00:00 2001
From: Giridhar Jayavelu <gjayavelu@vmware.com>
Date: Wed, 14 Sep 2016 12:18:11 -0700
Subject: [PATCH] Fix format for availability zone

The format for the value passed for --availability-zone parameter
is incomplete and the example command is incorrect.

Change-Id: Id4eb9668e3e10b784690a47e604a2b406561a194
Fixes-Bug: #1600618
---
 .../source/cli-nova-specify-host.rst          | 42 +++++++++++++++++--
 1 file changed, 39 insertions(+), 3 deletions(-)

diff --git a/doc/admin-guide/source/cli-nova-specify-host.rst b/doc/admin-guide/source/cli-nova-specify-host.rst
index 75da5fd33e..0c3943bf48 100644
--- a/doc/admin-guide/source/cli-nova-specify-host.rst
+++ b/doc/admin-guide/source/cli-nova-specify-host.rst
@@ -7,7 +7,7 @@ host instances are launched on and which roles can boot instances
 on this host.
 
 #. To select the host where instances are launched, use
-   the :option:`--availability-zone ZONE:HOST` parameter on the
+   the :option:`--availability-zone ZONE:HOST:NODE` parameter on the
    :command:`openstack server create` command.
 
    For example:
@@ -15,15 +15,51 @@ on this host.
    .. code-block:: console
 
       $ openstack server create --image IMAGE --flavor m1.tiny \
-        --key-name KEY --availability-zone ZONE:HOST \
+        --key-name KEY --availability-zone ZONE:HOST:NODE \
         --nic net-id=UUID SERVER
 
+
+   .. note::
+      HOST is an optional parameter. In such cases,
+      use the :option:`--availability-zone ZONE::NODE`.
+
+
 #. To specify which roles can launch an instance on a
    specified host, enable the ``create:forced_host`` option in
    the ``policy.json`` file. By default, this option is
-   enabled for only the admin role.
+   enabled for only the admin role. If you see ``Forbidden (HTTP 403)``
+   in return, then you are not using admin credentials.
+
+
+#. To view the list of valid zones, use the
+   :command:`openstack availability zone list` command.
+
+   .. code-block:: console
+
+      $ openstack availability zone list
+      +-----------+-------------+
+      | Zone Name | Zone Status |
+      +-----------+-------------+
+      | zone1     | available   |
+      | zone2     | available   |
+      +-----------+-------------+
+
 
 #. To view the list of valid compute hosts, use the
+   :command:`openstack host list` command.
+
+   .. code-block:: console
+
+      $ openstack host list
+      +----------------+-------------+----------+
+      | Host Name      | Service     | Zone     |
+      +----------------+-------------+----------+
+      | compute01      | compute     | nova     |
+      | compute02      | compute     | nova     |
+      +----------------+-------------+----------+
+
+
+#. To view the list of valid compute nodes, use the
    :command:`openstack hypervisor list` command.
 
    .. code-block:: console