Bug 1241273

Summary:	[doc] Satellite 6.1 Install Guide: missing step to restart services after upgrade
Product:	Red Hat Satellite	Reporter:	Xixi <xdmoon>
Component:	Docs Install Guide	Assignee:	jsomers
Status:	CLOSED CURRENTRELEASE	QA Contact:	Megan Lewis <melewis>
Severity:	high	Docs Contact:
Priority:	high
Version:	6.1.0	CC:	adstrong, bkearney, hhudgeon, jsomers, mmccune, stbenjam, xdmoon
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:	2015-07-23 12:07:57 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:	1115190

Description Xixi 2015-07-08 21:32:38 UTC

Document URL: 
https://access.redhat.com/documentation/en-US/Red_Hat_Satellite/6.1/html/Installation_Guide/chap-Upgrading_Red_Hat_Satellite_and_Capsule_Server.html

Section Number and Name: 
Chapter 7. Upgrading Red Hat Satellite Server and Capsule Server

Describe the issue: 
upgrade docs is missing a step to restart services after upgrade

Suggestions for improvement: 
upgrade docs includes step to restart services after upgrade

Additional information:

Comment 4 jsomers 2015-07-17 15:14:03 UTC

Xixi:
RE: For Section 7.1: Upgrading Red Hat Satellite: 
Added restart between steps 8 and 9, as follows:

Step 8. Run the installer with the --upgrade option: 
# katello-installer --upgrade
Important
If you have made manual edits to DNS and DHCP configuration files, they will be overwritten during the upgrade process. To avoid this, you can add the --capsule-dns-managed=false and --capsule-dhcp-managed=false options to the --upgrade installer command. This will keep DNS and DHCP configuration untouched until you set them to managed=true again. 

New Step 9. Restart all services:
# katello-service restart

Step 10. Update the Discovery template: 

Would you please review for accuracy (correct command and correct step number)?
Also, should the restart command be added for Upgrading Red Hat Satellite Capsule Server, please?

Comment 5 Xixi 2015-07-17 21:19:07 UTC

(In reply to jsomers from comment #4)
> Xixi:
> RE: For Section 7.1: Upgrading Red Hat Satellite: 
> Added restart between steps 8 and 9, as follows:
> 
> Step 8. Run the installer with the --upgrade option: 
> # katello-installer --upgrade
> Important
> If you have made manual edits to DNS and DHCP configuration files, they will
> be overwritten during the upgrade process. To avoid this, you can add the
> --capsule-dns-managed=false and --capsule-dhcp-managed=false options to the
> --upgrade installer command. This will keep DNS and DHCP configuration
> untouched until you set them to managed=true again. 
> 
> New Step 9. Restart all services:
> # katello-service restart
> 
> Step 10. Update the Discovery template: 
> 
> Would you please review for accuracy (correct command and correct step
> number)?
Thanks Jo, that looks good to me but defer to Mike to confirm.

> Also, should the restart command be added for Upgrading Red Hat Satellite
> Capsule Server, please?

That's a good question - IIRC this Bug should address Capsule service restart via similar steps (katello-service): Bug 1102878 - Capsule: need method of restarting capsule services, akin to 'katello-services'

Stephen - is this correct?
Thanks,