opahostsmanalysis(8)

🌸 NAME 🌸

opahostsmanalysis — ok bestie, this one is (All) and it does its analysis against the local server only. The whole vibe assumes both the host SM and the FastFabric are installed on the same system, no long-distance relationship energy here 💅

So what does the host SM analysis tool actually check? Sit down, take notes 📝:

• Host SM software version
• Host SM configuration file (a simple text compare using FF_DIFF_CMD)
• Host SM health (like… is it even running, bestie? 😭)

✨ Syntax ✨

opahostsmanalysis [-b|-e] [-s] [-d  dir]

🎀 Options 🎀

• --help — produces the full help text, every word of it, iconic behavior honestly 👑
• -b — baseline mode, activated. The default is compare/check mode, so you're switching it up.
• -e — evaluates health only, that's it, that's the whole job. Again, default is compare/check mode.
• -s — saves the history of failures (errors/differences), because we keep receipts 🧾
• -d dir — specifies the top-level directory for saving baseline and history of failed checks. Default is /var/usr/lib/opa/analysis.

🦋 Example 🦋

opahostsmanalysis

Literally just run it, no cap. ✨

💜 Environment Variables 💜

These environment variables are also used by this command, so keep them in your notes app:

• FF_ANALYSIS_DIR — top-level directory for baselines and failed health checks.
• FF_CURTIME — timestamp to use on the directory created in FF_DIFF_CMD.
• FF_DIFF_CMD — the Linux* command to use to compare baseline to latest snapshot.

🌈 Details 🌈

Every single file generated by opahostsmanalysis starts with hostsm in the file name. Branding, honestly.

The opahostsmanalysis tool generates files such as the following within FF_ANALYSIS_DIR. The actual file names reflect the individual chassis commands that have been configured using the FF_CHASSIS_HEALTH and FF_CHASSIS_CMDS parameters — so don't be surprised when they look different, that's by design 🫶

🩺 Health Check

• latest/hostsm.smstatus — output of the sm_query smShowStatus command.

📸 Baseline

• baseline/hostsm.smver — host SM version.
• baseline/hostsm.smconfig — copy of opafm.xml.

During a baseline run, the files are also created in FF_ANALYSIS_DIR/latest. Yes, both places. She contains multitudes 💅

🔍 Full Analysis

• latest/hostsm.smstatus — output of the sm_query smShowStatus command.
• latest/hostsm.smver — host SM version. latest/hostsm.smver.diff — diff of the baseline and latest host SM version.
• latest/hostsm.smconfig — copy of opafm.xml.
• latest/hostsm.smconfig.diff — diff of the baseline and the latest opafm.xml.

The .diff files are only created if differences are detected. No difference, no diff file, periodt.

If the -s option is used and failures are detected, files related to the checks that failed are also copied to a time-stamped directory name under FF_ANALYSIS_DIR. Time-stamped, so you can always find the exact moment things went sideways 😭

👑 Host SM Items Checked Against the Baseline 👑

• SM configuration file.
• Version of the SM rpm installed on the system.

⭐ Host SM Items Also Checked During Health Check ⭐

• The SM is in the running state.

And that's the whole page, bestie 💖 this little manual came to you from the IFSFFCLIRG (Man Page) world, copyright Copyright(C) 2015-2019 Intel Corporation, and yes we're signing off on opahostsmanalysis(8) — go run it and slay 🎀✨🦋