opahostsmanalysis (8) - Linux Manuals

Command to display opahostsmanalysis manual in Linux: $ man 8 opahostsmanalysis

NAME

opahostsmanalysis

(All) Performs analysis against the local server only. It is assumed that both the host SM and the FastFabric are installed on the same system.

The host SM analysis tool checks the following:

•: Host SM software version
•: Host SM configuration file (simple text compare using FF_DIFF_CMD)
•: Host SM health (for example, is it running?)

Syntax

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

Options

--help: Produces full help text.
-b: Baseline mode. Default is the compare/check mode.
-e: Evaluates health only. Default is the compare/check mode.
-s: Saves history of failures (errors/differences).
-d dir: Top-level directory for saving baseline and history of failed checks. Default = /var/lib/opa-ff/analysis

Example

opahostsmanalysis

Environment Variables

The following environment variables are also used by this command:

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: Linux* command to use to compare baseline to latest snapshot.

Details

All files generated by opahostsmanalysis start with hostsm in the file name.

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:

Health Check

•: latest/hostsm.smstatus #8217#8211; Output of the sm_query smShowStatus command.

Baseline

•: baseline/hostsm.smver #8217#8211; Host SM version.
•: baseline/hostsm.smconfig #8217#8211; Copy of opafm.config.

During a baseline run, the files are also created in FF_ANALYSIS_DIR/latest.

Full Analysis

•: latest/hostsm.smstatus #8217#8211; Output of the sm_query smShowStatus command.
•: latest/hostsm.smver #8217#8211; Host SM version. latest/hostsm.smver.diff - diff of the baseline and latest host SM version.
•: latest/hostsm.smconfig #8217#8211; Copy of opafm.xml.
•: latest/hostsm.smconfig.diff #8217#8211; diff of the baseline and the latest opafm.xml.

The .diff files are only created if differences are detected.

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.

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.