check_iprinters.pl

                                        
icinga2 plugin for checking Novell iPrinter status.

                    

        
        

            
            

                

    

    
check_ipp.pl


File: check_iprinters.pl


Author: dbenjamin


Created: Aug 4, 2015


Release: 0.0.3


Tested against Novell iPrint Server 6.7.0.20150629-0.6.6, running on SLES 11, SP3 with OES 11, SP2.




Usage: check_iprinters.pl -I  -Q  [-P  default=631] [-F  [-v enable verbose] [--version]


Required


    

  • -I  Host IP address.
    • 

  • -Q  Queue name. This can be found by browsing to your iPrint server at http://:/ipp/ each printer queue name should be listed.
    • 



Options


    

  • -P  Port to use for testing, the default is 631.
    • 

  • -F  Filter in regular expression format.  Any regular expression that matches will lower an Error to a Warning status.  This keeps emails from going out in our system when local staff can add paper.  We currently filter for printers in an Error state and shutdown or empty:  "(empty)|(shut down)"  This filter is NOT case sensitive.
    • 

  • -v  Enable verbose output for testing, do not use this in your monitoring software.
    • 

  • --version   Output some version information, do not use this in your monitoring software.
    • 



Integration


You can integrate with Icinga2 following these instructions.


    

  1. Download the check_ipp.pl script.
    2. 

  2. Find the CustomPluginDir path in /etc/icinga2/constants.conf or where your distro may have placed the config file.
    3. 

  3. Place the check_ipp.pl script in the CustomPluginDir directory and make the file executable.
    4. 

  4. 

    Define the service.
    

      

    • 

      I created a file in /etc/icinga2.conf/ named iprinters.conf containing:
      

      object CheckCommand "iprinters" {
import "plugin-check-command"

command = [ CustomPluginDir + "/check_iprinters.pl" ]

arguments = {
 "-I" = "$address$"
 "-Q" = "$iprint_queue$"
 "-F" = "(empty)|(shut down)"
}
}
apply Service for (iPrint => config in host.vars.iprinters) {
import "generic-service"

check_command = "iprinters"

vars += config
}
      

      • 

    

    5. 

  5. Define iPrint queue attributes in your host definitions.

      

    • Mine looks like this, yes the queue name is "7UP":

      /* Define iPrint queue attributes for service apply rules. */
vars.iprinters["iprint 7UP"] = {
 iprint_queue = "7UP"
}
      • 

    6.