Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1069932

Summary:	[Docs] [Keystone] URL endpoint pullquote wrong
Product:	Red Hat OpenStack	Reporter:	Dan Trainor <dtrainor>
Component:	documentation	Assignee:	Suyog Sainkar <ssainkar>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Martin Lopes <mlopes>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	4.0	CC:	adahms, dtrainor, mlopes, mwalker, nkinder, slong, yeylon
Target Milestone:	---	Keywords:	Documentation, Triaged, ZStream
Target Release:	5.0 (RHEL 7)
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-11-25 02:17:48 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	1250289

Description Dan Trainor 2014-02-25 23:19:45 UTC

Description of problem:

Macro may not have expanded in section 9.2, 2).  

This may also need discussion, as it seems a little ambiguous.  The pullquote reads:

# keystone endpoint-create \
 --publicurl 'http://localhost:%(public_port)s/keystone/main'\
 --adminurl 'http://localhost:%(admin_port)s/keystone/admin'

Firstly, the docu right above this explains that we're going to be using HTTPS (tcp/443) on these connections.  That being said, the URLs in this pullquote may need to start with "https://...".  

Secondly, depending on what's decided with the above, "%(admin_port)s" may be a docu macro that was either not expanded, or should simply read "443", or nothing at all since "https://" may imply tcp/443.  

Either way, in its' current state, it appears to be a bit ambiguous.


How reproducible:
Always


Steps to Reproduce:
1. Read

Actual results:
# keystone endpoint-create \
 --publicurl 'http://localhost:%(public_port)s/keystone/main'\
 --adminurl 'http://localhost:%(admin_port)s/keystone/admin'

Expected results:
# keystone endpoint-create \
 --publicurl 'https://localhost:443/keystone/main'\
 --adminurl 'https://localhost:443/keystone/admin'

Additional info:

Comment 1 Dan Trainor 2014-02-25 23:24:19 UTC

The pullquote also needs to contain '--service keystone', to identify that we're making a change against a 'keystone' identity service:

[root@controller01 ~(keystone_admin)]$ keystone endpoint-create --service identity --publicurl 'https://10.16.0.180:443/keystone/main' --adminurl 'https://10.16.0.180:443/keystone/admin'
No service with a name or ID of 'identity' exists.
[root@controller01 ~(keystone_admin)]$ keystone endpoint-create --service keystone --publicurl 'https://10.16.0.180:443/keystone/main' --adminurl 'https://10.16.0.180:443/keystone/admin'
+-------------+----------------------------------------+
|   Property  |                 Value                  |
+-------------+----------------------------------------+
|   adminurl  | https://10.16.0.180:443/keystone/admin |
|      id     |    065f10e439ff4cfdb7bafcc8db61f86a    |
| internalurl |                                        |
|  publicurl  | https://10.16.0.180:443/keystone/main  |
|    region   |               regionOne                |
|  service_id |    09e121c7c4874ba0b8b0b82163b51ac3    |
+-------------+----------------------------------------+
[root@controller01 ~(keystone_admin)]$

Comment 3 Summer Long 2014-02-26 23:03:10 UTC

This bug is being assigned to Bruce Reeler, who is now the designated docs specialist for the Identity Service.

Comment 6 Andrew Dahms 2015-02-09 00:16:37 UTC

Assigning to Suyog, who is the designated author for Keystone.

Comment 13 Andrew Dahms 2015-11-25 02:17:48 UTC

This content is now live on the Customer Portal.

Closing.