Create the directory
/usr/local/monitoring-plugins.pro/netapp-rest/etc (if it does not already exist) and untar the downloaded archive to its parent.
mkdir -p /usr/local/monitoring-plugins.pro/netapp-rest/etc tar -xzf check-netapp-rest-1.0.0.tar.gz --directory /usr/local/monitoring-plugins.pro/netapp-rest/
The above mkdir command creates the main plugin directory plus the later required
etc/ sub-directory in one call.
The above tar command is the short form of:
cp check-netapp-rest-1.0.0.tar.gz /usr/local/monitoring-plugins.pro/netapp-rest cd /usr/local/monitoring-plugins.pro/netapp-rest tar -xzf check-netapp-rest-1.0.0.tar.gz rm check-netapp-rest-1.0.0.tar.gz cd -
Copy the license file to its default directory
cp CNR-00000-00000_check_netapp_pro.dat /usr/local/monitoring-plugins.pro/netapp-rest/etc
The example-configuration directory contains a
license.cfg that will monitor the above directory for expiring licenses. More information about the license file and how to check for expiration can be found in the chapter License File.
Create a storedir
mkdir -p /usr/local/monitoring-plugins.pro/netapp-rest/var/store
The above typescript creates the storedir at its default location. If you prefer it somewhere else you can either symlink the default-storedir to a different location or use the
For customers who also use the Perl checks (Check NetApp-ZAPI): The checks from Check NetApp-REST have no explicit getter anymore but still use an auto-getter function to cache results locally. Therefore we still need a storedir.
Change the owner of the files to the monitoring-daemons user. (In the example below, change the username from nagios to e.g. icinga or whatever your daemon runs with.)
cd /usr/local/monitoring-plugins.pro chown -R nagios netapp-rest/
Copy and adapt the example configuration. At least the
hosts.cfg will need your attention (you need to supply the host-names which it should monitor)
cd /usr/local/monitoring-plugins.pro/netapp-rest/etc/ cp ../etc.example/* . vi hosts.cfg ...
Let the monitoring system know about the location of the configuration files. E.g. on Nagios or Icinga add the following line to the main configuration file (
Create a monitoring user on your NetApp-system (or use the existing read-only role). Write the credentials of this user into the default authfile (
/usr/local/monitoring-plugins.pro/netapp-rest/etc/netapp_credentials). A detailed description and typescript is in Filer Configuration
After these few steps you can reload the monitoring-servers configuration and should see some results.
The syntax of Check NetApp-REST is quite similar to the former
check_netapp_pro.pl (now part of Check NetApp-ZAPI) with these exceptions:
--authfile|-f expects the new ini-format. The older text-format is not supported any more. The minimum authfile is now:
[default] user = monitoring_user_name pass = monitoring_user_password
--port has been removed.
All underscores in the parameters have been replaced by dashes (e.g.
--max_age is now written
Of course you can use the eventually already existing authfile from Check NetApp-ZAPI for Check NetApp-REST as well (if it is in the ini-format). Just symlink it into the above mentioned default-location or explicitly name it with the
--authfile parameter. You can then administrate all NetApp hosts in one file for both of our monitoring products.