Bug 649783 - RHUI 1.2 Updates: RHUI Tools Answers File
Summary: RHUI 1.2 Updates: RHUI Tools Answers File
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Update Infrastructure for Cloud Providers
Classification: Red Hat
Component: Documentation
Version: 1.1
Hardware: Unspecified
OS: Unspecified
low
medium
Target Milestone: ---
: ---
Assignee: Lana Brindley
QA Contact: ecs-bugs
URL:
Whiteboard:
Depends On:
Blocks: 649091
TreeView+ depends on / blocked
 
Reported: 2010-11-04 14:58 UTC by Jay Dobies
Modified: 2013-10-23 23:19 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2010-12-13 23:13:13 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)
In progress copy of the answers sample file (7.36 KB, application/octet-stream)
2010-11-04 15:00 UTC, Jay Dobies
no flags Details

Description Jay Dobies 2010-11-04 14:58:33 UTC
I'm not sure where else to put this, so I'll mention it here.

The overall flow of using RHUI Tools looks like:
- Generate entitlement certificates
- Generate the RHUI identity certificate

Then either:
- Generate the RHUA configuration RPM
- Generate one CDS configuration RPM per CDS
- Generate one client configuration RPM per entitlement certificate
- (Optionally) Generate the external load balancer configuration RPM.

Or:
- Fill out the answers file, using answers.sample as the basis.
- Pass in the answers file to RHUI tools and out comes all of the necessary RPMs.

I filed this as a separate bug as it applies to chapters 4-8. I'm not sure how you want to handle that either/or scenario, but somehow we need to find a way to incorporate documentation for the answers file support.

As for the answers file functionality, it's really pretty simple:
- Copy /etc/rhui/answers.sample to some other location, naming it whatever you want.
- Edit the values inside according to the documentation in there.
- Run "rhui-tools --answers <filename>"

The output of that will indicate the names of the RPMs created. Install those RPMs like you would as if you created them from the interactive CLI.

Let me know if you think we should provide more documentation than just this.

Comment 1 Jay Dobies 2010-11-04 15:00:52 UTC
Created attachment 457816 [details]
In progress copy of the answers sample file

There is still one definite change that will be made to this file. The "master_entitlement_cert" will be renamed to "rhui_identity_cert". Same for the "master_entitlement_key" becoming "rhui_entitlement_key". Otherwise, I don't anticipate any other changes to this sample.

Comment 2 Lana Brindley 2010-11-10 02:55:10 UTC
Added to content spec. Configuration -> Answers File.

LKB

Comment 3 Lana Brindley 2010-11-23 01:51:29 UTC
(In reply to comment #0)
> I'm not sure where else to put this, so I'll mention it here.
> 
> The overall flow of using RHUI Tools looks like:
> - Generate entitlement certificates
> - Generate the RHUI identity certificate
> 
> Then either:
> - Generate the RHUA configuration RPM
> - Generate one CDS configuration RPM per CDS
> - Generate one client configuration RPM per entitlement certificate
> - (Optionally) Generate the external load balancer configuration RPM.
> 
> Or:
> - Fill out the answers file, using answers.sample as the basis.
> - Pass in the answers file to RHUI tools and out comes all of the necessary
> RPMs.

I've included this information in the preamble to each part.

> 
> I filed this as a separate bug as it applies to chapters 4-8. I'm not sure how
> you want to handle that either/or scenario, but somehow we need to find a way
> to incorporate documentation for the answers file support.

I moved the answers file chapter so it is first in the configuration part. It now contains a statement as follows:

<para>
	In order to configure &PRODUCT;, a series of configuration RPMs are required. These can be created manually using the included <command>rhui-tools</command> package, or you can create an <firstterm>answers file</firstterm> to help automate the process. &PRODUCT; includes a sample answers file called <filename>answers.sample</filename> to use as a basis for creating your own answers file.
</para>

Revision 0-5.

LKB

Comment 4 Lana Brindley 2010-11-23 01:59:43 UTC
New process and example added.

See revision 0-5.

LKB

Comment 5 Andrew Ross 2010-12-07 03:06:00 UTC
Now in ch.6 

http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Update_Infrastructure/1.2/html/Installation_Guide/chap-Installation_Guide-Answers_File.html

Checking: Red_Hat_Update_Infrastructure-Installation_Guide-1.2-web-en-US-0-8.el5

(In reply to comment #1)
> Created attachment 457816 [details]
> In progress copy of the answers sample file
> 
> There is still one definite change that will be made to this file. The
> "master_entitlement_cert" will be renamed to "rhui_identity_cert". Same for the
> "master_entitlement_key" becoming "rhui_entitlement_key". Otherwise, I don't
> anticipate any other changes to this sample.

Example 6.1. Example Answers File still refers to master entitlement.

Comment 6 Lana Brindley 2010-12-08 03:19:17 UTC
(In reply to comment #5)

> 
> Example 6.1. Example Answers File still refers to master entitlement.

Updated the example.

LKB

Comment 7 Lana Brindley 2010-12-13 23:13:13 UTC
Published 14 December 2010: http://docs.redhat.com/docs/en-US/Red_Hat_Update_Infrastructure/1.2/html/Installation_Guide/index.html

Please raise any issues as new bugs against this live version.

Thanks,
LKB


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