nics.5

NAME

nics - a table in the xCAT database.

SYNOPSIS

nics Attributes: node, nicips, nichostnamesuffixes, nichostnameprefixes, nictypes, niccustomscripts, nicnetworks, nicaliases, nicextraparams, nicdevices, nicsadapter, comments, disable

DESCRIPTION

Stores NIC details.

nics Attributes:

node

The node or group name.

nicips

Comma-separated list of IP addresses per NIC.
To specify one ip address per NIC:

<nic1>!<ip1>,<nic2>!<ip2>,…, for example, eth0!10.0.0.100,ib0!11.0.0.100

To specify multiple ip addresses per NIC:

<nic1>!<ip1>|<ip2>,<nic2>!<ip1>|<ip2>,…, for example, eth0!10.0.0.100|fd55::214:5eff:fe15:849b,ib0!11.0.0.100|2001::214:5eff:fe15:849a. The xCAT object definition commands support to use nicips.<nicname> as the sub attributes.

Note: The primary IP address must also be stored in the hosts.ip attribute. The nichostnamesuffixes should specify one hostname suffix for each ip address.

nichostnamesuffixes

Comma-separated list of hostname suffixes per NIC.
If only one ip address is associated with each NIC:

<nic1>!<ext1>,<nic2>!<ext2>,…, for example, eth0!-eth0,ib0!-ib0

If multiple ip addresses are associated with each NIC:

<nic1>!<ext1>|<ext2>,<nic2>!<ext1>|<ext2>,…, for example, eth0!-eth0|-eth0-ipv6,ib0!-ib0|-ib0-ipv6.

The xCAT object definition commands support to use nichostnamesuffixes.<nicname> as the sub attributes.

Note:  According to DNS rules a hostname must be a text string up to 24 characters drawn from the alphabet (A-Z), digits (0-9) and minus sign (-). When you are specifying "nichostnamesuffixes" or "nicaliases" make sure the resulting hostnames will conform to this naming convention

nichostnameprefixes

Comma-separated list of hostname prefixes per NIC.
If only one ip address is associated with each NIC:

<nic1>!<ext1>,<nic2>!<ext2>,…, for example, eth0!eth0-,ib0!ib-

If multiple ip addresses are associated with each NIC:

<nic1>!<ext1>|<ext2>,<nic2>!<ext1>|<ext2>,…, for example, eth0!eth0-|eth0-ipv6i-,ib0!ib-|ib-ipv6-.

The xCAT object definition commands support to use nichostnameprefixes.<nicname> as the sub attributes. Note: According to DNS rules a hostname must be a text string up to 24 characters drawn from the alphabet (A-Z), digits (0-9) and minus sign (-). When you are specifying “nichostnameprefixes” or “nicaliases” make sure the resulting hostnames will conform to this naming convention

nictypes

Comma-separated list of NIC types per NIC. <nic1>!<type1>,<nic2>!<type2>, e.g. eth0!Ethernet,ib0!Infiniband. The xCAT object definition commands support to use nictypes.<nicname> as the sub attributes.

niccustomscripts

Comma-separated list of custom scripts per NIC. <nic1>!<script1>,<nic2>!<script2>, e.g. eth0!configeth eth0, ib0!configib ib0. The xCAT object definition commands support to use niccustomscripts.<nicname> as the sub attribute .

nicnetworks

Comma-separated list of networks connected to each NIC.
If only one ip address is associated with each NIC:

<nic1>!<network1>,<nic2>!<network2>, for example, eth0!10_0_0_0-255_255_0_0, ib0!11_0_0_0-255_255_0_0

If multiple ip addresses are associated with each NIC:

<nic1>!<network1>|<network2>,<nic2>!<network1>|<network2>, for example, eth0!10_0_0_0-255_255_0_0|fd55:faaf:e1ab:336::/64,ib0!11_0_0_0-255_255_0_0|2001:db8:1:0::/64. The xCAT object definition commands support to use nicnetworks.<nicname> as the sub attributes.

nicaliases

Comma-separated list of hostname aliases for each NIC.
Format: eth0!<alias list>,eth1!<alias1 list>|<alias2 list>

For multiple aliases per nic use a space-separated list.

For example: eth0!moe larry curly,eth1!tom|jerry

nicextraparams

Comma-separated list of extra parameters that will be used for each NIC configuration.
If only one ip address is associated with each NIC:

<nic1>!<param1=value1 param2=value2>,<nic2>!<param3=value3>, for example, eth0!MTU=1500,ib0!MTU=65520 CONNECTED_MODE=yes.

If multiple ip addresses are associated with each NIC:

<nic1>!<param1=value1 param2=value2>|<param3=value3>,<nic2>!<param4=value4 param5=value5>|<param6=value6>, for example, eth0!MTU=1500|MTU=1460,ib0!MTU=65520 CONNECTED_MODE=yes.

The semicolon separator is needed if there are multiple values for extra parameters:

bond0!BONDING_OPTS=lacp_rate=1;miimon=100;mode=802.3ad

The xCAT object definition commands support to use nicextraparams.<nicname> as the sub attributes.

nicdevices

Comma-separated list of NIC device per NIC, multiple ethernet devices can be bonded as bond device, these ethernet devices are separated by | . <nic1>!<dev1>|<dev3>,<nic2>!<dev2>, e.g. bond0!eth0|eth2,br0!bond0. The xCAT object definition commands support to use nicdevices.<nicname> as the sub attributes.

nicsadapter

Comma-separated list of NIC information collected by getadapter. <nic1>!<param1=value1 param2=value2>,<nic2>!<param4=value4 param5=value5>, for example, enP3p3s0f1!mac=98:be:94:59:fa:cd linkstate=DOWN,enP3p3s0f2!mac=98:be:94:59:fa:ce candidatename=enP3p3s0f2/enx98be9459face

comments

Any user-written notes.

disable

Set to ‘yes’ or ‘1’ to comment out this row.

SEE ALSO

nodels(1), chtab(8), tabdump(8), tabedit(8)