Bug 727048

Summary: Section 2.2 needs to be updated with few more install instructions.
Product: Red Hat Update Infrastructure for Cloud Providers Reporter: Sachin Ghai <sghai>
Component: DocumentationAssignee: Lana Brindley <lbrindle>
Status: CLOSED CURRENTRELEASE QA Contact: wes hayutin <whayutin>
Severity: high Docs Contact:
Priority: high    
Version: 2.0CC: jason.dobies, kbidarka, mhideo, sghai, tsanders, xdmoon
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-10 03:51:02 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 Sachin Ghai 2011-08-01 07:26:50 UTC
Description of problem:
Section 2.2 needs to be updated with few more install instructions.

# install_tools.sh ==> This script is used to install Red Hat Update Infrastructure Tools packages on RHUA node. You can install RHUI Tools other than the RHUA server too.
# install_RHUA.sh  ==> This script is used  to Install Red Hat Update Appliance Packages on RHUA node.
# install_CDS.sh ==> This is used to install Redhat Content Delivery Server packages on CDS nodes


After installing the install scripts on respective nodes, update the configuration files as below:

ON RHUA Server
================

Edit '/etc/pulp/pulp.conf' to reflect the hostname of the RHUA server.

    * Change 'localhost' in the below to the hostname of the RHUA server.

-----
      [server]
      server_name: localhost
      ...
      ...
      [messaging]
      url:        tcp://localhost:5672
-----


Also, Edit '/etc/pulp/client.conf' to relect the hostname of RHUA server under [server] section and to reflect the hostname of CDS under [cds] section.

---
	[server]
	host = localhost.localdomain
	...
	...
	

	[cds]
	baseurl = https://localhost/pulp/repos
	keyurl = http://localhost/pulp/gpg
	ksurl = http://localhost/pulp/ks

---



ON CDS Node:
============

Edit /etc/pulp/cds.conf to change the host property. This is required to connect the CDS to the RHUA server's message broker.
	
	* Change 'localhost' in the below to the hostname of the RHUA server.

...

	[server]
	host = localhost
	ca_cert_file = /etc/pki/content/pulp-server-ca.crt

...



Version-Release number of selected component (if applicable):
http://docs.redhat.com/docs/en-US/Red_Hat_Update_Infrastructure/2.0/html/Installation_Guide/sect-Installation_Guide-Installation_Requirements-Package_Installation.html

How reproducible:


Steps to Reproduce:
1.
2.
3.
  
Actual results:


Expected results:


Additional info:

Comment 1 Sachin Ghai 2011-08-01 07:28:10 UTC
Under "Procedure 2.1. Installing the Red Hat Update Infrastructure packages" ==> under step3 

Replace this:

[rhua]
hostname: rhua.example.command

with:

[rhua]
hostname: rhua.example.com

Comment 2 Sachin Ghai 2011-09-21 10:41:36 UTC
Hi Lana,

This bug is in assigned state since a long time. Could you please update the RHUI doc with the instructions stated in above comments.

Thanks,Sachin

Comment 3 Lana Brindley 2011-09-22 03:28:48 UTC
(In reply to comment #0)
> Description of problem:
> Section 2.2 needs to be updated with few more install instructions.
> 
> # install_tools.sh ==> This script is used to install Red Hat Update
> Infrastructure Tools packages on RHUA node. You can install RHUI Tools other
> than the RHUA server too.
> # install_RHUA.sh  ==> This script is used  to Install Red Hat Update Appliance
> Packages on RHUA node.
> # install_CDS.sh ==> This is used to install Redhat Content Delivery Server
> packages on CDS nodes
> 

<step>
	<para>
		Mount the ISO and run the following installation scripts to set up each piece of &RHUI; infrastructure, as follows:
	</para>
 <itemizedlist>
		<listitem>
			<para>
				The <filename>install_tools.sh</filename> script is used to install the &RHUI; tools packages on the RHUA:
			</para>
				 
<screen>
# install_tools.sh
</screen>
		</listitem>
		<listitem>
			<para>
				The <filename>install_RHUA.sh</filename> script is used to install packages on the RHUA:
			</para>
						
<screen>
# install_RHUA.sh
</screen>
		</listitem>
		<listitem>
			<para>
				The <filename>install_CDS.sh</filename> script is used to install the content delivery server packages on the CDS:
			</para>
					 
<screen>
# install_CDS.sh
</screen>

		</listitem>
	</itemizedlist>
</step>

LKB

Comment 4 Lana Brindley 2011-09-22 03:36:10 UTC
(In reply to comment #0)

> 
> After installing the install scripts on respective nodes, update the
> configuration files as below:
> 
> ON RHUA Server
> ================
> 
> Edit '/etc/pulp/pulp.conf' to reflect the hostname of the RHUA server.
> 
>     * Change 'localhost' in the below to the hostname of the RHUA server.
> 
> -----
>       [server]
>       server_name: localhost
>       ...
>       ...
>       [messaging]
>       url:        tcp://localhost:5672
> -----
> 
> 
> Also, Edit '/etc/pulp/client.conf' to relect the hostname of RHUA server under
> [server] section and to reflect the hostname of CDS under [cds] section.
> 
> ---
>  [server]
>  host = localhost.localdomain
>  ...
>  ...
> 
> 
>  [cds]
>  baseurl = https://localhost/pulp/repos
>  keyurl = http://localhost/pulp/gpg
>  ksurl = http://localhost/pulp/ks
> 
> ---
> 

<step>
	<para>
		On the RHUA server, edit the <filename>/etc/pulp/pulp.conf</filename> configuration file using your preferred text editor to include the correct hostname of the RHUA server. The hostname will be listed as <parameter>localhost</parameter> by default:
	</para>
				
<programlisting>
[server]
server_name: localhost
...
...
[messaging]
url:        tcp://localhost:5672
</programlisting>
	<para>
		Also on the RHUA server, edit the <filename>/etc/pulp/client.conf</filename> configuration file using your preferred text editor to include the correct hostname of the RHUA server. The hostname will be listed as <parameter>localhost</parameter> by default:
	</para>

<programlisting>
[server]
host = localhost.localdomain
...
...
[cds]
baseurl = https://localhost/pulp/repos
keyurl = http://localhost/pulp/gpg
ksurl = http://localhost/pulp/ks
</programlisting>

</step>

LKB

Comment 5 Lana Brindley 2011-09-22 03:40:45 UTC
(In reply to comment #0)

> 
> ON CDS Node:
> ============
> 
> Edit /etc/pulp/cds.conf to change the host property. This is required to
> connect the CDS to the RHUA server's message broker.
> 
>  * Change 'localhost' in the below to the hostname of the RHUA server.
> 
> ...
> 
>  [server]
>  host = localhost
>  ca_cert_file = /etc/pki/content/pulp-server-ca.crt
> 
> ...
> 

<step>
	<para>
		On the CDS instance, edit the <filename>/etc/pulp/cds.conf</filename> configuration file using your preferred text editor to include the correct hostname of the RHUA server. This is required to connect the CDS to RHUA server's message broker. The hostname will be listed as <parameter>localhost</parameter> by default:
	</para>
				 
<programlisting>
[server]
host = localhost
ca_cert_file = /etc/pki/content/pulp-server-ca.crt
</programlisting>

</step>


Related: Are the /etc/rhui/rhui-tools.conf instructions still applicable? If so, do these changes occur on the RHUA Server, the CDS instance, or somewhere else?

LKB

Comment 6 Lana Brindley 2011-09-22 03:41:09 UTC
(In reply to comment #1)
> Under "Procedure 2.1. Installing the Red Hat Update Infrastructure packages"
> ==> under step3 
> 
> Replace this:
> 
> [rhua]
> hostname: rhua.example.command
> 
> with:
> 
> [rhua]
> hostname: rhua.example.com

This doesn't appear in the latest version of the stage.

LKB

Comment 7 Lana Brindley 2011-09-22 03:42:08 UTC
Above changes made in Revision 2-5.

LKB

Comment 8 Sachin Ghai 2011-09-22 07:11:13 UTC
(In reply to comment5)

>Related: Are the /etc/rhui/rhui-tools.conf instructions still applicable? If
>so, do these changes occur on the RHUA Server, the CDS instance, or somewhere
>else?

Yes, the /etc/rhui/rhui-tools.conf instructions are still applicable and these changes needs to be done on RHUA server.

Comment 9 Sachin Ghai 2011-09-22 07:21:29 UTC
(In reply to comment3)

> <para>
>     The <filename>install_RHUA.sh</filename> script is used to install packages
> on the RHUA:
>    </para>

In above para statement should be like this
The <filename>install_RHUA.sh</filename> script is used to install Red Hat Update Appliance packages on the RHUA node.

Comment 10 Lana Brindley 2011-09-22 20:13:43 UTC
(In reply to comment #8)
> (In reply to comment5)
> 
> >Related: Are the /etc/rhui/rhui-tools.conf instructions still applicable? If
> >so, do these changes occur on the RHUA Server, the CDS instance, or somewhere
> >else?
> 
> Yes, the /etc/rhui/rhui-tools.conf instructions are still applicable and these
> changes needs to be done on RHUA server.

Added RHUA server info and moved to be with the other RHUA server instructions.

LKB

Comment 11 Lana Brindley 2011-09-22 20:14:20 UTC
(In reply to comment #9)
> (In reply to comment3)
> 
> > <para>
> >     The <filename>install_RHUA.sh</filename> script is used to install packages
> > on the RHUA:
> >    </para>
> 
> In above para statement should be like this
> The <filename>install_RHUA.sh</filename> script is used to install Red Hat
> Update Appliance packages on the RHUA node.

<para>
	The <filename>install_RHUA.sh</filename> script is used to install Red Hat Update Appliance packages on the RHUA node:
</para>

Revision 2-6

LKB