Documentation
DiskPaths-Check
Checks if the disk paths follow a given pattern (A/B, B/A, AABB, ABAB, ...).
Usage
$ check_netapp_pro.pl DiskPaths -H <host> -w <n> -c <n> [...] [--help]
Description
This plugin checks each disk for redundant paths. Alarms if a disk does not have a connection pattern as defined by --port_pattern_ok. Also checks if the primary and secondary host-adapters are different.
WARNING: The delivered config-sets are examples only, have not been cross-checked and are likely to result in false-negatives!
Supported Filers
This check can be only used to check the DiskPaths if all the following conditions are met:
The filers OS is not OnTap Select (these virtual filers do not have disk-paths)
The filers OS fully supports the ZAPI (RESTful filers will get its own check for disk-paths). As of writing this is true for ONTAP 9.6 or lower version.
The data is collected from the ZAPI interface of the filer. Consider to implement a second getter service-check with the
--api
option set to 'zapi' to have the required store file (with the.store
-extension) in place. Store-files with the.storest
extension are ignored by the DiskPaths check.
CLI Equivalents
On the command-line you would type storage show disk -p
and check,
if column PRIMARY PORT and SECONDARY PORT both have a value of A or B.
7-Mode:
sim812> storage show disk -p
PRIMARY PORT SECONDARY PORT SHELF BAY
------- ---- --------- ---- ---------
v4.16 B v0.16 A ? ?
v4.17 B v0.17 A ? ?
v4.18 B v0.18 A ? ?
(...)
v5.27 B v1.27 A ? ?
v5.28 B v1.28 A ? ?
v5.29 B v1.29 A ? ?
v5.32 B v1.32 A ? ?
Cluster-Mode:
cluster1::> storage disk show -port
Primary Port Secondary Port Type Shelf Bay
--------------- ---- --------------- ---- ------ ----- ---
cluster1-01:v4.16
B cluster1-01:v0.16
A FCAL - -
cluster1-01:v4.17
B cluster1-01:v0.17
A FCAL - -
cluster1-01:v4.18
B cluster1-01:v0.18
A FCAL - -
(...)
cluster1-02:v5.32
B cluster1-02:v1.32
A FCAL - -
56 entries were displayed.
Consider using -v
for inspection, if you are not satisfied with the result.
Handling of Unassigned Disks
If disks are unassigned (e.g. if they are not assigned to an owner after having
destroyed an aggregate) they are silently skipped. You can use the verbose mode
(--verbose|-v
) to list these disks.
Please keep in mind that it is a best practice to not leave disks unassigned.
So we highy recommend to have a check based on the Disk-check
(--what=unassigend
) configured too.
Configuration Sets
The check can either be configured on the commandline or by pointing --config
to a
file with a predefined set of commandline arguments (e.g. --config=JobSnapMirror.set
).
We deliver several of such sets for different purposes like the monitoring of SnapMirror Jobs. These files can be used as they are but also as template for your own predefined sets.
Where to store set-files
Set-files with no leading slash are expected to be in ./config
wheras a file-name
prefixed with a slash is considered to be an absolut path (e.g.
/usr/local/nagios/config/my.set
).
We recommend to save your own set-files outside of the check_netapp_pro/scripts
directory, so that your set-files survive the next update.
Mixing the config-set and commandline-arguments
Commandline arguments can be used together with a config-set file and will in case of a conflict overrule the arguments in the set-file. Keep in mind, that command-line arguments which can be repeated won't conflict with a second argument of the same name and therefore will be amended and not overruled.
Se also
- path-quality: The percentage of the error threshold. This has been implemented as DiskPathQuality check.
Possible Enhancements
The following metrics may be of interest for future enhancements of the cluster-mode check:
path-io-kbps: Rolling average of kilobytes per second read and written to this path.
path-link-errors: Number of link errors reported on the path.
Please contact developer@netapp-monitoring.info to request these enhancements.
Simple Examples
Checks all disks on filer. Returns OK if each disk is connected via two different ports.
Advanced Examples
Hint: The input for advanced examples is shortend. Replace the '...' below with ‑H <your filers ip or host-name>
Check only disks whose name start with v5.1
.
Test only the disks 4.x with a specific pattern for the ports.
Test all remaining disks with standard-pattern (AABB, ABAB, etc).
Checks if all disks are reachable over two different pathes.