Bug 729691

Summary:	Documentation error for CMSCONFFILE DASD= example
Product:	Red Hat Enterprise Linux 6	Reporter:	Philip Rowlands <phr>
Component:	doc-Installation_Guide	Assignee:	Jack Reed <jreed>
Status:	CLOSED CURRENTRELEASE	QA Contact:	ecs-bugs
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	6.3	CC:	atodorov, brueckner, jreed, jskeoch, pbokoc
Target Milestone:	rc	Keywords:	Documentation
Target Release:	---
Hardware:	s390x
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:	681219	Environment:
Last Closed:	2011-12-09 02:26:30 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Deadline:	2011-09-02

Description Philip Rowlands 2011-08-10 14:34:35 UTC

A separate bug was requested for this documentation issue.

+++ This bug was initially created as a clone of Bug #681219 +++

Quoting Red Hat Enterprise Linux 6 Installation Guide Edition 1.0, section 26.3. Installation network parameters:

http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Installation_Guide/ch-parmfiles-Installation_network_parameters.html

DASD=
 Defines the DASD or range of DASDs to configure for the installation. For a detailed description of the syntax, refer to the dasd_mod device driver module option described in the chapter on the DASD device driver in Linux on System z Device Drivers, Features, and Commands on Red Hat Enterprise Linux 6. 

[snip]

 For example: 
DASD=eb1c,0.0.a000-0.0.a003,eb10-eb14(diag),0.0.ab1c(ro:diag)


Because the DASD= config in CMSCONFFILE is sourced by the shell, the right hand side needs to be quoted to avoid errors reading the metacharacters '(' and ')'. For example:

DASD='eb1c,0.0.a000-0.0.a003,eb10-eb14(diag),0.0.ab1c(ro:diag)'

For completeness, why not single-quote all CMSCONFFILE parameters given by example, both in "Installation network parameters" and "Sample parameter file and CMS configuration file"?

I haven't checked, but this error probably appears in the Installation Guide for other RHEL versions.

Comment 6 Jack Reed 2011-08-29 01:29:23 UTC

Thanks for bringing this to our attention, Philip.

The DASD example was fixed in build 1.0-43 of the guide, and the remaining examples have been corrected for build 1.0-45.