HCCL_SOCKET_IFNAME

Description

Sets the name of the initial host root NIC of HCCL. The HCCL can obtain the host IP address based on this name to create a communicator.

The following configurations are supported:
  • eth: Use all NICs prefixed with eth.

    If multiple NIC prefixes are specified, separate them with commas (,).

    For example, export HCCL_SOCKET_IFNAME=eth,enp indicates that all NICs prefixed with eth or enp are used.

  • ^eth: Do not use NICs prefixed with eth.

    If multiple NIC prefixes are specified, separate them with commas (,).

    For example, export HCCL_SOCKET_IFNAME=^eth,enp indicates that no NIC prefixed with eth or enp is used.

  • =eth0: Use the specified eth0 NIC.

    If multiple NICs are specified, separate them with commas (,).

    For example, export HCCL_SOCKET_IFNAME==eth0,enp0 indicates that the eth0 and enp0 NICs are used.

  • ^=eth0: Do not use the specified eth0 NIC.

    If multiple NICs are specified, separate them with commas (,).

    For example, export HCCL_SOCKET_IFNAME=^=eth0,enp0 indicates that the eht0 and enp0 NICs are not used.

  • Multiple NICs can be configured in HCCL_SOCKET_IFNAME. The first matched NIC is used as the root NIC.
  • The priority of HCCL_IF_IP is higher than that of HCCL_SOCKET_IFNAME.
  • If HCCL_IF_IP and HCCL_SOCKET_IFNAME are not specified, the priority is as follows:
  • NICs other than Docker or local NICs (in ascending alphabetical order of NIC names) > Docker NICs > local NICs

Example

# Use eth0 or endvnic NICs.
export HCCL_SOCKET_IFNAME==eth0,endvnic

Restrictions

None

Applicability

Atlas Training Series Product