1
2ethsetupsnmp(8)              EFSFFCLIRG (Man Page)             ethsetupsnmp(8)
3
4
5

NAME

7       ethsetupsnmp
8
9
10
11       Sets  up  SNMP on hosts to allow ethreport to query fabric data through
12       SNMP.
13

Syntax

15       ethsetupsnmp [-p] [-f  hostfile] [-h 'hosts'] [-a  admin]
16
17       [-c  community] [-m  mibs]
18

Options

20       --help
21
22                 Produces full help text.
23
24
25       -p
26
27                 Performs operation against all hosts in parallel.
28
29
30       -f hostfile
31
32                 Specifies the file with hosts in cluster.
33                 Default is /etc/eth-tools/hosts.
34
35
36       -h hosts
37
38                 Specifies the list of hosts in cluster.
39
40
41       -a admin
42
43                 Specifies the list of admin hosts that can issue SNMP  query.
44                 Default is the current host.
45
46
47       -c community
48
49                 Specifies  the  community string used for SNMP query. Default
50                 is public.
51
52
53       -m mibs
54
55                 Specifies the list of MIBs that are readable in SNMP queries.
56                 Default is all MIBs required by FastFabric.
57
58

Examples

60       ethsetupssh -h 'elrond arwen' -a 'elrond'
61
62       HOSTS='elrond arwen' ethsetupsnmp -a 'elrond'
63
64       ethsetupsnmp -a 'elrond' -c 'public' -m '1.3.6.1.2.1.1 1.3.6.1.2.1.2'
65

Environment Variables

67       The following environment variables are also used by this command:
68
69       HOSTS
70
71                 List of hosts, used if -h option not supplied.
72
73
74       HOSTS_FILE
75
76                 File containing list of hosts, used in absence of -f and -h.
77
78
79       FF_MAX_PARALLEL
80
81                 When -p option is used, maximum concurrent operations.
82
83
84

Description

86       ethreport  collects  fabric  data through issuing SNMP queries to hosts
87       and switches. Intel recommends that you set up SNMP using  ethsetupsnmp
88       to ensure ethreport has proper permission to query each host; each host
89       can provide desired data; and, all hosts have consistent SNMP  configu‐
90       ration.  ethsetupsnmp  accepts  the  following  parameters to configure
91       SNMP. These parameters can be specified as command  line  arguments  or
92       collected during user interaction. ethsetupsnmp works under user inter‐
93       action mode when one or more of the required parameters are not  speci‐
94       fied in command line.
95
96admin:  Space separated management node names. ethsetupsnmp will
97              configure each host to allow SNMP query from these nodes.
98
99community: The community string for SNMP v2 query.  The  default
100              is  public.  If  set  to  a different string, ensure update hpn‐
101              mgmt_config.xml with the string.
102
103mibs: The MIBs allow SNMP query. FastFabric requires the follow‐
104              ing  MIBs.  You  can  provide extra MIBs if they are required by
105              other applications.1.3.6.1.2.1.1 (SNMPv2-MIB:system)
106
107              1.3.6.1.2.1.2 (IF-MIB:interfaces)
108
109              1.3.6.1.2.1.4 (IP-MIB:ip)
110
111              1.3.6.1.2.1.10.7 (EtherLike-MIB:dot3)
112
113              1.3.6.1.2.1.31.1 (IP-MIB:ifMIBObjects)
114
115       When working under interactive mode, follow the prompts to complete the
116       operation.Configuring SNMP...
117
118       Enter space separated list of admin hosts (mindy1):
119
120       Enter SNMP community string (public):
121
122       Fast Fabric requires the following MIBs:
123
124              1.3.6.1.2.1.1 (SNMPv2-MIB:system)
125
126              1.3.6.1.2.1.2 (IF-MIB:interfaces)
127
128              1.3.6.1.2.1.4 (IP-MIB:ip)
129
130              1.3.6.1.2.1.10.7 (EtherLike-MIB:dot3)
131
132              1.3.6.1.2.1.31.1 (IP-MIB:ifMIBObjects)
133
134       Do you accept these MIBs [y/n] (y):
135
136       Enter space separated list of extra MIBs to support (NONE):
137
138       Will config SNMP with the following settings:
139
140       admin hosts: mindy1
141
142       community: public
143
144       MIBs: 1.3.6.1.2.1.1 1.3.6.1.2.1.2 1.3.6.1.2.1.4 1.3.6.1.2.1.10.7
145
146       1.3.6.1.2.1.31.1
147
148       Do you accept these settings [y/n] (y):
149
150       scp -q /usr/sbin/ethsetupsnmp root@[mindy1]:/tmp/ethsetupsnmp
151
152       scp -q /usr/sbin/ethsetupsnmp root@[mindy2]:/tmp/ethsetupsnmp
153
154       [root@phwfstl005]# /tmp/ethsetupsnmp -l -a 'mindy1' -c 'public' -m
155
156       '1.3.6.1.2.1.1     1.3.6.1.2.1.2     1.3.6.1.2.1.4     1.3.6.1.2.1.10.7
157       1.3.6.1.2.1.31.1
158
159       ';rm -f /tmp/ethsetupsnmp
160
161       Configuring SNMP...
162
163       SNMP configuration completed
164
165       [root@phwfstl006]# /tmp/ethsetupsnmp -l -a 'mindy1' -c 'public' -m
166
167       '1.3.6.1.2.1.1     1.3.6.1.2.1.2     1.3.6.1.2.1.4     1.3.6.1.2.1.10.7
168       1.3.6.1.2.1.31.1
169
170       ';rm -f /tmp/ethsetupsnmp
171
172       Configuring SNMP...
173
174       SNMP configuration completed
175
176       SNMP configuration completed
177
178
179
180Copyright(C) 2020              Intel Corporation               ethsetupsnmp(8)
Impressum