Bug 1537158

Summary:	Update warning about not deleting the manifest
Product:	Red Hat Satellite	Reporter:	Stephen Wadeley <swadeley>
Component:	Docs Upgrading and Updating Red Hat Satellite	Assignee:	Melanie Corr <mcorr>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Stephen Wadeley <swadeley>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	6.3.0	CC:	mcorr
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:	2018-01-31 16:13:13 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:	1517871

Description Stephen Wadeley 2018-01-22 15:16:11 UTC

Document URL: 

https://access.redhat.com/documentation/en-us/red_hat_satellite/6.3-beta/html-single/upgrading_and_updating_red_hat_satellite/

Section Number and Name: 

Multiple occurrences

Describe the issue: 

We tell the reader what not to do, but not what to do.

We have this in the "Before You Begin" section

Ensure that you do not delete the manifest from the Customer Portal or in the Satellite Web UI because this removes all the entitlements of your content hosts.

I think that can stay as it is, but later in the procedure we have:

If you get an error when trying to update the Satellite Tools repository, make sure you do not delete the manifest from the Customer Portal or in the Satellite Web UI because this removes all the entitlements of your content hosts. 

Suggestions for improvement: 

Change all occurrences of:

If you get an error when trying to update the Satellite Tools repository, make sure you do not delete the manifest from the Customer Portal or in the Satellite Web UI because this removes all the entitlements of your content hosts. 

to:

If you get an error when trying to update a repository, ensure you do not delete the manifest from the Customer Portal or in the Satellite Web UI because this removes all the entitlements of your content hosts. Refresh the manifest and if the problem persists, raise a support request.

Additional information: 

This also make the warning more generic, its not only for Tools Repo problems.

Comment 3 Melanie Corr 2018-01-31 16:13:13 UTC

These changes are now live on the Customer Portal.