Bug 1318375

Summary: Incorrect instructions on how to upgrade the system off-line
Product: Red Hat Enterprise Linux 6 Reporter: Jaromir Hradilek <jhradile>
Component: doc-Deployment_GuideAssignee: Maxim Svistunov <msvistun>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: high Docs Contact:
Priority: high    
Version: 6.8CC: mdekan, rhel-docs
Target Milestone: rcKeywords: Documentation
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-05-19 14:49:29 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 Jaromir Hradilek 2016-03-16 16:54:19 UTC 
Document URL: 

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/ch-yum.html#s1-yum-upgrade-system

Section Number and Name:

The “Upgrading the System Off-line with ISO and Yum” section in the Yum chapter.

Describe the issue:

Step 4 of the procedure tells customers to add the following line to the /etc/yum.repos.d/<name>.repo file:

  baseurl=file://mount_dir

The <mount_dir> placeholder is typically replaced with an absolute path beginning with another forward slash, for example file:///media/rhel6/, but this is not immediately obvious to the reader and does confuse customers.

Suggestions for improvement:

Either replace the line with the following:

  baseurl=file:///mount_dir

or make it absolutely clear in the text that an additional slash is required.

Additional information: 

Reported by Michal Dekan based on customer feedback.