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

Bug 964184

Summary:	Examples required in Running PackStack Interactively - if one does not accept the defaults, do we need to provide examples of responses?
Product:	Red Hat OpenStack	Reporter:	Bruce Reeler <breeler>
Component:	doc-Getting_Started_Guide	Assignee:	RHOS Documentation Team <rhos-docs>
Status:	CLOSED NOTABUG	QA Contact:	ecs-bugs
Severity:	low	Docs Contact:
Priority:	low
Version:	3.0	CC:	adahms, mlopes, sgordon, slong
Target Milestone:	---	Keywords:	Documentation
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-02-03 08:31:00 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:

Description Bruce Reeler 2013-05-17 12:47:29 UTC

Description of problem:
Examples required in Running PackStack Interactively  - step 12g: A public interface must be configured to allow... Enter the name of the public interface to use.
as well as step 12h for the private interface.

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


Expected results:
Examples of names of interfaces.

Comment 2 Bruce Reeler 2013-06-06 02:17:54 UTC

Generalizing this bug, though not sure if we need to provide this level of detail in GSG:
If users are not just accepting default values to PackStack's prompts, do we need to (and can we?) provide alternative examples? E.g. in comment 0 in this bug, what format does an alternative interface take, is it just for example eth2 or are there other formats?

Comment 3 Stephen Gordon 2013-06-12 14:59:07 UTC

(In reply to Bruce Reeler from comment #2)
> Generalizing this bug, though not sure if we need to provide this level of
> detail in GSG:
> If users are not just accepting default values to PackStack's prompts, do we
> need to (and can we?) provide alternative examples? E.g. in comment 0 in
> this bug, what format does an alternative interface take, is it just for
> example eth2 or are there other formats?

Common formats for the interfaces include:

ethX - eth0, eth1, eth2
emX - em1, em1, em2
pXpy - p1p1, p1p2, p2p1, p2p2

For the Open vSwitch bridges expect values like:

br-int - Internal bridge
br-ex - External bridge

For the Linux Bridge bridges expect values like:

br1
br100

Comment 4 Stephen Gordon 2013-06-20 19:33:59 UTC

Moved to 4.0.

Comment 5 Bruce Reeler 2014-04-10 06:05:14 UTC

Added interface examples to step 14k (or 14.11) of Configuring the Compute service.
Added br-ex as an example in step 15d (or 15.4) of Configuring OpenStack Networking.
Added linuxbridge names to step 15f (or 15.6) of Configuring OpenStack Networking.

Comment 13 Andrew Dahms 2015-02-03 08:31:00 UTC

Examples of how to use Packstack have been incorporated into the Getting Started Guide, and the guide itself is under a full review.

Closing.