Download the PHP package sirzeruks/librenms-routeros-bgp without Composer

On this page you can find all versions of the php package sirzeruks/librenms-routeros-bgp. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of sirzeruks/librenms-routeros-bgp

Informations about the package librenms-routeros-bgp

LibreNMS RouterOS BGP prefixes

Total installs Monthly installs Latest version GitHub stars Page views

BGP prefix counts for MikroTik RouterOS v7 in LibreNMS.

LibreNMS shows BGP prefix graphs for Cisco, Juniper, Arista, Huawei and others, but not for MikroTik: RouterOS v7 only publishes a small part of the BGP4-MIB over SNMP, without any prefix counters. This plugin fetches the counts straight from the router (read-only) and stores them where LibreNMS keeps prefix counts for every other vendor. The result:

Status

Early release. SSH is in daily use against 20+ production RouterOS v7 routers. All five connection methods (SSH, REST over HTTP/HTTPS, RouterOS API, API-SSL) and the IPv6 support are tested against RouterOS 7.23. Reports (good or bad) are welcome in the issues.

Features

Requirements
LibreNMS a current release with lnms plugin:add
RouterOS v7 (v6 has a different BGP implementation and is not supported)
LibreNMS BGP discovery the MikroTik's BGP peers must already show in LibreNMS (they do by default over SNMP)
Router access a read-only user on each MikroTik and one service reachable from LibreNMS: www-ssl, www, api-ssl, api or ssh

Install / update (2 minutes)

Download the installer, read it, then run it as root on the LibreNMS server:

Or by hand, as the LibreNMS user:

Then in the web UI: Overview → Plugins → Plugin Admin → routeros-bgp → Settings.

The plugin survives LibreNMS's nightly updates: LibreNMS re-installs user plugins after each update.

Set up (5 minutes)

  1. On each MikroTik create a read-only user for LibreNMS:

  2. In the plugin settings enter the username/password and choose how to connect (REST over HTTPS is the default).
  3. Press Test next to a device. You should see its BGP sessions with prefix counts.
  4. Tick Collect prefix counts and save. Graphs fill in within 5–10 minutes.

The full step-by-step guide, router preparation for every connection method, custom ports, troubleshooting and uninstall are in the manual.

Uninstall

Changed your mind? One command removes it, the same way it was installed:

Or by hand, as the LibreNMS user:

LibreNMS keeps running normally; the plugin's pages and its part of the device poll are gone. Left behind, by design:

What How to remove it
Stored prefix counts and prefix graphs Manual, section 10
IPv6 peers the plugin added removed automatically at LibreNMS's next discovery of each router
The plugin's settings, including the encrypted router password in sudo -u librenms ./lnms db: DELETE FROM plugins WHERE plugin_name = 'routeros-bgp';
The read-only user on your routers /user remove [find name=librenms] and /user group remove [find name=librenms-read]

How it works

Support

Disclaimer

Use at your own risk. This plugin is provided "as is", without warranty of any kind (GPL-3.0, sections 15 and 16). The author accepts no responsibility or liability for any damage, outage or security incident arising from its use, including when your LibreNMS server, its database or its backups are compromised. Securing your server and routers is your responsibility. Always give the plugin a read-only router user limited to the LibreNMS server's address, so a leaked password cannot change your routers. Read Security and your responsibility before you deploy it.

License

GPL-3.0-or-later, the same as LibreNMS. See LICENSE.

All versions of librenms-routeros-bgp with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
librenms/plugin-interfaces Version ^1.0
phpseclib/phpseclib Version ^3.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package sirzeruks/librenms-routeros-bgp contains the following files

Loading the files please wait ...