sensu-plugins-routeros 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: e21569e8a78ae109b530cf1e7a7134ae961f76d5
-  data.tar.gz: a334626f58069fe0c3f901d7788c01fb16d78c4a
+SHA256:
+  metadata.gz: 341b7d22cc83fa3d512b6467c899298b7e461615aceebb8ccb4665eb9bf0e5bc
+  data.tar.gz: 76c257de64c693d0e862d9b3c188ffa3f932ff42ee4eab71898ab3aca97f9cbb
 SHA512:
-  metadata.gz: 3da8b2946f933d17881344b9d8fdea179fd40fcc68d4060719da014816f7fe270ed902a3fa99c99342b4f35178b92284f43b2692fe318326fd9082e4ea17858e
-  data.tar.gz: db1bc0831caa312e3bd7e0d9498841dce6746dbcc61302686c5740eeaaed409bca855fb4feec5680132cc9cf5bb3ef2129e2155cadb34709c902ab93150c2b04
+  metadata.gz: 600cbd09a3e8249ad12b5c5f208a58e581b85101e1c77dc67ac58a7b2e3eba400f611220306877d913cb5c617b27dc3b9764d56378f880e1c5644be7b653508c
+  data.tar.gz: 0741f2aab5630e5d56f28f23442a81ad4911d3fc97d7d418c02eca5208a244780efa405e126efef2613f94b85606f324e4827505f0db6682153bb88b08bd5015

data/CHANGELOG.md

@@ -5,6 +5,10 @@ This CHANGELOG follows the format located [here](https://github.com/sensu-plugin
 
 ## [Unreleased]
 
+## [0.1.0] - 2018-05-23
+### Added
+- shell script check-upgrade.sh (@x70b1)
+
 ## [0.0.1] - 2018-05-02
 ### Security
 - updated `yard` dependency to `~> 0.9.11` per: https://nvd.nist.gov/vuln/detail/CVE-2017-17042 which closes attacks against a yard server loading arbitrary files (@majormoses)
@@ -19,5 +23,6 @@ This CHANGELOG follows the format located [here](https://github.com/sensu-plugin
 - Rubocop config
 - basic testing setup
 
-[Unreleased]: https://github.com/sensu-plugins/sensu-plugins-routeros/compare/0.0.1...HEAD
+[Unreleased]: https://github.com/sensu-plugins/sensu-plugins-routeros/compare/0.1.0...HEAD
+[0.1.0]: https://github.com/sensu-plugins/sensu-plugins-routeros/compare/0.0.1...0.1.0
 [0.0.1]: https://github.com/sensu-plugins/sensu-plugins-routeros/compare/42104a9443c472f5f96a028535488f4b5d3efe88...0.0.1

data/README.md

@@ -1,24 +1,41 @@
-# Sensu Plugin Skeleton
+## Sensu-Plugins-RouterOS
 
-All the files you'll need to start your own plugin written in Ruby [for Sensu](https://github.com/sensu/sensu), the monitoring framework.
+[![Build Status](https://travis-ci.org/sensu-plugins/sensu-plugins-routeros.svg?branch=master)](https://travis-ci.org/sensu-plugins/sensu-plugins-routeros)
+[![Gem Version](https://badge.fury.io/rb/sensu-plugins-routeros.svg)](http://badge.fury.io/rb/sensu-plugins-routeros)
+[![Dependency Status](https://gemnasium.com/sensu-plugins/sensu-plugins-routeros.svg)](https://gemnasium.com/sensu-plugins/sensu-plugins-routeros)
+[![Community Slack](https://slack.sensu.io/badge.svg)](https://slack.sensu.io/badge)
 
-## Useful to Me?
+## Files
 
-* Copy the files in this repository if you want to write a Ruby plugin following best practices of layout and structure
-* To write the actual functionality, you'll need to import [Sensu Plugin gem](https://github.com/sensu-plugins/sensu-plugin)
-* If you'd prefer writing in Python, use the [Python Plugin library](https://github.com/sensu-plugins/sensu-plugin-python)
-* Regardless of the chosen language, prepare the plugin to be released as a Ruby gem for optimal portability (example: [MongoDB has Ruby and Python code](https://github.com/sensu-plugins/sensu-plugins-mongodb/tree/master/bin))
+* bin/check-upgrade.sh
 
-## Checklist
+## Usage
 
-To release your own plugin, complete the following:
+* sh **check_routeros-upgrade.sh** *snmp* *HOST* [*PORT*] [*COMMUNITY*] [*RELEASE-TREE*]
+* sh **check_routeros-upgrade.sh** *ssh* *HOST* [*PORT*] [*USER*] [*RELEASE-TREE*]
 
-- [ ] Double check that another plugin doesn't already do what you need by [searching the Sensu Plugins organization](https://github.com/sensu-plugins)
-- [ ] Copy the files here into your own repository following the naming convention of `sensu-plugins-$FOO`
-- [ ] Delete or move this file and rename `README-skel.md` to `README.md`
-- [ ] Write your own checks, handlers or mutators using the plugin library of your choice
-- [ ] Push them to your own GitHub repository
-- [ ] Release them as a Ruby gem for optimal portability within the Sensu 1.x framework
-- [ ] Ask for feedback from your peers by sharing it on in the #contributing channel on [Sensu Community Slack](http://slack.sensu.io)
-- [ ] When you're ready to share further, offer to share it with broader community [by transferring it to Sensu Plugins organization](https://github.com/sensu-plugins/community/blob/master/TRANSFERRING_REPOS.md)
-- [ ] If you end up loving maintaining your plugin, [volunteer to be an org maintainer](https://github.com/sensu-plugins/community#how-you-can-help)
+The default values for SNMP are:
+* PORT=161
+* COMMUNITY=public
+
+For a check over SSH:
+* PORT=22
+* USER=user
+
+You need an user and SSH keys. There is no option for a password.
+
+**[RELEASE TREE]**
+
+Different settings are available. The default is `stable`. Choose wise.
+
+* stable
+* bugfix
+* release-candidate
+
+**ENV ROUTEROS_UPDATEURL**
+
+If you want to save the update information on your own server you can use `export ROUTEROS_UPDATEURL` to overwrite the default `https://download.mikrotik.com/routeros`.
+
+## Installation
+
+[Installation and Setup](http://sensu-plugins.io/docs/installation_instructions.html)

data/bin/check-upgrade.sh

@@ -0,0 +1,112 @@
+#!/bin/sh
+
+error="0"
+
+if [ -z "${ROUTEROS_UPDATEURL}" ]; then
+    routeros_url="https://download.mikrotik.com/routeros"
+else
+    routeros_url="${ROUTEROS_UPDATEURL}"
+fi
+
+if [ "$1" = "snmp" ]; then
+    if [ -z "$3" ]; then
+        param_port="161"
+    else
+        param_port=$3
+    fi
+
+    if [ -z "$4" ]; then
+        param_community="public"
+    else
+        param_community=$4
+    fi
+
+    if ! routeros_installed=$(snmpget -O qv -v 2c -c "$param_community" "$2":"$param_port" SNMPv2-SMI::enterprises.14988.1.1.4.4.0 2> /dev/null); then
+        error="Could not establish an SNMP connection to the device!"
+    else
+        routeros_installed=$(echo "$routeros_installed" | tr -d '"')
+    fi
+elif [ "$1" = "ssh" ]; then
+    if [ -z "$3" ]; then
+        param_port="22"
+    else
+        param_port=$3
+    fi
+
+    if [ -z "$4" ]; then
+        param_user="user"
+    else
+        param_user=$4
+    fi
+
+    if ! routeros_installed=$(ssh -q -p "$param_port" "$param_user"@"$2" ':put [/system package get system version]'); then
+        error="Could not establish an SSH connection to the device!"
+    else
+        routeros_installed=$(echo "$routeros_installed" | tr -d "\\r\\n")
+    fi
+else
+    echo "Use SNMP or SSH as connection type!"
+    exit 2
+fi
+
+
+if [ "$error" = "0" ]; then
+    # select the version
+    case $5 in
+        "stable")
+            param_version="6"
+            ;;
+        "release-candidate")
+            param_version="6rc"
+            ;;
+        "bugfix")
+            param_version="6fix"
+            ;;
+        *)
+            param_version="6"
+            ;;
+    esac
+
+    # check the MikroTik server for upgrades
+    if ! routeros_available=$(curl -fsA "check_routeros-upgrade" "$routeros_url/LATEST.$param_version"); then
+        echo "Could not reach the MikroTik server to check the latest version!"
+        exit 1
+    fi
+
+    routeros_available_version=$(echo "$routeros_available" | cut -d " " -f 1)
+    routeros_available_releasedate=$(echo "$routeros_available" | cut -d " " -f 2)
+
+    # compare latest version with device version
+    if [ "$routeros_available_version" = "$routeros_installed" ]; then
+        echo "RouterOS $routeros_available_version is up to date (release: $(date -u -d @"$routeros_available_releasedate" +'%b-%d'))"
+        exit 0
+    else
+        # read the changelog
+        if ! changelog=$(curl -fsA "check_routeros-upgrade" "$routeros_url/$routeros_available_version/CHANGELOG"); then
+            echo "Could not reach the MikroTik server to read the changelog!"
+            exit 1
+        fi
+
+        changelog_lines=$(echo "$changelog" | grep -n "What" | head -n 2 | tail -n 1 | cut -d ":" -f 1)
+
+        changelog_impfix=$(echo "$changelog" | head -n "$changelog_lines" | grep -c '!)')
+        changelog_avgfix=$(echo "$changelog" | head -n "$changelog_lines" | grep -c '[*])')
+
+        if [ "$changelog_impfix" -ne 0 ] && [ "$changelog_avgfix" -ne 0 ]; then
+            fix_text="$changelog_impfix important fixes, $changelog_avgfix average fixes"
+            fix_result=2
+        elif [ "$changelog_impfix" -ne 0 ]; then
+            fix_text="$changelog_impfix important fixes"
+            fix_result=2
+        elif [ "$changelog_avgfix" -ne 0 ]; then
+            fix_text="$changelog_avgfix average fixes"
+            fix_result=1
+        fi
+
+        echo "RouterOS is upgradable to $routeros_available_version ($fix_text)"
+        exit $fix_result
+    fi
+else
+    echo "$error"
+    exit 2
+fi

data/lib/sensu-plugins-routeros/version.rb

@@ -1,8 +1,8 @@
 module SensuPluginRouterOS
   module Version
     MAJOR = 0
-    MINOR = 0
-    PATCH = 1
+    MINOR = 1
+    PATCH = 0
 
     VER_STRING = [MAJOR, MINOR, PATCH].compact.join('.')
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sensu-plugins-routeros
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Sensu-Plugins and contributors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-02 00:00:00.000000000 Z
+date: 2018-05-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sensu-plugin
@@ -201,6 +201,7 @@ files:
 - CHANGELOG.md
 - LICENSE
 - README.md
+- bin/check-upgrade.sh
 - lib/sensu-plugins-routeros.rb
 - lib/sensu-plugins-routeros/version.rb
 homepage: https://github.com/sensu-plugins/sensu-plugins-routeros
@@ -229,7 +230,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.2.2
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
 summary: Sensu plugins for router os