Bug 1254733 - [Docs] [Director] OSP 7 Official Installation Guide network creation not properly documented
Summary: [Docs] [Director] OSP 7 Official Installation Guide network creation not prop...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 7.0 (Kilo)
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: y2
: 7.0 (Kilo)
Assignee: Dan Macpherson
QA Contact:
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2015-08-18 18:06 UTC by Dan Sneddon
Modified: 2016-01-25 01:33 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-01-25 01:33:07 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Dan Sneddon 2015-08-18 18:06:45 UTC
Description of problem:
In the official OSP 7 installation guide, in section 7.1 we have instructions for creating the overcloud external network. These instructions don't match up with the validation step afterward.

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

How reproducible:
100%

Steps to Reproduce:
1. Deploy OSP 7
2. Follow installation guide instructions for creating external network
3. Network created will not have the same name as what is shown in the validation step.

Actual results:
The instructions are for creating a network named "nova", but the validation step shows a network named "ext-net". We should modify the network and subnet commands to create a network named "ext-net".

Expected results:
The instructions should show how to create a network named "ext-net". Also, the validation step shows an "ext-net" with IP addresses on the 192.0.2.0 network, which is only applicable to virt installations. This network should show the same range of IPs that was created in the previous step.

Additional info:
Also, there are no instructions for creating the "default" network, even though that is shown in the validation step. Users won't be able to launch instances until they have at least one tenant network, so we should include the step of creating the default network.

Comment 3 Andrew Dahms 2015-08-30 22:51:01 UTC
Assigning to Dan for review.

Comment 6 Dan Macpherson 2015-09-25 02:45:42 UTC
Hi Dan,

I've pushed out the following documentation:

* New section on creating a Tenant network: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/7/html/Director_Installation_and_Usage/chap-Performing_Tasks_after_Overcloud_Creation.html#sect-Creating_the_Overcloud_Tenant_Network

* Revised section on creating an External network: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/7/html/Director_Installation_and_Usage/sect-Creating_the_Overcloud_External_Network.html

Hopefully the commands should now match the output.

Can you confirm if the changes are correct? Are there any further changes required?

Comment 7 Dan Macpherson 2016-01-25 01:33:07 UTC
No response in several months. Closing this bug, but feel free to reopen if necessary.


Note You need to log in before you can comment on or make changes to this bug.