mirror of
https://github.com/librenms/librenms.git
synced 2024-10-07 16:52:45 +00:00
06b85f5b07
* clean 1-Minute-Polling.md formatting * cleanup formatting for Adding-a-Device.md * clean up formatting of Cleanup-options.md * cleanup formatting some for CLI-Tools.md * cleanup formatting for Syslog.md and Configuration.md * cleanup formatting for Device-Sensors.md * cleanup formatting for Device-Troubleshooting.md * cleanup Discovery Support.md * cleanup Environment-Variables.md * cleanup Example-Hardware-Setup.md and FAQ.mg * update Features.md, Install Validation.md, Perfermance.md, Poller Support.md, and index.md * cleanup Remote-Monitoring-VPN.md, SNMP-Configuration-Examples.md, and SSL-Configuration.md * lots of updates for Installation docs * more installation doc cleanup * more formatting cleanup * clean Work-Map.md up some
54 lines
1.9 KiB
Markdown
54 lines
1.9 KiB
Markdown
source: Install Validation.md
|
|
path: blob/master/doc/
|
|
|
|
# Install validation
|
|
|
|
With a lot of configuration possibilities, manually editing config.php
|
|
means it's not uncommon that mistakes get made. It's also impossible
|
|
to validate user input in config.php when you're just using a text
|
|
editor :)
|
|
|
|
So, to try and help with some of the general issues people come across
|
|
we've put together a simple validation tool which at present will:
|
|
|
|
- Validate config.php from a php perspective including whitespace
|
|
where it shouldn't be.
|
|
- Connection to your MySQL server to verify credentials.
|
|
- Checks if you are running the older alerting system.
|
|
- Checks your rrd directory setup if not running rrdcached.
|
|
- Checks disk space for where /opt/librenms is installed.
|
|
- Checks location to fping
|
|
- Tests MySQL strict mode being enabled
|
|
- Tests for files not owned by librenms user (if configured)
|
|
|
|
Optionally you can also pass -m and a module name for that to be
|
|
tested. Current modules are:
|
|
|
|
- mail - This will validate your mail transport configuration.
|
|
- dist-poller - This will test your distributed poller configuration.
|
|
- rrdcheck - This will test your rrd files to see if they are
|
|
unreadable or corrupted (source of broken graphs).
|
|
|
|
You can run validate.php as `root` by executing `./validate.php`
|
|
within your install directory.
|
|
|
|
The output will provide you either a clean bill of health or a list of
|
|
things you need to fix:
|
|
|
|
**OK** - This is a good thing, you can skip over these :)
|
|
|
|
**WARN** - You probably want to check this out.
|
|
|
|
**FAIL** - This is going to need your attention!
|
|
|
|
# Validate from the WebUI
|
|
|
|
You can validate your LibreNMS install from the WebUI, using the nav
|
|
bar and clicking on the little Gear Icon -> Validate
|
|
Config.  Then
|
|
You should see the results of validate.
|
|
|
|
Below is just example of the results.
|
|
|
|
|