1opachassisanalysis(8) Master map: IFSFFCLIRG (Man Page) opachassisanalysis(8)
3
7 opachassisanalysis
8 (Switch) Performs analysis of the chassis.
12 The opachassisanalysis tool checks the following for the Intel(R) Omni-
14 Path Fabric Chassis:
15 · Chassis configuration (as reported by the chassis commands spec‐
17 ified in FF_CHASSIS_CMDS in opafastfabric.conf).
18 · Chassis health (as reported by the chassis command specified in
20 FF_CHASSIS_HEALTH in opafastfabric.conf).
21
23 opachassisanalysis [-b|-e] [-s] [-d dir] [-F chassisfile]
24 [-H 'chassis']
25
27 --help Produces full help text.
28 -b Specifies the baseline mode. Default is the compare/check
30 mode.
31 -e Evaluates health only. Default is the compare/check mode.
33 -s Saves history of failures (errors/differences).
35 -d dir Specifies the top-level directory for saving baseline and
37 history of failed checks. Default = /var/usr/lib/opa/analysis
38 -F chassisfile
40 Specifies the file with the chassis in the cluster. Default =
41 /etc/opa/chassis
42 -H 'chassis'
44 Specifies the list of chassis on which to execute the com‐
45 mand.
46
48 opachassisanalysis
49
51 The following environment variables are also used by this command:
52 CHASSIS List of chassis, used if -F and -H options are not supplied.
54 CHASSIS_FILE
56 File containing list of chassis, used if -F and -H options
57 are not supplied.
58 FF_ANALYSIS_DIR
60 Top-level directory for baselines and failed health checks.
61 FF_CHASSIS_CMDS
63 List of commands to issue during analysis, unused if -e
64 option supplied.
65 FF_CHASSIS_HEALTH
68 Single command to issue to check overall health during analy‐
69 sis, unused if -b option supplied.
70
73 Intel recommends that you set up SSH keys for chassis (see opasetupssh
74 ). If SSH keys are not set up, all chassis must be configured with the
75 same admin password and the password must be kept in the
76 /etc/opa/opafastfabric.conf configuration file.
77 The default set of FF_CHASSIS_CMDS is:showInventory fwVersion showNod‐
79 eDesc timeZoneConf timeDSTConf
80 snmpCommunityConf snmpTargetAddr showChassisIpAddr showDefaultRoute
81 The commands specified in FF_CHASSIS_CMDS must be simple commands with
83 no arguments. The output of these commands are compared to the baseline
84 using FF_DIFF_CMD. Therefore, commands that include dynamically chang‐
85 ing values, such as port packet counters, should not be included in
86 this list.
87 FF_CHASSIS_HEALTH can specify one command (with arguments) to be used
89 to check the chassis health. For chassis with newer firmware, the
90 hwCheck command is recommended. For chassis with older firmware, a
91 benign command, such as fruInfo, should be used. The default is
92 hwCheck. Note that only the exit status of the FF_CHASSIS_HEALTH com‐
93 mand is checked. The output is not captured and compared in a snapshot.
94 However, on failure its output is saved to aid diagnosis.
95 The opachassisanalysis tool performs its analysis against one or more
97 chassis in the fabric. As such, it permits the chassis to be specified
98 using the -H, -F, CHASSIS, chassis_file or opafastfabric.conf. The han‐
99 dling of these options and settings is comparable to opacmdall -C and
100 similar FastFabric Toolset commands against a chassis.
101 All files generated by opafabricanalysis start with chassis. in the
103 file name.
104 The opachassisanalysis tool generates files such as the following
106 within FF_ANALYSIS_DIR. The actual file names reflect the individual
107 chassis commands that have been configured through the FF_CHAS‐
108 SIS_HEALTH and FF_CHASSIS_CMDS parameters:
109 Health Check
111 · latest/chassis.hwCheck Output of hwCheck command for all
114 selected chassis
115 Baseline: During a baseline run, the following files are also created
118 in FF_ANALYSIS_DIR /latest.
119 · baseline/chassis.fwVersion Output of fwVersion command for all
121 selected chassis.
122 · baseline/chassis.showChassisIpAddr Output of the showChassisI‐
125 pAddr. command for all selected chassis.
126 · baseline/chassis.showDefaultRoute Output of the showDefaultRoute
129 command for all selected chassis.
130 · baseline/chassis.showNodeDesc Output of the showNodeDesc command
133 for all selected chassis.
134 · baseline/chassis.showInventory Output of the showInventory com‐
137 mand for all selected chassis.
138 · baseline/chassis.snmpCommunityConf Output of the snmpCommunity‐
141 Conf command for all selected chassis.
142 · baseline/chassis.snmpTargetAddr Output of the snmpTargetAddr
145 command for all selected chassis.
146 · baseline/chassis.timeDSTConf Output of the timeDSTConf command
149 for all selected chassis.
150 · baseline/chassis.timeZoneConf Output of the timeZoneConf command
153 for all selected chassis.
154 Full Analysis: The following .diff files are only created if differ‐
157 ences are detected.
158 · latest/chassis.hwCheck Output of the hwCheck command for all
160 selected chassis.
161 · latest/chassis.fwVersion Output of the fwVersion command for all
164 selected chassis.
165 · latest/chassis.fwVersion.diff diff of the baseline and latest
168 fwVersion.
169 · latest/chassis.showChassisIpAddr Output of the showChassisIpAddr
172 command for all selected chassis.
173 · latest/chassis.showChassisIpAddr.diff diff of baseline and lat‐
176 est showChassisIpAddr.
177 · latest/chassis.showDefaultRoute Output of the showDefaultRoute
180 command for all selected chassis.
181 · latest/chassis.showDefaultRoute.diff diff of the baseline and
184 the latest showDefaultRoute.
185 · latest/chassis.showNodeDesc Output of the showNodeDesc command
188 for all selected chassis.
189 · latest/chassis.showNodeDesc.diff diff of the baseline and latest
192 showNodeDesc.
193 · latest/chassis.showInventory Output of the showInventory command
196 for all selected chassis.
197 · latest/chassis.showInventory.diff diff of the baseline and lat‐
200 est showInventory.
201 · latest/chassis.snmpCommunityConf Output of the snmpCommunityConf
204 command for all selected chassis.
205 · latest/chassis.snmpCommunityConf.diff diff of the baseline and
208 latest snmpCommunityConf.
209 · latest/chassis.snmpTargetAddr Output of the snmpTargetAddr com‐
212 mand for all selected chassis.
213 · latest/chassis.snmpTargetAddr.diff diff of the baseline and lat‐
216 est snmpTargetAddr.
217 · latest/chassis.timeDSTConf Output of the timeDSTConf command for
220 all selected chassis.
221 · latest/chassis.timeDSTConf.diff diff of the baseline and latest
224 timeDSTConf.
225 · latest/chassis.timeZoneConf Output of the timeZoneConf command
228 for all selected chassis.
229 · latest/chassis.timeZoneConf.diff diff of the baseline and latest
232 timeZonfConf.
233 If the -s option is used and failures are detected, files related to
236 the checks that failed are also copied to a time-stamped directory name
237 under FF_ANALYSIS_DIR.
238
240 Based upon showInventory :
241 · Addition/removal of Chassis FRUsReplacement is only checked for
243 FRUs that showInventory displays the serial number.
244 · Removal of redundant FRUs (spines, power supply, fan)
247 Based upon fwVersion:
249 · Changes to primary or alternate FW versions installed in cards
251 in chassis.
252 Based upon showNodeDesc:
254 · Changes to configured node description for chassis. Note changes
256 detected here would also be detected in fabric level analysis.
257 Based upon timeZoneConf and timeDSTConf:
259 · Changes to the chassis time zone and daylight savings time con‐
261 figuration.
262 Based upon snmpCommunityConf and snmpTargetAddr:
264 · Changes to SNMP persistent configuration within the chassis.
266 The following Chassis items are not checked against baseline:
268 · Changes to the chassis configuration on the management LAN (for
270 example, showChassisIpAddr, showDefaultRoute). Such changes typ‐
271 ically result in the chassis not responding on the LAN at the
272 expected address that is detected by failures that perform other
273 chassis checks.
274
276 Based upon hwCheck:
277 · Overall health of FRUs in chassis:
279 · Status of Fans in chassis
281 · Status of Power Supplies in chassis
283 · Temp/Voltage for each card
285 · Presence of adequate power/cooling of FRUs
287 · Presence of N+1 power/cooling of FRUs
289 · Presence of Redundant AC input
291Copyright(C) 2015-2018 Intel Corporation opachassisanalysis(8)