Intro: Might want to add a note in there that this must be run once per CDS being used. Each CDS has its own SSL certificate which will be bundled into the CDS configuration, so in order to distribute those certificates where necessary individual CDS configuration RPMs are created. Not sure where you'd want to put this, but you will only need one client RPM per entitlement certificate. This has confused people in the past. You need one CDS configuration RPM per CDS instance, but you reuse the same client configuration RPM for all clients that should share the same set of entitlements. ----- Intro: "The Red Hat Update Infrastructure features a tool for configuring the Content Distribution Server (CDS) instances called the rhui-tool..." Again, this feels wonky. By now they should know that, but this reads like it's the first time they would be seeing it. ----- Intro: "Choose option 2 to configure the CDS instance(s). " The CDS is now option 4: "4 - CDS" ----- 1. No changes. 2. Name of the configuration RPM (see 651052 for an explanation of RPM names and versions, since it's the same rationale for all of the RHUI components). The only potential addition is that they can use this name field to help distinguish between the RPMs. For instance, given the following two CDS instances: batman.example.com robin.example.com They might want to choose the RPM names to reflect which machine to install it on. So something like "rhui-batman-0.1.rpm" and "rhui-robin-0.1.rpm". 3. Version of the configuration RPM (again, see 651052). 4. Directory on the CDS... Same as 2 in the existing documentation. 5. Full path to the CDS SSL certificate... Same as 3 in the existing documentation. 6. Full path to the CDS SSL certificate private key... Same as 4 in the existing documentation. 7. Full path to the CA certificate... Same as 5 in the existing documentation. 8. Full path to the CA chain file... Same as 6 in the existing documentation, with the exception that the existing documentation is wrong. A CA chain file isn't the concatenation of the CDS SSL certificates. It's a description of the CA chain of trust if one is used in their environment.
Created attachment 458880 [details] CDS configuration sample from tools Attached a sample CDS configuration using RHUI tools.
Added to content spec. Configuration -> Content Distribution Server instances. LKB
New process and example added. See revision 0-4. LKB
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