mirror of
https://git.FreeBSD.org/ports.git
synced 2025-01-01 05:45:45 +00:00
538b425cc3
HEADS UP: See UPDATING for changes affecting your upgrade.
New installs not affected.
This patch adds a new rc_variable: librenms_daemonflags
The -T option is gone as that will force a log to syslog, doubling up on log
entries.
A new APP_LOG setting has been added to the .env file. Please update and
move your logs. See UPDATING.
PR: 246598
Submitted by: Dries Michiels <driesm.michiels@gmail.com>
117 lines
2.9 KiB
Plaintext
117 lines
2.9 KiB
Plaintext
[
|
|
{ type: install
|
|
message: <<EOM
|
|
|
|
You can mostly follow the guide at:
|
|
http://docs.librenms.org/
|
|
|
|
with the following notes:
|
|
- Installation directory is %%WWWDIR%%
|
|
|
|
NOTE: setting sql-mode="" is no longer required. You can remove
|
|
it from /usr/local/etc/mysql/my.cnf
|
|
|
|
HEADS UP
|
|
|
|
Polling via cron job has been removed.. Please use the Dispatcher.
|
|
|
|
LibreNMS will be dropped support for PHP 7.1 and Python 2
|
|
see https://community.librenms.org/t/dropping-support-for-php-7-1-and-python-2/11851
|
|
|
|
Your existing crontab entries are no longer useful and should be deleted.
|
|
|
|
Enable the poller service with this command:
|
|
|
|
sysrc librenms_enable="YES"
|
|
|
|
The service will log to /var/log/librems/librenms-service.log
|
|
|
|
see also https://docs.librenms.org/Extensions/Dispatcher-Service/
|
|
|
|
When converting from PYPOLLER to the Dispatcher Service (PYSERVICE),
|
|
these steps will help you get started:
|
|
|
|
* compile with PYSERVICE enabled and PYPOLLER disabled
|
|
* comment out the crontab entries listed above under PYPOLLER
|
|
* populate %%WWWDIR%%/.env with:
|
|
* APP_KEY - see farther below for how to create
|
|
* NODE_ID - see just below for how to create
|
|
* DB_HOST
|
|
* DB_DATABASE
|
|
* DB_USERNAME
|
|
* DB_PASSWORD
|
|
* you can create a NODE_ID with: php -r 'echo uniqid() . "\n";'
|
|
|
|
When setting up a new install, you need a %%WWWDIR%%/.env file.
|
|
|
|
To create:
|
|
|
|
cd %%WWWDIR%%
|
|
cp -i .env.example .env
|
|
|
|
That file will eventually contain secrets. Make sure it is not world-readable.
|
|
|
|
Database connection details are required in that file.
|
|
|
|
Then run:
|
|
|
|
sudo php artisan key:generate
|
|
|
|
It should write directly to your .env file
|
|
|
|
The output should look something like this:
|
|
|
|
$ sudo php artisan key:generate
|
|
Application key set successfully.
|
|
|
|
When migrating to PYSERVICE (also known as the Dispatcher Service):
|
|
|
|
It is also a good idea to:
|
|
cd %%WWWDIR%%
|
|
sudo ./validate.php
|
|
|
|
You need an APP_KEY.
|
|
|
|
|
|
After that, follow the LibreNMS documentation for configuration.
|
|
|
|
You probably want to install lang/python3 to get validate.php clean.
|
|
|
|
EOM
|
|
}
|
|
{ type: upgrade
|
|
message: <<EOM
|
|
Depending on the version, you may have to run the upgrade script.
|
|
|
|
cd %%WWWDIR%%
|
|
./build-base.php
|
|
|
|
Or the database upgrade script:
|
|
|
|
./lnms migrate
|
|
|
|
re: https://docs.librenms.org/#General/Updating/
|
|
|
|
HEADS UP HEADS UP HEADS UP HEADS UP HEADS UP HEADS UP HEADS UP HEADS UP
|
|
HEADS UP HEADS UP HEADS UP HEADS UP HEADS UP HEADS UP HEADS UP HEADS UP
|
|
|
|
Polling via cron job is now gone. Please use the Dispatcher.
|
|
|
|
LibreNMS will be droppped support for PHP 7.1 and Python 2.
|
|
see https://community.librenms.org/t/dropping-support-for-php-7-1-and-python-2/11851
|
|
|
|
Your existing crontab entries can be deleted.
|
|
|
|
For more information, see pkg info --pkg-message librenms
|
|
|
|
You probably want to install lang/python3 to get validate.php clean.
|
|
|
|
Logs have been relocated to /var/log/librenms - see UPDATING 20200726
|
|
Logs which were going to /var/log/messages and /var/log/librenms/ now only go
|
|
to /var/log/librenms/
|
|
|
|
|
|
EOM
|
|
}
|
|
]
|