Merge branch 'master' of github.com:librenms/librenms

This commit is contained in:
Paul Gear
2013-10-28 18:02:02 +10:00
3 changed files with 5 additions and 80 deletions
-80
View File
@@ -1,80 +0,0 @@
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
+2
View File
@@ -31,6 +31,7 @@ now restart MySQL
## 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
cd /opt
git clone https://github.com/libertysys/librenms.git librenms
cd /opt/librenms
cp config.php.default config.php
@@ -87,6 +88,7 @@ Next, add the following to `/etc/apache2/available-sites/librenms.conf`
Enable the vhost and restart Apache
a2ensite librenms.conf
a2enmod rewrite
service apache2 restart
### Add localhost ###
+3
View File
@@ -0,0 +1,3 @@
33 */6 * * * root /opt/librenms/discovery.php -h all >> /dev/null 2>&1
*/5 * * * * root /opt/librenms/discovery.php -h new >> /dev/null 2>&1
*/5 * * * * root /opt/librenms/poller.php -h all >> /dev/null 2>&1