Bug 1394968

Summary:	6.1. Upgrading to Satellite Server 6.2 does not require an upgrade to 6.1.10 or later
Product:	Red Hat Satellite	Reporter:	Mike McCune <mmccune>
Component:	Docs Install Guide	Assignee:	Chris Roberts <chrobert>
Status:	CLOSED CURRENTRELEASE	QA Contact:	satellite-doc-list
Severity:	high	Docs Contact:
Priority:	high
Version:	6.2.4	CC:	adahms, ahumbe, bkearney, bmcelvee, chrobert, rdickens, swadeley
Target Milestone:	Unspecified
Target Release:	Unused
Hardware:	Unspecified
OS:	Unspecified
URL:	https://gitlab.cee.redhat.com/satellite-6-documentation/installation-guide/merge_requests/138
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-11-22 01:23:48 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 Mike McCune 2016-11-14 22:21:59 UTC

Document URL: https://access.redhat.com/documentation/en/red-hat-satellite/6.2/paged/installation-guide/chapter-6-upgrading-satellite-server-and-capsule-server

Section Number and Name: 6.2

Describe the issue: Our current installation guide rightly states:

"""
Supported upgrade paths for Satellite 6.2:

 * Satellite 6.1.9 GA or later to 6.2.X GA or later. 
"""

What we do *not* require is that customers who are at 6.1.9 upgrade to 6.1.10, 6.1.11 or later. This adds an unnecessary step that adds additional risk to the upgrade as well as 2-4 hours of additional time required to get up to 6.2

Suggestions for improvement: 

We should make step 9.a/b/c optional:

"""
 If you have new packages after updating:

    Ensure your Satellite Server is at the latest version.

    # katello-installer --upgrade

    If you have a new kernel after updating, reboot the system.

    If no reboot was required, ensure the Katello services are now running.

    # katello-service start

"""

and instead state:

"If your Satellite is fully upgraded to 6.1.9 you do not need to update to a later version in 6.1.X and run katello-installer --upgrade, this step 9 can be skipped".


Additional information:

Comment 1 Chris Roberts 2016-11-16 18:08:43 UTC

Created MR:

https://gitlab.cee.redhat.com/satellite-6-documentation/installation-guide/merge_requests/138

Comment 2 Ashish Humbe 2016-11-17 07:29:44 UTC

I think there should be a check provided to confirm the satellite they are running is on Sat v 6.1.9 GA. This will avoid any chances of upgrading satellite from 6.1.8 or previous versions to 6.2.x.

Comment 5 Stephen Wadeley 2016-11-18 09:59:29 UTC

(In reply to Ashish Humbe from comment #2)
> I think there should be a check provided to confirm the satellite they are
> running is on Sat v 6.1.9 GA. This will avoid any chances of upgrading
> satellite from 6.1.8 or previous versions to 6.2.x.

As we do not know of an easy way to do that the extra steps which asks you to attempt to upgrade one last time using "katello-installer --upgrade" were added. Those are the steps "Update all packages" followed by "If you have new packages after updating" "katello-installer --upgrade". However, that step was added before 6.1.10 was released, then later updated to say it was optional by adding "If you have new packages after updating".

Comment 7 Andrew Dahms 2016-11-22 01:23:48 UTC

This content is live on the Customer Portal.

Closing.