NAME

network - LCFG network component

DESCRIPTION

This component configures the /etc/sysconfig/network-scripts configuration files and /etc/hosts.

**** IMPORTANT NOTE: DUE TO CHANGES IN EL7 SUPPORT FOR THAT  ****
**** PLATFORM IS VERY LIMITED!                               ****
offline

This resource, if set to yes, stops the object from making any configuration changes when the start method is invoked. This is handy for portables where the run method is user invoked to make configuration changes.

interfaces

A list of ethernet interface names. Each interface must have the following tagged resources.

hostname_interface

This resource specifies the hostname for this interface.

device_interface

This resource specifies the ether device for this interface. The default value of auto indicates that the ether device is set to the tag key interface.

physdev_interface

This resource is used when configuring VLAN interfaces to identify the physical device associated with this VLAN interface.

ipaddr_interface

This resource specifies the IP address for this interface. The default value of auto indicates that the component should attempt to resolve the IP address from then hostname for this interface. If this resource is set to DHCP the interface is configured to use DHCP.

netmask_interface

This resource specifies the netmask for this interface.

network_interface

This resource specifies the network for this interface. The default value of auto indicates that the component should derive the network from the IP address. A class C address is currently assumed.

broadcast_interface

This resource specifies the broadcast address for this interface. The default value of auto indicates that the component should derive the broadcast address from the IP address. A class C address is currently assumed.

onboot_interface

This resource specifies whether this interface should be configured at boot time. The default value is "yes".

autoup_interface

This resource specifies whether a new interface should be brought up manually by the network component. This is useful when a machine is already booted and running and you want the new interface to be brought up automatically. The default value is "no".

autodown_interface

This resource specifies whether this interface should be taken down automatically by the network component if the associated resources are removed. The default value is "no".

hostsorder_interface

This resource specifies which form of hostname is entered into the /etc/hosts file. The value full specifies that the fully qualified name should be entered, while the value short specifies that just the simple hostname should be entered. Both values can be specified, with order being significant.

vlan_interface

This resource, if set to yes, will identify this interface as a VLAN interface.

hwaddr_interface

This resource can be used to hardwire a particular network card to an interface. This is required for multi-homed machines.

master_interface

This resource, if set, indicates that this particular interface is a slave of a bonding interface. The value specifies the master bonding interface (eg bond0).

reorderhdr_interface

This resource can be used to enable ethernet header reordering for the given interface.

persistentdhclient_interface

This resource, if set to yes, will cause dhclient to become a daemon rather than exiting if it can't get an IP address. It has no effect unless ipaddr_interface is set to DHCP

type_interface

This resource can be used to define the type of the interface. The only currently supported values are Bridge and verbatim. If the type is set to verbatim, the component builds the configuration for the interface from the vlines_interface resource and ignores all other resources for this interface.

vlines_interface

A list of verbatim line tags for the interface. Can be used to set additional options for all types of interfaces.

vline_interface_tag

The content line associated with tag tag.

bridge_interface

This resource, if set, indicates that this particular interface is a child of a bridge interface. The value specifies the bridge interface (eg br0).

delay_interface

If the interface is of type Bridge, specifies (in seconds) the bridge's bridge forward delay. Defaults to 5 seconds.

stp_interface

Specifies whether STP is enabled for the specified interface. Only applicable if the interface is of type Bridge. Defaults to on.

nm_controlled_interface

Specifies whether the interface is managed by NetworkManager. Defaults to 'no'.

vlannametype

This resource can be used to override the default VLAN interface naming scheme.

extrahosts

A list of additional entries for the /etc/hosts file. Each entry should have the form hentry_tag.

hentry_tag

The value for the /etc/hosts entry denoted by tag.

gateway

A list of gateways for this machine. The actual gateway used will be chosen randomly from this list.

gatewaydev

The ethernet interface to use to communicate to the default gateway.

hostschangereboot

This resource specifies whether changes to /etc/hosts should trigger a reboot. The default value is "yes".

ifcfgchangereboot

This resource specifies whether changes to ifcfg files should trigger a reboot. The default value is "yes".

persistentnetrules

If specified, the filename of the udev persistent network interface mapping file to be configured by the component. Needed for SL6 and onwards to tie particular network interfaces to eth{n} names.

netmanconf

If specified, the name of the NetworkManager configuration file to build (using verbatim lines specified by the netman_vlines resource.

netman_vlines

A list of verbatim line tags to populate the NetworkManager config specified by the netmanconf resource.

netman_vline_tag

The content line associated with tag tag.

MONITORING RESOURCES

This component supports the LCFG monitoring system, and contains additional hooks to enable monitoring by the Nagios engine.

The Nagios monitoring of the network component is performed by a "passive check" where the monitored service "checks in" with the Nagios service on a periodic basis; this check is performed by the /usr/sbin/check_network script (usually called by cron). Currently, the only aspect of the network component that is monitored is bonded ethernet interfaces.

nagios_server

Indicates to which Nagios server the network checks should report.

nagios_freshness

Indicates to the Nagios service how long to wait after the last successful report before flagging a problem. The value is in seconds.

identity

The kerberos identity used in communications with Nagios.

INTERNAL RESOURCES

These resources are for the internal working of the system and aren't expected to be modified.

keytab

The location of the kerberos keytab holding the credentials to be used to communicate with the Nagios service.

PLATFORMS

Fedora3, Fedora5, Fedora6, Scientific5, Fedora12, Fedora13

AUTHOR

Alastair Scobie <ascobie@inf.ed.ac.uk>