Bugzilla will be upgraded to version 5.0. The upgrade date is tentatively scheduled for 2 December 2018, pending final testing and feedback.
Bug 1135644 - The detail on configuring installation media and subscription manager is very light/confusing
The detail on configuring installation media and subscription manager is very...
Status: CLOSED CURRENTRELEASE
Product: Red Hat OpenStack
Classification: Red Hat
Component: doc-Deploying_OpenStack_Enterprise_Environments (Show other bugs)
Foreman (RHEL 6)
Unspecified Unspecified
high Severity high
: z1
: 5.0 (RHEL 7)
Assigned To: Andrew Dahms
Lucy Bopf
: Documentation, ZStream
Depends On:
Blocks:
  Show dependency treegraph
 
Reported: 2014-08-29 17:25 EDT by Stephen Gordon
Modified: 2015-02-13 00:51 EST (History)
2 users (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Environment:
Last Closed: 2015-02-13 00:51:55 EST
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)

  None (edit)
Description Stephen Gordon 2014-08-29 17:25:00 EDT
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 01:55:15 EDT
Assigning to Andrew Dahms.
Comment 3 Andrew Dahms 2014-09-18 09:24:48 EDT
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 03:23:13 EDT
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.