To facilitate communication between users and developers, we are introducing a new switch:

--mammamia

The idea behind this switch: advanced users that want to test a script or a function which appears not to be working properly usually switch to the command line. Should they require the assistance of the developer, they previously had to include the output of the script in an email. In most cases, this was not enough and resulted in more requests from the developer such as: creating and sending rawdump, creating and sending verbose output – annoying! This just became much easier thanks to --mammamia.

All you have to do is include the --mammamia switch when launching a collector plugin from the command line. As a result, the plugin creates a directory with all relevant information. It can then be inspected with a text editor before compressing it to a tar or zip and sending it to the developer by email.

 

The following example depicts the use of the --mammamia switch:

$ ./get_netapp_perfdata.pl -H sim812 -o volume --mammamia
MAMMMIA-info sucessfully written into 
'.../check_netapp_pro/store/..._sim812_volume_2014-06-02T06:35:15.mammamia'.
Further instructions are in this directorys _README.txt

$ cd check_netapp_pro/store/..._sim812_volume_2014-06-02T06\:35\:15.mammamia/

$ ls -l
-rw-r--r-- 1 il staff 596 2 Jun 08:35 01-opts.txt
-rw-r--r-- 1 il staff 7852 2 Jun 08:35 02-output.txt
-rw-r--r-- 1 il staff 885 2 Jun 08:35 _README.txt
-rw-r--r-- 1 il staff 33629 2 Jun 08:35 raw_dump.raw
-rw-r--r-- 1 il staff 151328 2 Jun 08:35 ref_dump.txt

$ cat _README.txt 
 This directory contains:

 * opts: stdin (program arguments) 
 * output: stdout (program output) & stderr (debug messages)
 * raw_dump, ref_dump: Data got from filer in a human-readable txt- and a
 binary raw-format. The latter can be deleted if your organizations
 security policy requires to visually scan the data. It's content is the
 same as that of the txt-file.

 The data in this directory is pure configuration and/or performance data.
 But please keep in mind, that if you set the password directly on the
 command line the password itself will be in the opts-file in cleartext. You
 can either delete it manually there or even better avoid this problem by
 using the --authfile switch.

 Please compress and tar this directory before you send it to
 mammamia@rfi.net in order to get help or if you are going
 to request an additional feature for a specific command.