Synology SNMP Network Monitoring with LibreNMS Docker

[jasonloong]

Tutorial updated to working

Details are on the tutorial changelog

Synology SNMP Network Monitoring with LibreNMS Docker - Jason Loong

Github Issue details:

v:latest, 1.64 poller-wrapper.py errors

Latest working, testing, Docker deployment of LibreNMS (fresh install)

MariaDB

docker run \
-v /volume1/docker/mariadb:/var/lib/mysql \
-e MYSQL_ROOT_PASSWORD=root_password \
-e TZ=Asia/Singapore \
--name mariadb \
-d \
--restart always \
mariadb:latest \
--innodb_file_per_table=1 \
--lower_case_table_names=0

LibreNMS

docker run \
-p 8668:80 \
-e DB_HOST=libredb \
-e DB_NAME=librenms \
-e DB_USER=librenms \
-e DB_PASS=libre_password \
-e APP_KEY=base64:THE_GENERATED_KEY \
-e BASE_URL=http://YOUR_NAS_IP:8668 \
-e TZ=Asia/Singapore \
--link mariadb:libredb \
-v /volume1/docker/librenms/logs:/opt/librenms/logs \
-v /volume1/docker/librenms/rrd:/opt/librenms/rrd \
-v /volume1/docker/librenms/custom.config.php:/opt/librenms/conf.d/custom.config.php:ro \
--name librenms \
-d \
--restart always \
jarischaefer/docker-librenms:latest

[fatbob01]

Good morning!

Wanted to say i appreciate your librenms setup guide very much. I had setup librenms before the July upgrade. I am trying to fix it. I recreated both containers using the new variables. The polling issue seems to be fixed but my graphs still don’t show up. Here is a screenshot of my mariadb container. I read your ticket with jari and the innodb + lower case values fixed your issues. Theyr don’t seem to work for me. Running on synology docker. Thanks for the help and good work!

[jasonloong]

Hi @fatbob01and welcome to the forums

@fatbob01

The polling issue seems to be fixed but my graphs still don’t show up.

I am assuming no issues previously for both poller and graphs, let me know if that’s not the case

Have you tried to validate the installation after pulling the new image?? (Page 2 of tutorial)

The validation should tell you to run ./lnms migrate (In Docker bash)

If you run into problems don’t forget to copy/paste or screenshot the logs (you can safely ignore the setfcl errors as Synology does not have setfcl)

[fatbob01]

This is what I get following a config validation. I tried the suggested fixes mentioned in the screenshot but no dice

[jasonloong]

Thank you for the validation screenshot.

Hm… everything seems to work fine from the validation

Which version are you using, and are you updating to latest libre?

I’ve recently updated to 1.67 from 1.66, you should see ./lnms migrate during validation

You might need to setup a second deployment of my tutorial steps from scratch to see whether it works, as I didn’t upgrade from before the new alias/db options. I suspect there might be database mismatches that point to invalid RRD links, thus the missing graphs…

(Do note that this deletes the device RRD graphs) If you have a not-so-important device, could you try to remove that device from LibreNMS and add it back again to see whether the graphs show up?

If you wish to keep the current data, I would recommend setting up a second set of librenms/mariadb with different port. eg: 8669 , and see whether the deployment works from the beginning

[big_bud]

Great tutorial, do you also have something how to get de agent (check_mk) to work?

[jasonloong]

Hi @big_bud and thank you

Hmm not too sure as I have never used the agent

How far have you been on their docs?? https://docs.librenms.org/Extensions/Agent-Setup/

[big_bud]

Agent etc is working but cannot connect to the docker container I think. Need to recreate the container with port 6556 also added but I’m not very sure.

[jasonloong]

Hm, TCP-6556 is FROM the librenms, so you don’t need to open ports on the container side, you would need to check firewall and allow TCP-6556 on the device with the agent.

I came across this: Hi everyone! Question about LibreNMS and the check_mk agent - LibreNMS Community

I would do the following:

1. Ensure firewall allow on the device with agent
2. In librenms, under the device with agent, Settings > Modules > Enable Unix Agent (Left of page)
3. You have to manually allow the apps/modules that you want to monitor on. Application Docs / Agent
4. On same device page, 3 dots (beside Settings/Gear Icon) , click on Capture, under Discovery, click Run. Check for check_mk logs (screenshot: LibreNMS and Raspberry Pi - #3 by jasonloong)
5. Do same as above for Poller, and check logs on the check_mk/unix agent

If that still does not work

1. You have to manually check the scripts provided and make sure they point to correct bin PATH if non-standard Linux like FreeBSD
2. If Windows: make sure firewall is allowed

Hope that helps Let me know if that worked out!

[JasterMereel]

I am going through this tutorial now. I see in the tutorial, you are running MariaDB in another Docker container. However, I already have a MariaDB set up on my Synology.

I see the line below:

–link mariadb:libredb \

I see that creates a link from the MariaDB container to the LibreNMS container. If I don’t need this link, how could I modify this command? Or can I just remove it?

[jasonloong]

Hi @JasterMereel

Yes, please remove the –link mariadb:libredb \ , as it is a convenience command to “link” hostname of “libredb” to another container called “mariadb” which was created in the tutorial

For your case, you should update -e DB_HOST=SYNO.IP \ and other SQL credentials to your MariaDB settings on Syno

-e DB_NAME=librenms \
-e DB_USER=librenms \
-e DB_PASS='libre_password' \

Please also update the permissions on the Syno MariaDB to allow access from the container

[JasterMereel]

@jasonloong

Please also update the permissions on the Syno MariaDB to allow access from the container

Would that be accomplished with this command?

GRANT ALL PRIVILEGES ON librenms.* TO 'librenms'@'%';

[jasonloong]

Yes, if you have a different username created for librenms, please update the command accordingly

[miknl]

Hi!

Trying your guide, but I must be doing something wrong. I used an existing MariaDB container, but as far as I can tell I have changed the commands appropriately

When I come to this command:

docker exec librenms setup_database

I get this error:

Could not open input file: /opt/librenms/includes/sql-schema/update.php

Any ideas? Thanks!

[jasonloong]

Hi @miknl , welcome to the forum

Hmmm. I’ve never seen that before, let me test the tutorial I’ll get back to you again

Are you using the latest tag for LibreNMS?

[miknl]

Hi!

Yeah I’m pretty sure it uses the latest.

[jasonloong]

@miknl

Could not open input file: /opt/librenms/includes/sql-schema/update.php

Right… I have the same issue for latest, 23.9.1, 23.8.1

Will need to write in to the image maintainer jarischaefer/docker-librenms

For a working version, you can use version 23.5.0 (I have tested this as a fresh install on my Syno after your forum post)

jarischaefer/docker-librenms:23.5.0

Adjust the LibreNMS docker command to the following:

docker run \
-p 8668:80 \
-e DB_HOST=libredb \
...
...
--name librenms \
-d \
--restart always \
jarischaefer/docker-librenms:23.5.0

Let me know if v23.5.0 works on your end

[miknl]

Hi!

Thanks! I got it working… FYI, I also had to change these steps:

APPKEY COMMAND
Not sure if needed, but I edited the command to use that specific version, like this:

docker run --rm jarischaefer/docker-librenms:23.5.0 generate_key

ADMIN USER COMMAND
This command:

docker exec librenms create_admin

Returns this error:

Could not open input file: /opt/librenms/adduser.php

But I used this method instead: in the Synology Container manager, I opened a terminal window and issued this command:

sudo -u librenms lnms user:add -p [password] -r admin [username]

This worked, and I can now login… I have absolutely no idea what to do next hahaha, but I’m sure I’ll figure out how LibreNMS works

[jasonloong]

@miknl Thanks for the updates and commands!

I assumed it would work on my end for 23.5.0, sorry about that.

Further: When run docker exec docker-librenms create_admin · Issue #141 · jarischaefer/docker-librenms · GitHub

The actual working tag when I updated my tutorial was 23.5.0-1 (using latest at that time)

23.5.0-1

• fully tested as per tutorial page 1

Useful commands (Manual)

• If you encounter any errors when creating a user, one alternative method is to use LibreNMS’s CLI command lnms to manually add a user

@miknl

sudo -u librenms lnms user:add -p [password] -r admin [username]

[jasonloong]

@miknl

This worked, and I can now login… I have absolutely no idea what to do next hahaha, but I’m sure I’ll figure out how LibreNMS works

You can begin to add SNMP enabled devices and monitor them