https://github.com/x70b1/check_routeros-upgrade

A simple monitoring plugin to check RouterOS for updates.
https://github.com/x70b1/check_routeros-upgrade

mikrotik nagios-plugin routeros sensu sensu-plugin snmp

Last synced: about 2 months ago
JSON representation

A simple monitoring plugin to check RouterOS for updates.

• Host: GitHub
• URL: https://github.com/x70b1/check_routeros-upgrade
• Owner: x70b1
• License: gpl-3.0
• Archived: true
• Created: 2017-02-22T09:07:42.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2022-02-27T14:18:41.000Z (almost 3 years ago)
• Last Synced: 2024-08-02T16:09:12.509Z (5 months ago)
• Topics: mikrotik, nagios-plugin, routeros, sensu, sensu-plugin, snmp
• Language: Shell
• Homepage:
• Size: 29.3 KB
• Stars: 7
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# check_routeros-upgrade

[![Codecheck](https://github.com/x70b1/check_routeros-upgrade/workflows/Codecheck/badge.svg?branch=master)](https://github.com/x70b1/check_routeros-upgrade/actions)

[![GitHub contributors](https://img.shields.io/github/contributors/x70b1/check_routeros-upgrade.svg)](https://github.com/x70b1/check_routeros-upgrade/graphs/contributors)

[![license](https://img.shields.io/github/license/x70b1/check_routeros-upgrade.svg)](https://github.com/x70b1/check_routeros-upgrade/blob/master/LICENSE)

A simple monitoring plugin to check RouterOS for updates.

This script should work with different monitoring frameworks like Nagios, Icinga, Naemon, Shinken or Sensu.

## Features

* connect with SNMP or SSH

* select your RouterOS release tree

* read the changelog to get more information about bugfix importance

The return code depends on the importance of the fixes found in the changelog.

An important bugfix leads to a `CRITICAL`.

Average fixes result in a `WARNING`.

Some examples:

* OK: RouterOS 6.39.2 is up to date (release: Jun-06)

* WARNING: RouterOS is upgradable to 6.39.2 (6 average fixes)

* CRITICAL: RouterOS is upgradable to 6.38.7 (2 important fixes, 75 average fixes)

This script is also available as sensu-plugin in `sensu-plugins-routeros`.

## Configuration

* sh **check_routeros-upgrade.sh** *snmp* *HOST* [*PORT*] [*COMMUNITY*] [*RELEASE-TREE*]

* sh **check_routeros-upgrade.sh** *ssh* *HOST* [*PORT*] [*USER*] [*RELEASE-TREE*]

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`.