Bug 1221217

Summary:	[RFE] Document installer's puppet nature and that changes would be overwritten
Product:	Red Hat Satellite	Reporter:	Stephen Benjamin <stbenjam>
Component:	Docs Install Guide	Assignee:	Charles Wood <chwood>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Lucie Jirakova <ljirakov>
Severity:	high	Docs Contact:
Priority:	high
Version:	6.1.0	CC:	adahms, bbuckingham, daobrien, ljirakov, swadeley
Target Milestone:	Unspecified	Keywords:	FutureFeature, ReleaseNotes
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-12-07 09:15:22 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:
Embargoed:
Bug Depends On:
Bug Blocks:	1190823

Description Stephen Benjamin 2015-05-13 13:59:55 UTC

The installer is puppet-based which could create surprises for users when they edit some configurations manually, and later run the installer again.  Their manual changes could be overwritten. This should be made clear in the installer documentation.

If a user is worried that the installer might overwrite some changes, they can perform --noop and review the /var/log/katello-installer/katello-installer.log to see what changes would be applied.

In the case of overwriting changes the user did not expect they can be recovered.  Files do get backed up, in the katello-installer logs anytime we overwrite a file, you'll see an entry like this about the Filebucket:

/Stage[main]/Dhcp/File[/etc/dhcp/dhcpd.conf]: Filebucketed /etc/dhcp/dhcpd.conf to puppet with sum 622d9820b8e764ab124367c68f5fa3a1


The old file is restorable with this command:
  puppet filebucket -l restore /etc/dhcp/dhcpd.conf 622d9820b8e764ab124367c68f5fa3a1

Comment 1 RHEL Program Management 2015-05-13 14:02:48 UTC

Since this issue was entered in Red Hat Bugzilla, the release flag has been
set to ? to ensure that it is properly evaluated for this release.

Comment 5 Andrew Dahms 2016-12-01 05:28:59 UTC

Assigning to Charles for review.

Charles - perhaps at the start of Chapter 3 might be a good location for this?

https://doc-stage.usersys.redhat.com/documentation/en/red-hat-satellite/6.2/single/installation-guide/#installing_satellite_server

Also, David's commit in Comment #3 contains some text that we can use for this. You can find it under the issue "BZ 1221217: Rerunning installer can overwrite manual changes" in the following -

https://access.redhat.com/documentation/en-US/Red_Hat_Satellite/6.1/html-single/Release_Notes/index.html

Comment 13 Charles Wood 2016-12-07 09:15:22 UTC

The content is now live on the customer portal. 

https://access.redhat.com/documentation/en/red-hat-satellite/6.2/paged/installation-guide/chapter-3-installing-satellite-server