Bug 1332319

Summary: Section 3.4 , Installing Satellite Server has a non working installation command
Product: Red Hat Satellite Reporter: Rich Jerrido <rjerrido>
Component: Docs Quick Start GuideAssignee: Allison Heslin <aheslin>
Status: CLOSED CURRENTRELEASE QA Contact: Brandi Munilla <bmcelvee>
Severity: urgent Docs Contact:
Priority: urgent    
Version: 6.2.0CC: adahms, aheslin
Target Milestone: Unspecified   
Target Release: Unused   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-05-03 21:31:47 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Rich Jerrido 2016-05-02 22:46:44 UTC
Document URL: https://access.redhat.com/documentation/en/red-hat-satellite/6.2-beta/quick-start-guide/chapter-3-installing-satellite-server

Section Number and Name: 3.4 

Describe the issue: 


Section 3.4, Step 2 provides the following command to install Satellite


# foreman-installer --scenario katello
--foreman-admin-username admin-username \
--foreman-admin-password admin-password \
--capsule-puppet true \
--capsule-puppet-ca-proxy true \
--foreman-proxy-tftp true

This command has two major errors

* the first line doesn't end with a backslash ('\') so bash treats it as two distinct commands

* the  --capsule-puppet-ca-proxy  switch says 'proxy puppet CA requests to $THIS' server. That is not the behavior that is desired. (The command as presented in the docs says 'proxy puppet CA traffic to a server with the hostname "true"'


The "--foreman-proxy-puppetca true" switch says 'enable the Puppet CA feature', which is what is actually desired. 

Suggestions for improvement: 


Replace the command in section 3.4, step 2 with the following. 


# foreman-installer --scenario katello \
--foreman-admin-username admin-username \
--foreman-admin-password admin-password \
--capsule-puppet true \
--foreman-proxy-puppetca true \
--foreman-proxy-tftp true

Comment 2 Allison Heslin 2016-05-03 13:19:30 UTC
Made the correction. Changes should be visible the next time the docs are refreshed for Beta.

Comment 3 Andrew Dahms 2016-05-03 21:31:47 UTC
This content is now live on the Customer Portal.

Closing.