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

Bug 1135644

Summary:	The detail on configuring installation media and subscription manager is very light/confusing
Product:	Red Hat OpenStack	Reporter:	Stephen Gordon <sgordon>
Component:	doc-Deploying_OpenStack_Enterprise_Environments	Assignee:	Andrew Dahms <adahms>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Lucy Bopf <lbopf>
Severity:	high	Docs Contact:
Priority:	high
Version:	Foreman (RHEL 6)	CC:	ddomingo, yeylon
Target Milestone:	z1	Keywords:	Documentation, 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-02-13 05:51:55 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 Stephen Gordon 2014-08-29 21:25:00 UTC

Description of problem:

The detail on configuring installation media and subscription manager is very light. In particular:

* Configure Installation Media

  "Optionally, configure the installation media to use for provisioning. Enter the number that corresponds to an option to change the value for that option, then enter 2 and press Enter to proceed with the configured values: "

  - Doesn't actually seem to be optional as suggested here (also a bug in the screen text).
  - Does not make it clear what URL this is supposed to be. If a repo, which repo? Was the user supposed to create this, if so how? 
  - Text initially recommends using the default (http://) which wont work anyway and then we immediately follow with an admonition saying it's recommended to set this to a proper value.

Also not clear if the user needs both a repo and sub man setup, and in either case would be good to tell them *why*.

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/5/html/Installer_and_Foreman_Guide/sect-Installation.html

Comment 2 Don Domingo 2014-09-02 05:55:15 UTC

Assigning to Andrew Dahms.

Comment 3 Andrew Dahms 2014-09-18 13:24:48 UTC

Documentation Link
------------------------------
http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/5/html-single/Installer_and_Foreman_Guide/index.html#Run_the_Installer

What Changed
------------------------------
The following topic was revised as outlined below:

Installing the User Interface [38678-707802]

Added the note about specifying a installation medium path or Subscription Manager details being optional and added substeps to the step.

Created the following topic to outline how to prepare the initial installation medium:

Preparing an Installation Medium [41731]

Updated the revision history: [39274-710847]

NVR
------------------------------
Red_Hat_Enterprise_Linux_OpenStack_Platform-Installer_and_Foreman_Guide-5-en-US-5.0.0-14

Moving to ON_QA.

Comment 4 Lucy Bopf 2014-09-22 07:23:13 UTC

Reviewed.

The section on specifying an installation medium during installation has been revised to indicate the necessity of completing the step. It also clearly states where the repo path should point.

The new topic on preparing an installation medium has been added, and appears before the installation topic. The steps make logical sense, and explain what is being done.

VERIFIED.