Bug 1404457

Summary:	[Docs] Add a note to not run satellite-installer in /usr/share/foreman
Product:	Red Hat Satellite	Reporter:	Thom Carlin <tcarlin>
Component:	Docs Install Guide	Assignee:	Lucie Jirakova <ljirakov>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Charles Wood <chwood>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	6.2.5	CC:	adahms
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-02-07 17:07:34 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 Thom Carlin 2016-12-13 22:00:14 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: 

Section 6.2 UPGRADING A CONNECTED SATELLITE SERVER
Describe the issue: 

Running satellite-installer while in /usr/share/foreman directory (or any other directory with a config subdirectory) causes "ERROR: Scenario (config/satellite.yaml) was not found, can not continue"

Suggestions for improvement: 

add a note that if the error is encountered, the user should move to a different directory (e.g. cd /root)

Additional information: 

A search found 15 occurrences of satellite-installer in the document

Comment 1 Andrew Dahms 2016-12-14 23:43:40 UTC

Assigning to Lucie for review.

Lucie - rather than including this with every instance, I wonder if there is an introductory section where we talk about the installer where we could add a note like this.

Comment 7 Lucie Jirakova 2017-02-07 17:07:34 UTC

The Installation Guide updated with warnings in appropriate places is now live on Customer Portal:

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

(Search for "Warning" admonition.)