opaallanalysis(8)

✨ NAME ✨

okay bestie, meet opaallanalysis 💅 it's from the IFSFFCLIRG manual, section 8, and it's the "(All)" girlie of the crew.

So like, the opaallanalysis command runs the whole set of analysis you told it to in FF_ALL_ANALYSIS, and you can point it at fabric, chassis, esm, or hostsm. it does the most, fr fr 👑

🌸 Syntax 🌸

opaallanalysis [-b|-e] [-s] [-d  dir] [-c  file] [-t  portsfile]
[-p  ports] [-F chassisfile] [-H 'chassis'] [-G  esmchassisfile]
[-E  esmchassis] [-T  topology_input]

🎀 Options 🎀

• --help — gives you the full help text, no cap. every last word of it.
• -b — flips it into baseline mode. the default is compare/check mode, jsyk.
• -e — evaluates health only. again, default is compare/check mode. pick a lane bestie.
• -s — saves the history of failures (that's errors and differences, both of 'em) 💾
• -d dir — tells it where the top-level directory for saving baselines and the history of failed checks lives. default is /var/usr/lib/opa/analysis
• -c file — names the error thresholds configuration file. default is /etc/opa/opamon.conf
• -t portsfile — names the file with the list of local HFI ports it uses to access the fabric(s) for analysis. default is /etc/opa/ports
• -p ports — gives it the list of local HFI ports for accessing the fabric(s) for analysis. default is the first active port. you write it as HFI:port, like this:
  • 0:0 — first active port in the system ✨
  • 0:y — port y within the system
  • x:0 — first active port on HFI x
  • x:y — HFI x, port y
• -F chassisfile — names the file with a chassis in a cluster. default is /etc/opa/chassis
• -H 'chassis' — gives the list of chassis to run the command on 🫶
• -G esmchassisfile — names the file with embedded SM chassis in the cluster. default is /etc/opa/esm_chassis
• -E esmchassis — gives the list of embedded SM chassis to analyze.
• -T topology_input — names the topology input file to use. any %P markers in that filename get swapped out for the HFI:port being operated on, like 0:0 or 1:2. default is /etc/opa/topology.%P.xml. and if you specify -T NONE, no topology input file is used at all. peep opareport for more info 👀

🌈 Example 🌈

opaallanalysis

opaallanalysis -p '1:1 2:1'

💜 Environment Variables 💜

these env vars are also used by this command, so like, they're in the group chat too:

• PORTS — list of ports, used when -t and -p aren't around.
• PORTS_FILE — file containing the list of ports, used when -t and -p aren't around.
• FF_TOPOLOGY_FILE — file containing topology_input (it may have a %P marker in the filename), used when -T isn't around.
• CHASSIS — list of chassis, used if the -F and -H options aren't supplied.
• CHASSIS_FILE — file containing the list of chassis, used if the -F and -H options aren't supplied.
• ESM_CHASSIS — list of SM chassis, used if the -G and -E options aren't supplied.
• ESM_CHASSIS_FILE — file containing the list of SM chassis, used if the -G and -E options aren't supplied.
• FF_ANALYSIS_DIR — top level directory for baselines and failed health checks.
• FF_CHASSIS_CMDS — list of commands to issue during analysis. unused if the -e option is supplied.
• FF_CHASSIS_HEALTH — single command to issue to check overall health during analysis. unused if the -b option is supplied.

🦋 Details 🦋

so the opaallanalysis command performs the set of analysis specified in FF_ALL_ANALYSIS, which has to be a space-separated list, periodt. you can hand that over via the environment or by using /etc/opa/opafastfabric.conf. the analysis set includes the options: fabric, chassis, esm, or hostsm. and if you've got a fabric with only externally managed switches, FF_ALL_ANALYSIS should be set to -fabric in opafastfabric.conf. noted 📝

also, fun fact: opaallanalysis has options that are a super-set of the options for all the other analysis commands. those options get passed along to the respective tools as needed. like, the -c file option gets passed on to opafabricanalysis if it's specified in FF_ALL_ANALYSIS. it's giving group project where everyone actually does their part 💅

the output files are all the output files for whichever set of analysis FF_ALL_ANALYSIS selected. go check the previous sections for the specific output files.

Copyright(C) 2015-2019 Intel Corporation — that's the whole thing bestie, opaallanalysis(8), IFSFFCLIRG manual, mwah 💖 go slay ✨🎀