SMS Notifications via LabsMobile

# ============================== SUMMARY =====================================
#
# Program : notify_sms.pl
# Version : 1.4
# Date : 08 Mar 2018
# Author : Boris Vogel / LabsMobile
# Copyright : LabsMobile All rights reserved.
# Summary : This plugin sends SMS alerts through the LabsMobile SMS API
# License : ISC
#
# =========================== PROGRAM LICENSE =================================
#
# Copyright (c) LabsMobile 2018
#
# Permission to use, copy, modify, and/or distribute this software for any
# purpose with or without fee is hereby granted, provided that the above
# copyright notice and this permission notice appear in all copies.
#
# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
#
# ============================= MORE INFO ======================================
#
# As released this plugin requires a LabsMobile account to send text
# messages. To setup a LabsMobile account visit:
# http://www.labsmobile.com
#
#
# ============================= SETUP NOTES ====================================
#
# Copy this file to your Nagios plugin folder
# On a Centos install this is typically /usr/lib/nagios/libexec (32 bit)
# or /usr/lib64/nagios/libexec (64 bit) other distributions may vary.
# Make sure you have SSL enabled. Run this otherwise:
# perl -MCPAN -e 'install Crypt::SSLeay'
# Testing. From the command line in the plugin folder run:
# ./notify-sms.pl -u yourusername -p yourpassword -t yournumber -f Nagios -m "bodge"
# replacing yourusername, yourpassword and yournumber with the appropriate values.
#
#
# NAGIOS SETUP
#
# 1. Create the SMS notification commands. (Commonly found in commands.cfg)
# Don't forget to add your LabsMobile username and password. These can be placed
# in your commands instead of the API_USERNAME and API_PASSWORD given below
# -f Nagios - you can change Nagios to a different "from" if you want.
#
# define command{
# command_name service-notify-by-sms
# command_line $USER1$/notify_sms.pl -u API_USERNAME -p API_PASSWORD -t $CONTACTPAGER$ -f Nagios -m "Service: $SERVICEDESC$nHost: $HOSTNAME$nAddress: $HOSTADDRESS$nState: $SERVICESTATE$nInfo: $SERVICEOUTPUT$nDate: $LONGDATETIME$"
# }
#
# define command{
# command_name host-notify-by-sms
# command_line $USER1$/notify_sms.pl -u API_USERNAME -p API_PASSWORD -t $CONTACTPAGER$ -f Nagios -m "Host $HOSTNAME$ is $HOSTSTATE$nInfo: $HOSTOUTPUT$nTime: $LONGDATETIME$"
# }
#
# 2. In your nagios contacts (Commonly found on contacts.cfg) add
# the SMS notification commands:
#
# service_notification_commands service-notify-by-sms
# host_notification_commands host-notify-by-sms
#
# 3. Add a pager number to your contacts, make sure it has the international
# prefix, e.g. 44 for UK or 1 for USA, without a leading 00 or +.
#
# pager 447700900000
#