Bug 742347

Summary: Documentation does not tell you to install rh-rhua-config and rh-cds-config
Product: Red Hat Update Infrastructure for Cloud Providers Reporter: James Slagle <jslagle>
Component: DocumentationAssignee: Lana Brindley <lbrindle>
Status: CLOSED CURRENTRELEASE QA Contact: wes hayutin <whayutin>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 2.0.1CC: jskeoch, kbidarka, mhideo, sghai, tsanders
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-10-17 02:06:49 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description James Slagle 2011-09-29 19:29:59 UTC
The last step in section 3.2 says:

To execute the file and complete the installation, run the rhui-installer command: 
$ rhui-installer /etc/rhui/myanswersfile

Except we never tell them to install rh-rhua-config and rh-cds-config generated rpm's on the RHUA and CDS respectively.

Comment 2 James Slagle 2011-10-10 19:07:26 UTC
In Procedure 3.3 from the install guide, we walk them through creating an answers file to use with rhui-installer.  The output of that command is the creation of configuration rpm's that need to be installed on the RHUA and other configuration rpm's that need to be installed on the CDS's.

These rpm's will be in the destination directory they specified in step 3b.  The one that needs to be installed on the rhua will match the name and version they specified in steps 4a and 3a respectively.  So, if they use the example values show in the installation guide, the rpm generated will be /tmp/rhui/rh-rhua-config-2.0-2.el6.noarch.rpm

In a new step 7 in the procedure we need to tell them to install this rpm on the RHUA.

Likewise, the command will generate rpm's for each CDS they have configured in the answers file.  We need to tell them to copy these generated rpm's over to the correct CDS and install the rpm.  Again, if they use the example values, /tmp/rhui/rh-cds1-config-2.0-2.el6.noarch.rpm would have been generated.  We need to tell them to copy that rpm over to the CDS defined by the hostname in the [cds-1] section in the answers file and install it.

Comment 3 Lana Brindley 2011-10-11 19:22:22 UTC
(In reply to comment #2)
> In Procedure 3.3 from the install guide, we walk them through creating an
> answers file to use with rhui-installer.  The output of that command is the
> creation of configuration rpm's that need to be installed on the RHUA and other
> configuration rpm's that need to be installed on the CDS's.
> 
> These rpm's will be in the destination directory they specified in step 3b. 
> The one that needs to be installed on the rhua will match the name and version
> they specified in steps 4a and 3a respectively.  So, if they use the example
> values show in the installation guide, the rpm generated will be
> /tmp/rhui/rh-rhua-config-2.0-2.el6.noarch.rpm
> 
> In a new step 7 in the procedure we need to tell them to install this rpm on
> the RHUA.
> 
> Likewise, the command will generate rpm's for each CDS they have configured in
> the answers file.  We need to tell them to copy these generated rpm's over to
> the correct CDS and install the rpm.  Again, if they use the example values,
> /tmp/rhui/rh-cds1-config-2.0-2.el6.noarch.rpm would have been generated.  We
> need to tell them to copy that rpm over to the CDS defined by the hostname in
> the [cds-1] section in the answers file and install it.

<step>
	<para>
		To execute the file and create the configuration RPMs, run the <command>rhui-installer</command> command:
	</para>
			 
<screen>
$ rhui-installer <replaceable>/etc/rhui/myanswersfile</replaceable>
</screen>
	 <para>
		The configuration RPMs will be saved to the location you specified in <xref linkend="step-Installation_Guide-dest-dir" />. There will be a configuration RPM for both the RHUA and the CDS instances, using the names you gave for each.
	</para>
</step>
<step>
	<para>
		Copy the RHUA configuration RPM to the RHUA, and install it:
	</para>
		
<screen>
$ rpm -uvh <replaceable>/tmp/rhui/rh-rhua-config-2.0-2.el6.noarch.rpm</replaceable>
</screen>
</step>
<step>
	<para>
		Copy the CDS configuration RPM for each CDS instance (as defined by the hostname in the <parameter>[cds-1]</parameter> section), and install it:
	</para>
	
<screen>
$ rpm -uvh <replaceable>/tmp/rhui/rh-cds1-config-2.0-2.el6.noarch.rpm</replaceable>
</screen>
</step>

Revision 2-9

LKB

Comment 4 Sachin Ghai 2011-10-12 06:41:31 UTC
Verified in stage at following link

http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Update_Infrastructure/2.0/html/Installation_Guide/sect-Installation_Guide-RHUI_Installer-Answers_File.html

Under "Procedure 3.3. Editing the Answers File" ==> under steps 6 & 7.

The command should be "rpm -Uvh" instead of "rpm -uvh"

Comment 5 Lana Brindley 2011-10-12 19:37:05 UTC
(In reply to comment #4)
> Verified in stage at following link
> 
> http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Update_Infrastructure/2.0/html/Installation_Guide/sect-Installation_Guide-RHUI_Installer-Answers_File.html
> 
> Under "Procedure 3.3. Editing the Answers File" ==> under steps 6 & 7.
> 
> The command should be "rpm -Uvh" instead of "rpm -uvh"

Ah, good spot! Fixed in the RHUI Installer chapter, and also fixed the same error in the new 'Updating' chapter.

Revision 2-10.

LKB

Comment 7 Lana Brindley 2011-10-17 02:06:49 UTC
Revision 2-12 of this document is now publicly available at:
http://docs.redhat.com/docs/en-US/Red_Hat_Update_Infrastructure/2.0/html/Installation_Guide/index.html

Please raise a new bug for any further issues.

LKB