---
name: "opahostsmanalysis"
section: "8"
platform: "linux"
package: "opa-fastfabric"
version: "10.10.3.0.11-1+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/opahostsmanalysis"
---

# opahostsmanalysis(8)

## 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

  Specifies the 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*

  Specifies the top-level directory for saving baseline and history of failed checks. Default is /var/usr/lib/opa/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 - 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.

**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.

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.
