Incorrect bootstrap admin url in keystone documentation for queens in ubuntu

Bug #1755026 reported by mos
28
This bug affects 4 people
Affects Status Importance Assigned to Milestone
OpenStack Identity (keystone)
Invalid
Undecided
Unassigned

Bug Description

- [x] This doc is inaccurate in this way: the instructions for the definition of the bootstrap admin url in the keystone installation instructions for the Ubuntu OS are incorrect as they specify a wrong port number (5000)
- [ ] This is a doc addition request.
- [x] I have a fix to the document that I can paste below including example: input and output.

The full command for Step 5 under the heading "Bootstrap the Identity service" should be the following:

keystone-manage bootstrap --bootstrap-password ADMIN_PASS \
  --bootstrap-admin-url http://controller:35357/v3/ \
  --bootstrap-internal-url http://controller:5000/v3/ \
  --bootstrap-public-url http://controller:5000/v3/ \
  --bootstrap-region-id RegionOne

instead of

keystone-manage bootstrap --bootstrap-password ADMIN_PASS \
  --bootstrap-admin-url http://controller:5000/v3/ \
  --bootstrap-internal-url http://controller:5000/v3/ \
  --bootstrap-public-url http://controller:5000/v3/ \
  --bootstrap-region-id RegionOne

-----------------------------------
Release: 13.0.0.0rc3.dev1 on 2018-02-22 22:43
SHA: c06d74fcf4cf5338db6572265c609036f6817466
Source: https://git.openstack.org/cgit/openstack/keystone/tree/doc/source/install/keystone-install-ubuntu.rst
URL: https://docs.openstack.org/keystone/queens/install/keystone-install-ubuntu.html

Tags: doc
Revision history for this message
Russell Tweed (russell-tweed) wrote :

As these are keystone v3 URLs, port 35357 is valid here. In fact, all of those ports could be 35357

Revision history for this message
Colleen Murphy (krinkle) wrote :

Changing these to 5000 in Queens was a deliberate choice for the reasons given here: https://bugs.launchpad.net/keystone/+bug/1755511

Changed in keystone:
status: New → Invalid
Revision history for this message
mos (mtsietsi) wrote : Re: [Bug 1755026] Re: Incorrect bootstrap admin url in keystone documentation for queens in ubuntu

Thanks! As per suggestion in comment #3 at
https://bugs.launchpad.net/keystone/+bug/1755511, documentation would
benefit from being brought into alignment. Documentation of key services
such as Keystone and Glance still contain references to port 35357.

Mos

On 15 March 2018 at 14:15, Colleen Murphy <email address hidden> wrote:

> Changing these to 5000 in Queens was a deliberate choice for the reasons
> given here: https://bugs.launchpad.net/keystone/+bug/1755511
>
> ** Changed in: keystone
> Status: New => Invalid
>
> --
> You received this bug notification because you are subscribed to the bug
> report.
> https://bugs.launchpad.net/bugs/1755026
>
> Title:
> Incorrect bootstrap admin url in keystone documentation for queens in
> ubuntu
>
> Status in OpenStack Identity (keystone):
> Invalid
>
> Bug description:
>
> - [x] This doc is inaccurate in this way: the instructions for the
> definition of the bootstrap admin url in the keystone installation
> instructions for the Ubuntu OS are incorrect as they specify a wrong port
> number (5000)
> - [ ] This is a doc addition request.
> - [x] I have a fix to the document that I can paste below including
> example: input and output.
>
> The full command for Step 5 under the heading "Bootstrap the Identity
> service" should be the following:
>
> keystone-manage bootstrap --bootstrap-password ADMIN_PASS \
> --bootstrap-admin-url http://controller:35357/v3/ \
> --bootstrap-internal-url http://controller:5000/v3/ \
> --bootstrap-public-url http://controller:5000/v3/ \
> --bootstrap-region-id RegionOne
>
> instead of
>
> keystone-manage bootstrap --bootstrap-password ADMIN_PASS \
> --bootstrap-admin-url http://controller:5000/v3/ \
> --bootstrap-internal-url http://controller:5000/v3/ \
> --bootstrap-public-url http://controller:5000/v3/ \
> --bootstrap-region-id RegionOne
>
> -----------------------------------
> Release: 13.0.0.0rc3.dev1 on 2018-02-22 22:43
> SHA: c06d74fcf4cf5338db6572265c609036f6817466
> Source: https://git.openstack.org/cgit/openstack/keystone/tree/
> doc/source/install/keystone-install-ubuntu.rst
> URL: https://docs.openstack.org/keystone/queens/install/
> keystone-install-ubuntu.html
>
> To manage notifications about this bug go to:
> https://bugs.launchpad.net/keystone/+bug/1755026/+subscriptions
>

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix proposed to keystone (master)

Related fix proposed to branch: master
Review: https://review.openstack.org/553799

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix merged to keystone (master)

Reviewed: https://review.openstack.org/553799
Committed: https://git.openstack.org/cgit/openstack/keystone/commit/?id=1b01ebce5632bbde162937b41b02177168d00ec2
Submitter: Zuul
Branch: master

commit 1b01ebce5632bbde162937b41b02177168d00ec2
Author: Colleen Murphy <email address hidden>
Date: Fri Mar 16 15:21:40 2018 +0100

    Add note to keystone-manage bootstrap doc

    A lot of people are very surprised that we no longer reference port
    35357 in our Ubuntu (and SUSE) install guides. Add a note to clarify
    that this is not a bug and we do really mean it.

    This does not change the RDO install guide because our guide still
    instructs users to use port 35357 because the RDO package still includes
    an Apache vhost file that uses 35357.

    Change-Id: I334ba888190705a345d50cebe577b832753f202c
    Related-bug: #1755026
    Related-bug: #1755511
    Related-bug: #1756178

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Duplicates of this bug

Other bug subscribers

Remote bug watches

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