Bug 1105691

Hi Matt

We extensively re-structured the installation guides for 3.4 - can you please advise if the most recent subscription content is better? 

https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.4/html-single/Installation_Guide/index.html#Subscribing_to_the_Red_Hat_Enterprise_Virtualization_Manager_Channels_using_RHN_Classic

Section 2.3.1. Subscribing to the Red Hat Enterprise Virtualization Manager Channels using Subscription Manager looks good. It covers registration, searching for a subscription, attaching a subscription, and then ensuring the necessary repositories are enabled.


In section 2.4.1. Configuring an Offline Repository for Red Hat Enterprise Virtualization Manager Installation, on step 3:

"3. Add required channel subscriptions
Subscribe the system for all channels listed in the Red Hat Enterprise Virtualization - Installation Guide.

   A. Subscription Manager
   B. RHN Classic"

It seems like instead of telling me to look in the guide I'm currently looking in, perhaps we should either list out the 4 lines needed to ensure the channels/repositories are enabled, or reference the earlier sections that detail the entire process, and link up to them. In a doc that's 200 pages, I don't think saving the few lines is worth obscuring important information and hoping that customers can go off and find the relevant information in the doc on their own. The information they need is in 2.3.1. and 2.3.2, we should mention that here.

Step 1:
"1. Install Red Hat Enterprise Linux
Install Red Hat Enterprise Linux 6 Server on a system that has access to Red Hat Network. This system downloads all required packages, and distribute them to your offline system(s)."

has a minor typo: "This system downloads all required packages, and distribute[s] them..."


The problem is much more widespread than just here, but I've noticed that our docs across different products use different terminology when describing the registration & subscription steps using Subscription Management, hopefully at some point down the road we can figure out how to bring those into closer alignment...

I only looked at the sections that seemed relevant to subscriptions, but the information there looks solid, and I think covers the basics. One additional thing we might want to consider having is showing how to do the process through subscription-manager-gui, for people who would prefer to use the Subscription Manager UI, rather than a terminal.

As this BZ was against the Quick Start guide, and I don't see one for 3.4, has that been dropped? or is that coming later?

We merged the evaluation, quick start and installation guides as trying to decide which one to use was confusing, and common content had diverged too much which isn't helpful to customers either. The Install guide now has a quick start chapter instead.

Added channels to topic [9420]

Awaiting rebuild for fixes. 

Cloning for addition of subscription manager gui procedure.

Documentation Link 
------------------------------

https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5-Beta/html-single/Installation_Guide/index.html#Configuring_an_Offline_Repository_for_Red_Hat_Enterprise_Virtualization_Manager_Installation


What Changed 
------------------------------

Configuring an Offline Repository for Red Hat Enterprise Virtualization Manager Installation [9420-700931]

Fixed a typo (s/distribute/distributes) in step 1, and added the required channels to step 3.

Updated revision history: [34615-704248]


NVR
------------------------------

Red_Hat_Enterprise_Virtualization-Installation_Guide-3.5-Beta-web-en-US-3.5-9.el6eng

Removed RHN classic content as instructed by the content strategist team.
Everything else in comment9 is verified.

Cheers,
Julie