mlnx-tools(8)

✨ NAME ✨

ib2ib_setup — bestie, this is the little script that generates the files you need to prep your network so it can hang out with an IB Router 💅 (it lives in the mlnx-tools(8) manual, iykyk)

🦋 SYNOPSIS 🦋

ib2ib_setup [-dDEVICE][-sSUBNET_NUMBER][-nNETWORK_SUBNET]

ib2ib_setup [-fIPSFILES]ips_file...

🌸 DESCRIPTION 🌸

okay so here's the tea, bestie 🍓 — ib2ib_setup goes and calls ibnetdiscover to scan the whole network and pull out the deets about host port names, LIDs and GUIDs. Then it uses arping to scan the subnet for IPs. And then — the moment we've all been waiting for — it writes all of that into 3 separate files, no cap:

• ip2gid.db — this one holds the IP to GID mapping that the ibacm service running on every machine in the cluster uses. literally every single one 🫶
• guid2lid — this one holds the mapping of GUID to LID. you gotta copy it into the SM cache directory. and ngl, rn it's only supported by host based OpenSM or a UFM appliance — switch based OpenSM does NOT support it 💀 so don't come crying to me
• hosts — this one holds the mapping of host name to IP, and it belongs in /etc/hosts, pointed at by nsswitch.conf (or alternatively, just use a DNS, main character energy 🌈)

💖 OPTIONS 💖

• -d — "device name". like, for example: -d ib0. it's the interface that the subnet gets scanned through for the IP to GUID mapping using arping 👑
• -n — "Networks/mask to scan". for example: -n 12.1.1.1/24,24.1.1.1/24 (note: different subnets get separated by a comma, okay? don't forget). the -n flag hands it a set of IPs to be scanned on the subnet (i.e. A.B.C.D/24), or you can use -f with a text file holding an IP on each line 🎀
• -s — "Subnet number" — a unique number for the local subnet. (on each subnet you should give a different number, fr fr, don't be lazy) ✨
• -h — "help". prints a brief help message and exits. short and sweet, we love that 💅
• -f — "filename". specifies a file that holds the IPs list. if you provide it, it skips the scan of IPs entirely and overrides the -n option 🔥

🎀 EXAMPLES 🎀

ib2ib_setup with -a (subnet to scan):

ib2ib_setup -d ib0 -a 61.130.1.1/24,61.130.2.1/24 -s 3

ib2ib_setup with -f (read IPs from file):

ib2ib_setup -d ib0 -f my_ips_list.txt -s 3

⭐ SEE ALSO ⭐

• ibnetdiscover(8) — go read that one too, bestie 🧚

💜 okay that's the whole page, you ate that. now go configure something iconic.

this was the mlnx-tools(8) manual page from the System Manager's Manual, dated 2021-05-12 — mwah, love u, byeeee 🦋✨💖