1mlnx-tools(8)               System Manager's Manual              mlnx-tools(8)
2
3
4

NAME

6       ib2ib_setup  -  Generate  files  required  for preparing the network to
7       work with IB Router
8
9

SYNOPSIS

11       ib2ib_setup [-dDEVICE][-sSUBNET_NUMBER][-nNETWORK_SUBNET]
12
13       ib2ib_setup [-fIPSFILES]ips_file...
14
15

DESCRIPTION

17       This  program  invokes ibnetdiscover to scan the network to extract the
18       data about host port names, LIDs and GUIDs, and uses arping to scan the
19       subnet for IPs. It then writes out  the  information  into  3  separate
20       files: ip2gid.db, guid2lid and hosts.
21
22
23       ip2gid.db:
24              This file holds the IP to GID mapping used by ibacm service run‐
25              ning on each machine in the cluster.
26
27       guid2lid:
28              This  file holds the mapping of GUID to LID. It should be copied
29              into the SM cache directory.  At the moment it is only supported
30              by host  based  OpenSM  or  UFM  appliance (switch based  OpenSM
31              does not support it).
32
33       hosts: This  file holds mapping of host name to IP and should be placed
34              in /etc/hosts and pointed by nsswitch.conf (lathernatively use a
35              DNS).
36
37

OPTIONS

39       -d     "device  name". For example: -d ib0. The interface through which
40              the subnet is scanned for IP to GUID mapping using arping.
41
42       -n     "Networks/mask      to      scan".      For      example:     -n
43              12.1.1.1/24,24.1.1.1/24   (note:different  subnet  separated  by
44              comma).  The flag -n is provided a set of IPs to be  scanned  on
45              the  subnet (i.e. A.B.C.D/24) or use the -f with text file hold‐
46              ing an IP on each line.
47
48       -s     "Subnet number" - unique number for local subnet. (on each  sub‐
49              net you should give different number.)
50
51       -h     "help" Print a brief help message and exits.
52
53       -f     "filename"  Specifies  a  file  that holds IPs list. If provided
54              avoids the scan of IPs and overrides the -n option.
55
56

EXAMPLES

58       ib2ib2_setup with -a (subnet to scan):
59              ib2ib_setup -d ib0 -a 61.130.1.1/24,61.130.2.1/24 -s 3
60
61
62       ib2ib_Setup with -f (read IPs from file):
63              ib2ib_setup -d ib0 -f my_ips_list.txt -s 3
64
65

SEE ALSO

67       ibnetdiscover(8)
68
69
70
71                                  2021-05-12                     mlnx-tools(8)
Impressum