1
2opadisableports(8)     Master map: IFSFFCLIRG (Man Page)    opadisableports(8)
3
4
5

NAME

7       opadisableports
8
9
10
11       (Linux)  Accepts  a  CSV file listing links to disable. For each HFI-SW
12       link, the switch side of the link is disabled. For each SW-SW link, the
13       side of the link with the lower LID (typically, the side closest to the
14       SM) is disabled. This approach generally permits  a  future  opaenable‐
15       ports  operation  to  re-enable the port once the issue is corrected or
16       ready to be retested. When using the -R option, this tool does not look
17       at  the  routes, it disables the switch ports with the lower value LID.
18       The list of disabled ports is tracked in /etc/opa/disabled*.csv.
19

Syntax

21       opadisableports [-R] [-h hfi] [-p port] [ reason] < disable.csv
22

Options

24       --help    Produces full help text.
25
26
27       -R        Does not attempt to get routes for computation  of  distance.
28                 Instead, disables switch port with lower LID assuming that it
29                 is closer to this node.
30
31
32       -h hfi    Specifies the HFI, numbered 1..n. Using 0 specifies that  the
33                 -p port port is a system-wide port number. (Default is 0.)
34
35
36       -p port   Specifies  the  port,  numbered  1..n.  Using 0 specifies the
37                 first active port. (Default is 0.)
38
39
40       reason    Specifies optional text describing why ports are  being  dis‐
41                 abled. If used, text is saved in the reason field of the out‐
42                 put file.
43
44
45       disable.csv
46                 Specifies the input file listing the links  to  disable.  The
47                 list   is   of   the   form:   NodeGUID;PortNum;NodeType;Nod‐
48                 eDesc;NodeGUID;PortNum; NodeType;NodeDesc;Reason
49
50
51                 For each listed link, the switch port closer to this node  is
52                 disabled. The reason field is optional. An input file such as
53                 this can be generated  by  using  opaextractbadlinks,  opaex‐
54                 tractmissinglinks, or opaextractsellinks.
55
56                 Information  about the links disabled and the reason is saved
57                 (in the same format) to an output  file  named  /etc/opa/dis‐
58                 abled:hfi:port.csv  where  the hfi:port part of the file name
59                 is replaced by the HFI number and the port number being oper‐
60                 ated  on  (such  as 1:1 or 2:1). This CSV file can be used as
61                 input to opaenableports.
62
63

-h and -p options permit a variety of selections:

65       -h 0      First active port in system (default).
66
67
68       -h 0 -p 0 First active port in system.
69
70
71       -h x      First active port on HFI x.
72
73
74       -h x -p 0 First active port on HFI x.
75
76
77       -h 0 -p y Port y within system (no matter which ports are active).
78
79
80       -h x -p y HFI x, port y.
81
82

Examples

84       opadisableports 'bad cable' < disable.csv
85       opadisableports -h 1 -p 1 'dead servers' < disable.csv
86       opaextractsellinks -F lid:3 | opadisableports 'bad server'
87       opaextractmissinglinks -T /etc/opa/topology.0:0.xml | opadisableports
88
89
90
91Copyright(C) 2015-2018         Intel Corporation            opadisableports(8)