Incorrect commands for adding Gluon service to Keystone

[Jin Li]

The instructions in the appendix of doc/source/devref/gluon-auth.rst, adding Gluon service to Keystone are incorrect. Here is an example of the error:

ubuntu@Devstack:~/devstack$ openstack user create --name gluon --pass <pw>
usage: openstack user create [-h] [-f {json,shell,table,value,yaml}]
                             [-c COLUMN] [--max-width <integer>] [--noindent]
                             [--prefix PREFIX] [--project <project>]
                             [--password <password>] [--password-prompt]
                             [--email <email-address>] [--enable | --disable]
                             [--or-show]
                             <name>
openstack user create: error: ambiguous option: --pass could match --password, --password-prompt

ubuntu@Devstack:~/devstack$ openstack user role add --user gluon --tenant service --role admin
openstack: 'user' is not an openstack command. See 'openstack --help'.
Did you mean one of these?
  user create
  user delete
  user list
  user role list
  user set
  user show
  router create
  router delete
  router list
  router set
  router show
  subnet delete
  subnet list
  subnet pool delete
  subnet pool list
  subnet pool show
  subnet show

ubuntu@Devstack:~/devstack$ openstack service create --name gluon --type network --description "Gluon"
usage: openstack service create [-h] [-f {json,shell,table,value,yaml}]
                                [-c COLUMN] [--max-width <integer>]
                                [--noindent] [--prefix PREFIX] [--name <name>]
                                [--description <description>]
                                <type>
openstack service create: error: argument --type: not allowed with argument --name

ubuntu@Devstack:~/devstack$ openstack endpoint create —publicurl http://192.168.56.102:2705 \
> —adminurl http://192.168.56.102:2705 —internalurl http://192.168.56.102:2705 \
> —region regionOne gluon
Traceback (most recent call last):
  File "/usr/local/bin/openstack", line 11, in <module>
    sys.exit(main())
  File "/usr/local/lib/python2.7/dist-packages/openstackclient/shell.py", line 450, in main
    argv = map(lambda arg: arg.decode(encoding), argv)
  File "/usr/local/lib/python2.7/dist-packages/openstackclient/shell.py", line 450, in <lambda>
    argv = map(lambda arg: arg.decode(encoding), argv)

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/474812
Committed: https://git.openstack.org/cgit/openstack/gluon/commit/?id=d435203e6c4e5e62f65bc2c29a4e555f116a4d20
Submitter: Jenkins
Branch: master

commit d435203e6c4e5e62f65bc2c29a4e555f116a4d20
Author: JinLi <email address hidden>
Date: Thu Jun 15 17:05:47 2017 -0700

    Fix incorrect commands adding Gluon service to Keystone

    The commands in appendix of gluon-auth.rst are not right and
    cause errors when running in terminal. The changes reference
    ocata doc:
    https://docs.openstack.org/ocata/install-guide-obs/neutron-controller-install.html

    Change-Id: If7a703add8d378dc9184f50dcc6dea56e69b3876
    Closes-Bug: #1698245