Bug 1416649

Summary:	yum update might not be enough to get the same package versions as on the binary DVD
Product:	Red Hat Satellite	Reporter:	Evgeni Golov <egolov>
Component:	Docs Install Guide	Assignee:	Julie <juwu>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Russell Dickenson <rdickens>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	6.2.6	CC:	juwu
Target Milestone:	Unspecified
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-09-18 23:28:17 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:

Description Evgeni Golov 2017-01-26 08:12:30 UTC

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

Section Number and Name: 
3.2.3. Installing from the Offline Repositories

Describe the issue:
The guide currently suggests the user:

Ensure the base system is up to date with the Binary DVD image.
# yum update

However, the binary DVD only contains the GA bits of the release and the user might have updated packages by other means between installing the machine and installing Satellite (even if they should not).

If they did updates, this might lead to dependency errors when installing Satellite, which will try to fetch base packages from the RHEL ISO and these conflict with other already installed packages. Example yum error:

Error: Package: libkadm5-1.14.1-26.el7.x86_64 (rhel7)
           Requires: krb5-libs(x86-64) = 1.14.1-26.el7
           Installed: krb5-libs-1.14.1-27.el7_3.x86_64 (@rhel-7-server-rpms)
               krb5-libs(x86-64) = 1.14.1-27.el7_3
           Available: krb5-libs-1.14.1-26.el7.x86_64 (rhel7)
               krb5-libs(x86-64) = 1.14.1-26.el7
Error while executing command: 'yum install -y satellite'

To fix such a situation, the user might execute "yum distribution-synchronization" which will downgrade packages to the versions provided by the repos (which come from the ISO).

Suggestions for improvement:
Hint the user "yum distribution-synchronization" might be useful, but don't let them execute it by default.

Additional information:

Comment 5 Julie 2017-09-18 23:28:17 UTC

Documentation Link: https://access.redhat.com/documentation/en-us/red_hat_satellite/6.2/html-single/installation_guide/#installing_from_the_offline_repositories (step4)