Bug 1393600

Summary:	Documentation omits creation of Neutron router, required for External Network
Product:	Red Hat OpenStack	Reporter:	Dan Trainor <dtrainor>
Component:	documentation	Assignee:	Dan Macpherson <dmacpher>
Status:	CLOSED CURRENTRELEASE	QA Contact:	RHOS Documentation Team <rhos-docs>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	9.0 (Mitaka)	CC:	dmacpher, dtrainor, srevivo
Target Milestone:	---	Keywords:	Documentation
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2017-09-22 06:58:24 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:

Description Dan Trainor 2016-11-09 23:48:01 UTC

Description of problem:

The Director Installation and Usage guide has very nice instructions on configuring an OSP9 Director, and goes in to some detail about how to configure External Networks as part of the initial post-deployment tasks.

The documentation goes on to describe how to create these Overcloud External Networks but fails to detail the creation of a router and how to associate the router with the external network described in the documentation.

The Networking Guide goes on to describe how to add a router (https://access.redhat.com/documentation/en/red-hat-openstack-platform/9/single/networking-guide#add_a_router), however there should exist some details in the examples used for creating the External network (https://access.redhat.com/documentation/en/red-hat-openstack-platform/9/single/director-installation-and-usage/#sect-Creating_the_Overcloud_External_Network) 



Version-Release number of selected component (if applicable):

9


How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:

Details in the documentation for creating the Overcloud External Network (https://access.redhat.com/documentation/en/red-hat-openstack-platform/9/single/director-installation-and-usage/#sect-Creating_the_Overcloud_External_Network) to include how to create a router and associate the described External Network with this router, to make the External Network operate properly.


Additional info:

Comment 1 Dan Macpherson 2017-09-22 05:31:23 UTC

Hi Dan,

I've added this info to the Provider Network creation:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/9/html-single/director_installation_and_usage/#sect-Creating_the_Overcloud_Provider_Network

Let me know if this suits what you're after.

Comment 2 Dan Trainor 2017-09-22 06:24:50 UTC

I do not have an OSP9 environment to test this with, but to my recollection the only part missing was the creation of a router.  Looks good!

Comment 3 Dan Macpherson 2017-09-22 06:58:24 UTC

Thanks, Dan. If you run into any issues, or hear of anyone running into issues with this, feel free to reopen this BZ.