User Manual

Features Overview and ConfigurationRev 2.3-1.0.1
Mellanox Technologies
138
Both forms of configuration supply the same functionality. If both forms of configuration files
exist, the central configuration file has precedence and only this file will be used.
3.2.5.3.2.2 Central Configuration File - /etc/infiniband/mlx4_vnic.conf
The mlx4_vnic.conf file consists of lines, each describing one vNic. The following file format is
used:
name=eth47 mac=00:25:8B:27:16:84 ib_port=mlx4_0:1 vid=2 vnic_id=7 bx=BX001 eport=A11
The fields used in the file have the following meaning:
Table 5 - mlx4_vnic.conf file format
Field Description
name The name of the interface that is displayed when running ifconfig.
mac The mac address to assign to the vNic.
ib_port The device name and port number in the form [device name]:[port
number].
The device name can be retrieved by running ibv_devinfo
and using the output of hca_id field. The port number can have a
value of 1 or 2.
vid [Optional field] If VLAN ID exists, the vNic will be assigned the
specified
VLAN ID. This value must be between 0 and 4095.
•If the vid is set to 'all', the ALL-VLAN mode will be enabled and the vNic
will support multiple vNic tags.
•If no vid is specified or value -1 is set, the vNic will be assigned to the
default vHub associated with the GW.
vnic_id A unique number per vNic between 0 and 16K.
bx The BridgeX box system GUID or system name string.
eport The string describing the eport name.
pkey [Optional field] If discovery_pkey module parameter is set, this value
will control which partitions would be used to discover the gateways.
For more information about discovery_pkeys please refer to
Section 3.2.5.3.3.5, “Discovery Partitions Configuration”, on
page 144
3.2.5.3.2.3 vNic Specific Configuration Files - ifcfg-ethX
EoIB configuration can use the ifcfg-ethX files used by the network service to derive the needed
configuration. In such case, a separate file is required per vNic. Additionally, you need to update
the ifcfg-ethX file and add some new attributes to it.
On Red Hat Linux, the new file will be of the form:
DEVICE=eth2
HWADDR=00:30:48:7d:de:e4
BOOTPROTO=dhcp
ONBOOT=yes