Example usage in OpenStack Cloud Administrator Guide - icehouse

[Hao Luo]

Per keystone usage as follows, I guess the example should be:

# Using token auth flags
keystone --os-token=secrete --os-endpoint=http://127.0.0.1:5000/v2.0/ user-list
keystone --os-token=secrete --os-endpoint=http://127.0.0.1:5000/v2.0/ tenant-create --name=demo

rathan than:

# Using token auth flags
keystone --token=secrete --endpoint=http://127.0.0.1:5000/v2.0/ user-list
keystone --token=secrete --endpoint=http://127.0.0.1:5000/v2.0/ tenant-create --name=demo

Optional arguments:
  --version Shows the client version and exits.
  --timeout <seconds> Set request timeout (in seconds).
  --os-username <auth-user-name>
                        Name used for authentication with the OpenStack
                        Identity service. Defaults to env[OS_USERNAME].
  --os-password <auth-password>
                        Password used for authentication with the OpenStack
                        Identity service. Defaults to env[OS_PASSWORD].
  --os-tenant-name <auth-tenant-name>
                        Tenant to request authorization on. Defaults to
                        env[OS_TENANT_NAME].
  --os-tenant-id <tenant-id>
                        Tenant to request authorization on. Defaults to
                        env[OS_TENANT_ID].
  --os-auth-url <auth-url>
                        Specify the Identity endpoint to use for
                        authentication. Defaults to env[OS_AUTH_URL].
  --os-region-name <region-name>
                        Specify the region to use. Defaults to
                        env[OS_REGION_NAME].
  --os-identity-api-version <identity-api-version>
                        Specify Identity API version to use. Defaults to
                        env[OS_IDENTITY_API_VERSION] or 2.0.
  --os-token <service-token>
                        Specify an existing token to use instead of retrieving
                        one via authentication (e.g. with username &
                        password). Defaults to env[OS_SERVICE_TOKEN].
  --os-endpoint <service-endpoint>
                        Specify an endpoint to use instead of retrieving one
                        from the service catalog (via authentication).
                        Defaults to env[OS_SERVICE_ENDPOINT].
  --os-cacert <ca-certificate>
                        Specify a CA bundle file to use in verifying a TLS
                        (https) server certificate. Defaults to
                        env[OS_CACERT].
  --insecure Explicitly allow keystoneclient to perform "insecure"
                        TLS (https) requests. The server's certificate will
                        not be verified against any certificate authorities.
                        This option should be used with caution.
  --os-cert <certificate>
                        Defaults to env[OS_CERT].
  --os-key <key> Defaults to env[OS_KEY].
  --os-cache Use the auth token cache. Defaults to env[OS_CACHE].
  --force-new-token If the keyring is available and in use, token will
                        always be stored and fetched from the keyring until
                        the token has expired. Use this option to request a
                        new token and replace the existing one in the keyring.
  --stale-duration <seconds>
                        Stale duration (in seconds) used to determine whether
                        a token has expired when retrieving it from keyring.
                        This is useful in mitigating process or network
                        delays. Default is 30 seconds.

-----------------------------------
Built: 2014-04-14T02:48:07 00:00
git SHA: 8099195aa242059be10781548303eb76cdd39f75
URL: http://docs.openstack.org/admin-guide-cloud/content/example-usage.html
source File: file:/home/jenkins/workspace/openstack-admin-guide-cloud/doc/admin-guide-cloud/ch_identity_mgmt.xml
xml:id: example-usage

[OpenStack Infra (hudson-openstack)]

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

[Priti Desai (priti-desai)]

Fix submitted to branch: Master
Review: https://review.openstack.org/87286

[OpenStack Infra (hudson-openstack)]

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

commit b24c90019fd4528b532242ddb773e79610b3a7e7
Author: Priti Desai <email address hidden>
Date: Mon Apr 14 14:48:20 2014 +0000

    Fix for keystone example usage

    Keystone example usage for keystone auth flags has wrong keyword arguments (flag-like).
    Keystone accepts token and endpoint on the command line.
    Valid arguments are --os-token and --os-endpoint.
    --token should be --os-token
    --endpoint should be --os-endpoint
    Also, updating env. varabiles from SERVICE_TOKEN to OS_SERVICE_TOKEN and
    SERVICE_ENDPOINT to OS_SERVICE_ENDPOINT

    Change-Id: I24b41c5d7ddfdd7f8a388eb7b7ba1a1b7fa59542
    Closes-bug: #1307302

[OpenStack Infra (hudson-openstack)]

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