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

Bug 846371

Summary: Clarify Red Hat Enterprise Linux host preparation instructions regarding networking and user authentication.
Product: Red Hat Enterprise Virtualization Manager Reporter: Stephen Gordon <sgordon>
Component: DocumentationAssignee: Stephen Gordon <sgordon>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 3.1.0CC: acathrow, dyasny, gklein, sgrinber, yeylon
Target Milestone: ---Keywords: Documentation
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Red_Hat_Enterprise_Virtualization-Installation_Guide-3.1-web-en-US-3.1.0-5.el6eng Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-12-04 17:23:58 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:
Bug Depends On:    
Bug Blocks: 815463    

Description Stephen Gordon 2012-08-07 15:08:13 UTC 
Description of problem:

> * Procedure 8.1. Installing Red Hat Enterprise Linux
> ** If you intend to use Virtual Local Area Networks (VLANs) in your
> Red Hat Enterprise Virtualization environment, ensure that they are
> configured for access to the Red Hat Enterprise Virtualization
> Manager.
>
> -> cumbersome. All you need to say is make sure there is connectivity
> between the RHEV Manager and the host.
>
> -> The note regarding the useradd is phrased in a complex manner -
> Both Miki and myself had to read it twice just to understand what it
> means. The location is also probably wrong, should be in the RHEV
> preparations.
Comment 1 Stephen Gordon 2012-08-27 18:17:12 UTC 
> ** If you intend to use Virtual Local Area Networks (VLANs) in your
> Red Hat Enterprise Virtualization environment, ensure that they are
> configured for access to the Red Hat Enterprise Virtualization
> Manager.

Is now:

"Following successful installation of Red Hat Enterprise Linux&nbsp;6 Server, ensure that there is network connectivity between your new Red Hat Enterprise Linux host and the system on which your Red Hat Enterprise Virtualization Manager is installed."

> -> The note regarding the useradd is phrased in a complex manner -
> Both Miki and myself had to read it twice just to understand what it
> means. The location is also probably wrong, should be in the RHEV
> preparations.

Is now:

"If you intend to use directory services for authentication on the Red Hat Enterprise Linux host itself then you must ensure that the authentication files required by the <command>useradd</command> command are locally accessible. The <package>vdsm</package> package, which provides software that is required for successful connection to Red Hat Enterprise Virtualization Manager, will not install correctly if these files are not locally accessible."

I have left the location as is, this is the appropriate location as it relates to a decision made when installing Red Hat Enterprise Linux 6 Server. I do think the wording is still somewhat cumbersome, but I'm open to suggestions given the nature of the problem we're trying to describe.
Comment 2 Stephen Gordon 2012-08-27 18:17:50 UTC 
Topic 10236, revision 223636.
Comment 3 Stephen Gordon 2012-08-29 14:17:59 UTC 
Step 2 should have a heading, for consistency (or the heading on step 1 should be removed).
Comment 4 Stephen Gordon 2012-08-29 14:45:09 UTC 
Topic 10236, revision 227838.