bigbrozer / license_manager_plugins

Plugins to use with Nagios to check major industry license managers.

License Manager Plugins

About

Collection of plugins to check the status of industry major license managers. Currently supporting:

LM-X License Manager (X-Formation):

• check_lmx_status : check status and license usage and license expiration.

FlexLM (Flexera Software):

• check_flexlm_status : check status and license usage.
• check_flexlm_feature_expiration : check if a feature is expired or about to expire.

LSTC (LS-Dyna):

• check_lstc_status : check status and number of connected users (running jobs).

LUM (IBM License Use Management):

• check_lum_status : check status of LUM license server (available or not).
• check_lum_license_expiration : check if a product is expired or about to expire for LUM.

Installation

Requirements

Note:

You do not need to install all license utility, only the one you will use !

LM-X:

You need to get from the support page on X-Formation website the 'lmxendutil' utility. Copy it in your PATH or wherever you want. Then configure the plugin, see below.

FlexLM:

You need to install "lmutil" utility on your Nagios server in order to use the plugin: http://www.globes.com/support/fnp_utilities_download.htm

Once you downloaded the file, copy content in a directory.

LSTC:

• Need command "lstc_qrun".
• TODO: write LSTC requirements.

LUM:

• Need commands "i4tv" and "i4blt".
• TODO: write LUM requirements.

Get the plugin package

Note:

I recommend installing 'git' on your Nagios server in order to download and keep up to date this plugin. If you are behind a proxy, you can export http_proxy environment variable before.

Go inside your Nagios plugins directory (usually /usr/local/nagios/libexec), then type in:

git clone git://github.com/bigbrozer/license_manager_plugins.git

This will create a new folder "license_manager_plugins".

Configuration

Edit the file "config.py" and set *_PATH variables to the correct location for each license tools on your system. By default, commands are searched in PATH.

Note:

You do not need to configure all, only the one you will use !

Usage

Usage for each plugins:

Usage: check_flexlm_feature_expiration.py [options]

Options:
  -h, --help        show this help message and exit
  -l LICENSE        License file or remote host as <port>@<remote_host>
  -p PORT           License port (only for backend that does not support
                    remote host as <port>@<remote_host>)
  -d, --debug       Enable debug mode
  --no-long-output  Disable Nagios long output (compatibility with Nagios <
                    3.x)
--------------------------------------------------

Usage: check_flexlm_status.py [options]

Options:
  -h, --help        show this help message and exit
  -l LICENSE        License file or remote host as <port>@<remote_host>
  -p PORT           License port (only for backend that does not support
                    remote host as <port>@<remote_host>)
  -d, --debug       Enable debug mode
  --no-long-output  Disable Nagios long output (compatibility with Nagios <
                    3.x)
--------------------------------------------------

Usage: check_lmx_status.py [options]

Options:
  -h, --help        show this help message and exit
  -m MODE           Mode for the plugins, either "status" (default) or
                    "expire".
  -l LICENSE        License file or remote host as <port>@<remote_host>
  -p PORT           License port (only for backend that does not support
                    remote host as <port>@<remote_host>)
  -d, --debug       Enable debug mode
  --no-long-output  Disable Nagios long output (compatibility with Nagios <
                    3.x)
--------------------------------------------------

Usage: check_lstc_status.py [options]

Options:
  -h, --help        show this help message and exit
  -l LICENSE        License file or remote host as <port>@<remote_host>
  -p PORT           License port (only for backend that does not support
                    remote host as <port>@<remote_host>)
  -d, --debug       Enable debug mode
  --no-long-output  Disable Nagios long output (compatibility with Nagios <
                    3.x)
--------------------------------------------------

Usage: check_lum_license_expiration.pl [-v] [-h]

Options:
 -h, --help
   Print this help message.
 -v, --verbose
   Print debugging information, Nagios should truncate output.
 -l, --license
   Specify license INI file location for i4blt command (this will be used to set IFOR_CONFIG env variable).
--------------------------------------------------

Usage: check_lum_status.py [options]

Options:
  -h, --help        show this help message and exit
  -l LICENSE        License file or remote host as <port>@<remote_host>
  -p PORT           License port (only for backend that does not support
                    remote host as <port>@<remote_host>)
  -d, --debug       Enable debug mode
  --no-long-output  Disable Nagios long output (compatibility with Nagios <
                    3.x)
--------------------------------------------------

Specials for LUM plugins

If you will use plugin check_lum_license_expiration.pl, you must get the file i4rpt.fmt from your LUM installation and copy it /opt/lum. It also assumes that you have both commands "i4tv" and "i4blt" in your PATH.

This is a old script I did quickly in the past (written in Perl). It will do the job, but I will rewrite it using Python like the others.

Contact

• Author: Vincent 'v!nZ' Besançon
• Project home page: http://github.com/bigbrozer/license_manager_plugins
• Nagios Exchange: http://exchange.nagios.org/directory/Plugins/License-Management/Industry-License-Manager-Plugins/details
• Email: besancon [DOT] vincent [AT] gmail [DOT] com
• Support: http://github.com/bigbrozer/license_manager_plugins/issues

Support

Feel free to send me email if you need help or send me remarks, suggestions, etc... I recommend to use issue page on Github (see Support link above) if you think there is a problem with this plugin.

License

See LICENSE file inside plugin package.

Enjoy ;-)