Modify the NI-RPDSsc aliases configuration file to assign user-defined, human-readable names to network interfaces (NICs), RAIDs, and NI-RPDSsc endpoints.

Find the file at /etc/nirpdssc/nirpdssc_aliases.conf.

[NIC Aliases] Section

Use the [NIC Aliases] section to map user-defined aliases for network interfaces (NICs) to the PCI address of each network interface device.

  • Section Name—[NIC Aliases]
  • Keys—User-defined network interface names, containing only alpha-numeric characters, hyphens, and/or underscores
  • Values—PCI addresses of network interfaces, formatted as XXXX:XX:XX.X

    • Use the PCI addresses and topology information for the NICs that were recorded when following the steps in Mapping 100 GbE Ports to populate the PCI addresses in the [NIC Aliases] section of this configuration file.

    Example: 

    [NIC Aliases]
my_nic_0 = "0000:41:00.0"
my_nic_1 = "0000:41:00.1"
my_nic_2 = "0000:a1:00.0"
my_nic_3 = "0000:a1:00.1"

    [RAID Aliases] Section

    Use the [RAID Aliases] section to map user-defined aliases for NVMe RAIDs to their respective mount points. The aliases defined in this section are used in the [Endpoints] section to define a human-readable data path.

  • Section Name—[RAID Aliases]
  • Keys—User-defined NVMe RAID names, containing only alpha-numeric characters, hyphens, and/or underscores
  • Values—Paths to the NVMe RAID mount point, formatted as /mnt/mdX

    • Example:

    [RAID Aliases]
raid_0 = "/mnt/md0"
raid_1 = "/mnt/md1"
raid_2 = "/mnt/md2"
raid_3 = "/mnt/md3"
raid_4 = "/mnt/md4"
raid_5 = "/mnt/md5"
raid_6 = "/mnt/md6"
raid_7 = "/mnt/md7"

    [Endpoints] Section

    Use the [Endpoints] section to map user-defined aliases for NI-RPDSsc endpoints to their respective data paths. A data path defines the physical Ethernet port network interface (configured in the [NIC Aliases] section) and UDP port for a single channel of data and assigns an NVMe RAID (configured in the [RAID Aliases] section) to which data will be recorded for each channel. Ensure that each data path pairs a network interface with an NVMe RAID on the same NUMA node.

  • Section Name—[Endpoints]
  • Keys—User-defined NI-RPDSsc endpoint names, containing only alpha-numeric characters, hyphens, and/or underscores
  • Values—NI-RPDSsc data paths, formatted as <NIC ALIAS>:<UDP Port>--><RAID ALIAS>
    • Note Select unique UDP port addresses between 1025 and 65535.

    Example:

    [Endpoints]
ep_0 = "my_nic_0:2000-->raid_0"
ep_1 = "my_nic_0:2001-->raid_1"
ep_2 = "my_nic_1:2002-->raid_2"
ep_3 = "my_nic_1:2003-->raid_3"
ep_4 = "my_nic_2:2004-->raid_4"
ep_5 = "my_nic_2:2005-->raid_5"
ep_6 = "my_nic_3:2006-->raid_6"
ep_7 = "my_nic_3:2007-->raid_7"