Red Hat Satellite engineering is moving the tracking of its product development work on Satellite to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "Satellite project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs will be migrated starting at the end of May. If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "Satellite project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/SAT-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.
Bug 1241273 - [doc] Satellite 6.1 Install Guide: missing step to restart services after upgrade
Summary: [doc] Satellite 6.1 Install Guide: missing step to restart services after upg...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Docs Install Guide
Version: 6.1.0
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: Unspecified
Assignee: jsomers
QA Contact: Megan Lewis
URL:
Whiteboard:
Depends On:
Blocks: GSS_Sat6Beta_Tracker, GSS_Sat6_Tracker
TreeView+ depends on / blocked
 
Reported: 2015-07-08 21:32 UTC by Xixi
Modified: 2019-09-26 15:42 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2015-07-23 12:07:57 UTC
Target Upstream Version:
Embargoed:

Attachments (Terms of Use)

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,
Note You need to log in before you can comment on or make changes to this bug.