Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

By default, all Swarm Ethernet network adapters are encapsulated into a redundant bond interface where one device is active and the remaining devices are backups. In this default mode, the first network device is the preferred device. Override this behavior by:

  • Excluding a network adapter from use, such as an intelligent platform management interface (IPMI) card.

  • Changing the preferred network adapter for network load management.

  • Bonding multiple adapters together for increased throughput (such as NIC teaming).

...

To override the Swarm default network device settings, edit one of the following boot configuration files:

  • syslinux.cfg if the node is booting from the USB flash drive

  • pxelinux.cfg if the node is booting from the network

In the configuration file, a kernel parameter named castor_net is included in the append clause. castor_net allows specifying both the bonding mode for the adapters as well as a comma-separated ordered list of the network devices Swarm can use. The first device in the list is the preferred interface used when online.

Info

Important

The list of network devices must use the adapter names assigned by Swarm. To locate the current list of adapter names and MAC addresses, boot the node from the Swarm USB drive to access the System Menu.

Swarm assigns device names to adapters based on a sorted list of MAC addresses. Adding network hardware can change the assignment order.

Below are some examples of assigning device names in the configuration file. The other portions of the append clause are abbreviated for clarity. Note the trailing colon after the bonding mode:

...