ethsetupsnmp(8)

💖 ethsetupsnmp(8) — EFSFFCLIRG (Man Page) 💖

okay bestie, sit down, hydrate, and let me tell you about ethsetupsnmp — that's the little command in the EFSFFCLIRG manual, section 8, and it is literally the glow-up your fabric's SNMP needs. ✨

---

🌸 NAME 🌸

ethsetupsnmp — bestie, it sets up SNMP on hosts so that ethreport can query fabric data through SNMP. that's it. that's the whole job. and it eats. 💅

---

🎀 Syntax 🎀

ethsetupsnmp [-p] [-L] [-f  hostfile] [-h 'hosts'] [-a  admin]

[-c  community] [-m  mibs]

no cap, that's the whole shape of it. 🦋

---

✨ Options ✨

• --help — produces the full help text. the classic "wait what does this do again" button. 🙈
• -p — performs the operation against all hosts in parallel. multitasking queen behavior. 👑
• -f hostfile — specifies the file with hosts in cluster. default is /etc/eth-tools/hosts. 🍓
• -h hosts — specifies the list of hosts in cluster. just say the names out loud, bestie. 🌸
• -L — includes localhost (the current node) in setup. yes, this node. include yourself, main character. 💅
• -a admin — specifies the list of admin hosts that can issue SNMP query. default is the current host. 🌈
• -c community — specifies the community string used for SNMP query. default is public. 🎀
• -m mibs — specifies the list of MIBs that are readable in SNMP queries. default is all MIBs required by FastFabric. ⭐

---

🦋 Examples 🦋

ethsetupssh -h 'elrond arwen' -a 'elrond'

HOSTS='elrond arwen' ethsetupsnmp -a 'elrond'

ethsetupsnmp -a 'elrond' -c 'public' -m '1.3.6.1.2.1.1 1.3.6.1.2.1.2'

(it's giving "copy these and vibe", honestly.) 💖

---

🌈 Environment Variables 🌈

the following environment variables are also used by this command:

• HOSTS — list of hosts, used if -h option not supplied. 🫶
• HOSTS_FILE — file containing list of hosts, used in absence of -f and -h. 🍓
• FF_MAX_PARALLEL — when -p option is used, maximum concurrent operations. the "how many at once tho" dial. 🔥

---

💜 Description 💜

ethreport collects fabric data through issuing SNMP queries to hosts and switches. Intel recommends that you set up SNMP using ethsetupsnmp to ensure:

• ethreport has proper permission to query each host 🎀
• each host can provide desired data ✨
• all hosts have consistent SNMP configuration 👑

ethsetupsnmp accepts the following parameters to configure SNMP. these parameters can be specified as command line arguments or collected during user interaction. ethsetupsnmp works under user-interaction mode when one or more of the required parameters are not specified in command line. (aka: it will literally start asking you questions. be ready. 😭)

• admin: space separated management node names. ethsetupsnmp will configure each host to allow SNMP query from these nodes. 🌸
• community: the community string for SNMP v2 query. the default is public. if set to a different string, ensure update hpnmgmt_config.xml with the string. (yes bestie, that means go update the file, don't skip it. 🫶)
• mibs: the MIBs allow SNMP query. FastFabric requires the following MIBs. you can provide extra MIBs if they are required by other applications.
  1. 1.3.6.1.2.1.1 (SNMPv2-MIB:system)
  2. 1.3.6.1.2.1.2 (IF-MIB:interfaces)
  3. 1.3.6.1.2.1.4 (IP-MIB:ip)
  4. 1.3.6.1.2.1.10.7 (EtherLike-MIB:dot3)
  5. 1.3.6.1.2.1.31.1 (IP-MIB:ifMIBObjects)

when working under interactive mode, follow the prompts to complete the operation. it's giving conversational. 🎀

Configuring SNMP...

Enter space separated list of admin hosts (mindy1):

Enter SNMP community string (public):

Fast Fabric requires the following MIBs:

    1.3.6.1.2.1.1 (SNMPv2-MIB:system)

    1.3.6.1.2.1.2 (IF-MIB:interfaces)

    1.3.6.1.2.1.4 (IP-MIB:ip)

    1.3.6.1.2.1.10.7 (EtherLike-MIB:dot3)

    1.3.6.1.2.1.31.1 (IP-MIB:ifMIBObjects)

Do you accept these MIBs [y/n] (y):

Enter space separated list of extra MIBs to support (NONE):

Will config SNMP with the following settings:

admin hosts: mindy1

community: public

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

1.3.6.1.2.1.31.1

Do you accept these settings [y/n] (y):

and then it does the thing across the nodes, like so:

scp -q /usr/sbin/ethsetupsnmp root@[mindy1]:/tmp/ethsetupsnmp

scp -q /usr/sbin/ethsetupsnmp root@[mindy2]:/tmp/ethsetupsnmp

[root@phwfstl005]# /tmp/ethsetupsnmp -l -a 'mindy1' -c 'public' -m

'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
1.3.6.1.2.1.31.1

';rm -f /tmp/ethsetupsnmp

Configuring SNMP...

SNMP configuration completed

[root@phwfstl006]# /tmp/ethsetupsnmp -l -a 'mindy1' -c 'public' -m

'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
1.3.6.1.2.1.31.1

';rm -f /tmp/ethsetupsnmp

Configuring SNMP...

SNMP configuration completed

SNMP configuration completed

💀 heads up bestie: that rm -f /tmp/ethsetupsnmp at the end of the line is doing exactly what it says — the copied binary gets cleaned up off the node when it's done. no leftovers, no clutter, iconic hygiene fr fr. 🧹✨

---

Copyright(C) 2020-2024 Intel Corporation ethsetupsnmp(8)

and that's the whole page, bestie — Copyright(C) 2020-2024, Intel Corporation, from the EFSFFCLIRG man page, ethsetupsnmp(8). go set up that SNMP, you absolute legend. 💖🎀🦋👑