mirror of
https://github.com/librenms/librenms.git
synced 2024-10-07 16:52:45 +00:00
Add install instructions and update section on contribution and copyright
This commit is contained in:
81
INSTALL
81
INSTALL
@@ -1,3 +1,80 @@
|
|||||||
Please see http://www.observium.org for up to date installation instructions.
|
NOTE: What follows is a very rough list of commands. This works on a fresh install of Ubuntu 12.04.
|
||||||
|
NOTE: These instructions assume you are using a separate server for your database. You will need to adjust the instructions if you are running the database on the same server.
|
||||||
|
|
||||||
|
## On the DB Server ##
|
||||||
|
|
||||||
|
aptitude install mysql-server mysql-client snmpd
|
||||||
|
mysql -uroot -p
|
||||||
|
|
||||||
|
enter root mysql password
|
||||||
|
Create database
|
||||||
|
|
||||||
|
CREATE DATABASE librenms;
|
||||||
|
GRANT ALL PRIVILEGES ON librenms.*
|
||||||
|
TO 'librenms'@'<ip>'
|
||||||
|
IDENTIFIED BY '<password>'
|
||||||
|
;
|
||||||
|
FLUSH PRIVILEGES;
|
||||||
|
exit
|
||||||
|
|
||||||
|
allow MySQL to listen on local LAN
|
||||||
|
|
||||||
|
vim /etc/mysql/my.cnf
|
||||||
|
|
||||||
|
edit line 47 (should be `bind-address = 127.0.0.1`)
|
||||||
|
and change it to your IP address
|
||||||
|
now restart MySQL
|
||||||
|
|
||||||
|
service mysql restart
|
||||||
|
|
||||||
|
|
||||||
|
## On the NMS ##
|
||||||
|
|
||||||
|
aptitude install libapache2-mod-php5 php5-cli php5-mysql php5-gd php5-snmp php-pear snmp graphviz php5-mcrypt apache2 fping imagemagick whois mtr-tiny nmap python-mysqldb snmpd mysql-client php-net-ipv4 php-net-ipv6 rrdtool
|
||||||
|
git clone https://github.com/libertysys/librenms.git librenms
|
||||||
|
cd /opt/librenms
|
||||||
|
cp config.php.default config.php
|
||||||
|
vim config.php
|
||||||
|
|
||||||
|
change lines 6-9 to match your db config
|
||||||
|
change lines 17 and 20 to 'librenms'
|
||||||
|
change line 31 to match your most common read-only SNMP community string
|
||||||
|
|
||||||
|
copy sql commands to db server
|
||||||
|
|
||||||
|
scp -r build.sql <ip>:
|
||||||
|
|
||||||
|
Subsitute your database server's IP address. If it's local host, the above step is unnecessary.
|
||||||
|
|
||||||
|
## On DB Server ##
|
||||||
|
|
||||||
|
mysql -ulibrenms -p < build.sql
|
||||||
|
|
||||||
|
This assumes you used the username `librenms`. If you used something different, adjust here.
|
||||||
|
|
||||||
|
## On the NMS ##
|
||||||
|
|
||||||
|
Create admin user - priv should be 10
|
||||||
|
|
||||||
|
php adduser.php <name> <pass> 10
|
||||||
|
|
||||||
|
Substitute your desired username and password--and leave the angled brackets off.
|
||||||
|
|
||||||
|
### Add localhost ###
|
||||||
|
|
||||||
|
php addhost.php localhost public v2c
|
||||||
|
|
||||||
|
This assumes you haven't made community changes--if you have, replace `public` with your community. It also assumes SNMP v2c. If you're using v3, there are additional steps (NOTE: instructions for SNMPv3 to come).
|
||||||
|
|
||||||
|
Discover localhost
|
||||||
|
|
||||||
|
php discovery.php -h all
|
||||||
|
|
||||||
|
First poller
|
||||||
|
|
||||||
|
php poller.php -h all
|
||||||
|
|
||||||
|
Create the cronjob
|
||||||
|
|
||||||
|
cp librenms.cron /etc/cron.d/librenms
|
||||||
|
|
||||||
Please also contact us through the mailing list or on IRC if you run into any issues.
|
|
||||||
|
89
README.md
89
README.md
@@ -2,6 +2,7 @@ License
|
|||||||
-------
|
-------
|
||||||
|
|
||||||
Copyright (C) 2006-2012 Adam Armstrong <adama@memetic.org>
|
Copyright (C) 2006-2012 Adam Armstrong <adama@memetic.org>
|
||||||
|
Copyright (C) 2013 LibreNMS Group <librenms-project@googlegroups.com>
|
||||||
|
|
||||||
This program is free software: you can redistribute it and/or modify
|
This program is free software: you can redistribute it and/or modify
|
||||||
it under the terms of the GNU General Public License as published by
|
it under the terms of the GNU General Public License as published by
|
||||||
@@ -42,8 +43,90 @@ behaviour towards others.
|
|||||||
Installation
|
Installation
|
||||||
------------
|
------------
|
||||||
|
|
||||||
For now please see the existing instructions at http://www.observium.org/.
|
NOTE: What follows is a very rough list of commands. This works on a fresh install of Ubuntu 12.04.
|
||||||
|
NOTE: These instructions assume you are using a separate server for your database. You will need to adjust the instructions if you are running the database on the same server.
|
||||||
|
|
||||||
Please join the librenms-project at http://groups.google.com/ if you would
|
## On the DB Server ##
|
||||||
like to participate.
|
|
||||||
|
|
||||||
|
aptitude install mysql-server mysql-client snmpd
|
||||||
|
mysql -uroot -p
|
||||||
|
|
||||||
|
enter root mysql password
|
||||||
|
Create database
|
||||||
|
|
||||||
|
CREATE DATABASE librenms;
|
||||||
|
GRANT ALL PRIVILEGES ON librenms.*
|
||||||
|
TO 'librenms'@'<ip>'
|
||||||
|
IDENTIFIED BY '<password>'
|
||||||
|
;
|
||||||
|
FLUSH PRIVILEGES;
|
||||||
|
exit
|
||||||
|
|
||||||
|
allow MySQL to listen on local LAN
|
||||||
|
|
||||||
|
vim /etc/mysql/my.cnf
|
||||||
|
|
||||||
|
edit line 47 (should be `bind-address = 127.0.0.1`)
|
||||||
|
and change it to your IP address
|
||||||
|
now restart MySQL
|
||||||
|
|
||||||
|
service mysql restart
|
||||||
|
|
||||||
|
|
||||||
|
## On the NMS ##
|
||||||
|
|
||||||
|
aptitude install libapache2-mod-php5 php5-cli php5-mysql php5-gd php5-snmp php-pear snmp graphviz php5-mcrypt apache2 fping imagemagick whois mtr-tiny nmap python-mysqldb snmpd mysql-client php-net-ipv4 php-net-ipv6 rrdtool
|
||||||
|
git clone https://github.com/libertysys/librenms.git librenms
|
||||||
|
cd /opt/librenms
|
||||||
|
cp config.php.default config.php
|
||||||
|
vim config.php
|
||||||
|
|
||||||
|
change lines 6-9 to match your db config
|
||||||
|
change lines 17 and 20 to 'librenms'
|
||||||
|
change line 31 to match your most common read-only SNMP community string
|
||||||
|
|
||||||
|
copy sql commands to db server
|
||||||
|
|
||||||
|
scp -r build.sql <ip>:
|
||||||
|
|
||||||
|
Subsitute your database server's IP address. If it's local host, the above step is unnecessary.
|
||||||
|
|
||||||
|
## On DB Server ##
|
||||||
|
|
||||||
|
mysql -ulibrenms -p < build.sql
|
||||||
|
|
||||||
|
This assumes you used the username `librenms`. If you used something different, adjust here.
|
||||||
|
|
||||||
|
## On the NMS ##
|
||||||
|
|
||||||
|
Create admin user - priv should be 10
|
||||||
|
|
||||||
|
php adduser.php <name> <pass> 10
|
||||||
|
|
||||||
|
Substitute your desired username and password--and leave the angled brackets off.
|
||||||
|
|
||||||
|
### Add localhost ###
|
||||||
|
|
||||||
|
php addhost.php localhost public v2c
|
||||||
|
|
||||||
|
This assumes you haven't made community changes--if you have, replace `public` with your community. It also assumes SNMP v2c. If you're using v3, there are additional steps (NOTE: instructions for SNMPv3 to come).
|
||||||
|
|
||||||
|
Discover localhost
|
||||||
|
|
||||||
|
php discovery.php -h all
|
||||||
|
|
||||||
|
First poller
|
||||||
|
|
||||||
|
php poller.php -h all
|
||||||
|
|
||||||
|
Create the cronjob
|
||||||
|
|
||||||
|
cp librenms.cron /etc/cron.d/librenms
|
||||||
|
|
||||||
|
Contributing
|
||||||
|
------------
|
||||||
|
|
||||||
|
Clone the repo and file bug reports and pull requests here.
|
||||||
|
Join the [librenms-project][1] mailing list to post questions and suggestions.
|
||||||
|
|
||||||
|
[1]: https://groups.google.com/forum/#!forum/librenms-project "LibreNMS"
|
||||||
|
Reference in New Issue
Block a user