ethallanalysis(8)

🌸 ethallanalysis(8) — the EFSFFCLIRG glow-up 💅

okay bestie, sit down, hydrate, and let me tell you about ethallanalysis, a lil command from the EFSFFCLIRG manual set that runs a whole bundle of analysis for you. It does the set of analysis specified in FF_ALL_ANALYSIS, and you can point it at a fabric or at hosts. It's giving "I do everything so you don't have to." ✨

✨ Syntax ✨

ethallanalysis [-b|-e] [-s] [-d  dir] [-c  file] [-T  topology_input]
[-E  file] [-p  planes] [-f  host_files]

🎀 Options 🎀

• --help — prints the full help text. the whole thing. every word. iconic behavior fr.
• -b — sets baseline mode. the default is compare/check mode, so this is you flipping the switch into "record the baseline" era. 📸
• -e — evaluates health only. default is still compare/check mode, so no sneaky comparison, just vibes-checking the health.
• -s — saves the history of failures (errors/differences). memory? slay. 💾
• -d dir — names the top-level directory where baselines and the history of failed checks get saved. default is /var/usr/lib/eth-tools/analysis.
• -c file — the error thresholds configuration file. default is /etc/eth-tools/ethmon.conf.
• -E file — the Ethernet Mgt configuration file. default is /etc/eth-tools/mgt_config.xml.
• -p planes — fabric planes, separated by a space. default is the first enabled plane defined in the config file. if you pass the value ALL, it uses all enabled planes. go big or go home, no cap.
• -f host_files — hosts files, separated by a space. this overrides the HostsFiles defined in the Mgt config file for the corresponding planes. the value DEFAULT makes it use the HostFile defined in the Mgt config file for the corresponding plane.
• -T topology_inputs — the names of topology input filenames, separated by a space. peek at ethreport for more info on topology_input files. 🔍

💖 Example 💖

ethallanalysis

ethallanalysis -p 'p1 p2' -f 'hosts1 DEFAULT'

🦋 Environment Variables 🦋

These env vars are also used by this command:

• FF_ANALYSIS_DIR — the top-level directory for baselines and failed health checks.

👑 Details 👑

So here's the tea, bestie. The ethallanalysis command performs the set of analysis specified in FF_ALL_ANALYSIS, which must be a space-separated list. You can hand that over via the environment, or via /etc/eth-tools/ethfastfabric.conf. And the analysis set includes the options: fabric. 📋

lowkey important: ethallanalysis has options that are a superset of the options for all other analysis commands. The options get passed along to the respective tools as needed. For example, the -c file option is passed on to ethfabricanalysis if it's specified in FF_ALL_ANALYSIS. it's literally just handing out options like friendship bracelets. 🫶

The output files are all the output files for the FF_ALL_ANALYSIS selected set of analysis. See the previous sections for the specific output files. 💅

okay that's the whole page, you ate it, go run it bestie 🌈

this lil writeup is copyright Copyright(C) 2020-2024 Intel Corporation, and yes, ethallanalysis(8) is the manual page it lives on. mwah 💜