Bug 1135644 - The detail on configuring installation media and subscription manager is very light/confusing
Summary: The detail on configuring installation media and subscription manager is very...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: doc-Deploying_OpenStack_Enterprise_Environments
Version: Foreman (RHEL 6)
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: z1
: 5.0 (RHEL 7)
Assignee: Andrew Dahms
QA Contact: Lucy Bopf
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2014-08-29 21:25 UTC by Stephen Gordon
Modified: 2015-02-13 05:51 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2015-02-13 05:51:55 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

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.


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