Bug 447882

Summary:	RFE: add or update docs for /etc/sysconfig/network-scripts
Product:	Red Hat Enterprise Linux 5	Reporter:	Murray McAllister <mmcallis>
Component:	doc-Deployment_Guide	Assignee:	Douglas Silas <dhensley>
Status:	CLOSED NOTABUG	QA Contact:	Joshua Wulf <jwulf>
Severity:	low	Docs Contact:
Priority:	low
Version:	5.5	CC:	lcarlon, vdanen
Target Milestone:	rc	Keywords:	Documentation
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2009-09-14 17:10:14 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Murray McAllister 2008-05-22 09:57:23 UTC

Add documentation for the scripts in /etc/sysconfig/network-scripts/. This has
sort of been done here
http://www.redhat.com/docs/manuals/enterprise/RHEL-5-manual/en-US/RHEL510/Deployment_Guide/s1-networkscripts-control.html
,
http://www.redhat.com/docs/manuals/enterprise/RHEL-5-manual/en-US/RHEL510/Deployment_Guide/s1-networkscripts-static-routes.html,
and at
http://www.redhat.com/docs/manuals/enterprise/RHEL-5-manual/en-US/RHEL510/Deployment_Guide/s1-networkscripts-functions.html.

Maybe even describing options for the following would help (from ifcfg-ethx):

DEVICE=eth1
ONBOOT=yes
BOOTPROTO=dhcp
HWADDR=xxxxxx
TYPE=Ethernet
USERCTL=no
IPV6INIT=no
PEERDNS=yes

[I first tried to find this where all other /etc/sysconfig/[x] files were
described...]

Cheers,

Murray.

Comment 1 Murray McAllister 2008-05-22 21:51:27 UTC

*** Bug 447880 has been marked as a duplicate of this bug. ***

Comment 3 Douglas Silas 2009-09-13 19:07:10 UTC

Hi Murray,

The timeline for sorting this out is probably 5.5.

I agree with you that the networking sections, and particularly those dealing with the configuration files under /etc/sysconfig/network-scripts/ and the /etc/sysconfig/network file, could be combined and made more coherent.

Looking at the current 5.4 online docs, the ifcfg-ethX parameters do seem to be documented (though probably not comprehensively):

See:

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.4/html/Deployment_Guide/s1-networkscripts-interfaces.html

Under: "Below is a listing of the configurable parameters in an Ethernet interface configuration file"

What I would like to see is a description of how the following configuration files interact:

/etc/sysconfig/network
/etc/sysconfig/network-scripts
/etc/dhclient-ethX.conf
/etc/hosts

...especially in conjunction with system-config-network (not to mention NetworkManager).

It would, IMO, be beneficial too to add the discussion of the /etc/sysconfig/network parameters to the network configuration section, and to link to that from the /etc/sysconfig/network file description (thus moving discussion of all networking config files to the place). Would you agree with this proposal? Is this what you were thinking of, or do you have an alternative/more specific proposal?

Thanks,

Silas

Comment 4 Murray McAllister 2009-09-13 21:49:58 UTC

re comment #3, I had not seen that link before, which looks like it describes what I was looking for, sorry.