Bug 742347 - Documentation does not tell you to install rh-rhua-config and rh-cds-config
Summary: Documentation does not tell you to install rh-rhua-config and rh-cds-config
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Update Infrastructure for Cloud Providers
Classification: Red Hat
Component: Documentation
Version: 2.0.1
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: ---
Assignee: Lana Brindley
QA Contact: wes hayutin
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-09-29 19:29 UTC by James Slagle
Modified: 2016-02-18 06:13 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2011-10-17 02:06:49 UTC
Target Upstream Version:


Attachments (Terms of Use)

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


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