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] [-L] [-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       -L
42
43                 Include localhost (the current node) in setup.
44
45
46       -a admin
47
48                 Specifies the list of admin hosts that can issue SNMP  query.
49                 Default is the current host.
50
51
52       -c community
53
54                 Specifies  the  community string used for SNMP query. Default
55                 is public.
56
57
58       -m mibs
59
60                 Specifies the list of MIBs that are readable in SNMP queries.
61                 Default is all MIBs required by FastFabric.
62
63

Examples

65       ethsetupssh -h 'elrond arwen' -a 'elrond'
66
67       HOSTS='elrond arwen' ethsetupsnmp -a 'elrond'
68
69       ethsetupsnmp -a 'elrond' -c 'public' -m '1.3.6.1.2.1.1 1.3.6.1.2.1.2'
70

Environment Variables

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

Description

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