Bug 1393122

Summary:	[RFE] Document the bootstrap script/feature in the Host Configuration Guide
Product:	Red Hat Satellite	Reporter:	Rich Jerrido <rjerrido>
Component:	Docs Host Configuration Guide	Assignee:	Charles Wood <chwood>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Stephen Wadeley <swadeley>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	6.2.3	CC:	adahms
Target Milestone:	Unspecified	Keywords:	FutureFeature
Target Release:	Unused
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2017-03-29 12:36:10 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-11-08 22:09:25 UTC

Describe the issue:  The bootstrap script, which is shipped in 6.2 and above supports both migrating clients from Satellite 5 and registering new clients to Satellite 6. The Transition Guide covers the transition use case, but the standard registration use-case needs to be documented. 

That is, section 9 of the host configuration guide (https://access.redhat.com/documentation/en/red-hat-satellite/6.2/single/host-configuration-guide#chap-Red_Hat_Satellite-Host_Configuration_Guide-Configuring_Hosts) should be augmented with bootstrap.py use-cases as in addition to content registration it:

- removes old RHN configs & packages
- does Puppet setup
- does Remote Execution key distribution.
- can force/pass custom options to rhn-migrate/subscription-manager.
- enables repos for old versions of subscription manager (basically anything older than 6.5) which don't support product content overrides.

Comment 1 Andrew Dahms 2017-03-16 03:37:35 UTC

Assigning to Charles for review.

Charles - looks like what we need is a new section under the section on registering hosts that outlines how to register hosts using the bootstrap.py script.

Stephen worked on the transition use case, and will likely be able to provide some insight into how the script worked there.

Comment 2 Rich Jerrido 2017-03-16 08:12:13 UTC

Note, the bootstrap script is currently documented extensively in this KCS Article (https://access.redhat.com/articles/2280691)

Comment 8 Charles Wood 2017-03-29 12:36:10 UTC

The content is now live on the customer portal.

Closing. 

https://access.redhat.com/documentation/en-us/red_hat_satellite/6.2/html/host_configuration_guide/sect-red_hat_satellite-host_configuration_guide-adding_new_hosts_to_satellite_6_using_the_bootstrap_script