In the steps to verify the Image Service Installation, invalid option used in glance command example

Bug #1061232 reported by Ahmed Al-Mehdi
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
openstack-manuals
Fix Released
High
Tom Fifield

Bug Description

http://docs.openstack.org/trunk/openstack-compute/install/apt/content/images-verifying-install.html

In the section - "Verifying the Image Service Installation", in the example of the glance command to add an image, the option --os_tenant is used which is invalid. The correct option is "--os_tenant_name". There are three instances of this issue which should be addressed.

glance --os_username=adminUser --os_password=secretword --os_tenant=
openstackDemo --os_auth_url=http://127.0.0.1:5000/v2.0 add name="tty-linux-
kernel" disk_format=aki container_format=aki < ttylinux-uec-amd64-12.1_2.6.
35-22_1-vmlinuz

A few additional nit-picks which I feel should be addressed to make it easier on the reader / installer:

1) the IP address in the environment variable - OS_AUTH_URL and glance option --os_auth_url does not match (even though both are valid values and the verification step will work). Best to set them both the same value. I suggest setting OS_AUTH_URL as follows:

export OS_AUTH_URL=http://127.0.0.1:5000/v2.0/

2) It seems glance accepts two forms of the same option, e.g. --os_username or --os-username (underscore vs. dash in the option name). However, the --help output of glance (glance --help) states all the options with a dash (--os-username). It would be nice if all the glance command examples in this section were consistent with the help description.

Tags: glance
Tom Fifield (fifieldt)
tags: added: glance
Changed in openstack-manuals:
status: New → Confirmed
importance: Undecided → High
status: Confirmed → Triaged
Tom Fifield (fifieldt)
Changed in openstack-manuals:
assignee: nobody → Tom Fifield (fifieldt)
status: Triaged → Won't Fix
status: Won't Fix → In Progress
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to openstack-manuals (master)

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

Revision history for this message
Tom Fifield (fifieldt) wrote :
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to openstack-manuals (master)

Reviewed: https://review.openstack.org/14200
Committed: http://github.com/openstack/openstack-manuals/commit/20e566149e4ab43cf312556ede254c5d68759aac
Submitter: Jenkins
Branch: master

commit 20e566149e4ab43cf312556ede254c5d68759aac
Author: Tom Fifield <email address hidden>
Date: Tue Oct 9 17:59:09 2012 +1100

    Fix inconsistent arguments/IPs in verify install

    fixes bug 1061232

    A number of issues were outline in the bug report, such as the use
    of depreceated '_' joiners in arguments for glance, and inconsistent
    IP address examples in the verifying installation doc.

    This patch fixes those and updates other areas using the old '_'
    syntax

    Change-Id: I61850200c98de622fa54bce04859321a7e711e92

Changed in openstack-manuals:
status: In Progress → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.