Changes between Version 5 and Version 6 of librenms

Timestamp:

Nov 22, 2016, 6:01:28 AM (9 years ago)

Author:

admin

Comment:

--

librenms

@@ -165 +165 @@
 }}}
 
+== LibreNMS ==
+
+=== Installing LibreNMS ===
+
+    These instructions assume you are the root user. If you are not, prepend ''sudo'' to the shell commands (the ones that aren't at ''mysql>'' prompts) or temporarily invoke root privileges.
+
+ 
+==== Create database ====
+
+'''NOTE''': These instructions are based on the official LibreNMS installation notes and have been tested on a fresh install of Ubuntu 16.0.
+
+We will assume that the database is running on the same machine as your network management server (this is the most common initial deployment scenario).
+
+First install mysql and configure:
+{{{
+# apt-get update (Already done)
+# apt-get install mysql-server mysql-client
+}}}
+You will be asked to enter a password for the MySQL root user. Be absolutely sure that you remember what you choose here. You will use this later.
+{{{
+# mysql -uroot -p
+}}}
+Input the MySQL root password (the one you chose in the previous step) to enter the MySQL command-line interface where you will get a mysql> prompt.
+
+Create the database:
+{{{
+CREATE DATABASE librenms;
+GRANT ALL PRIVILEGES ON librenms.*
+TO 'librenms'@'localhost'
+IDENTIFIED BY '<Your Password>'
+;
+FLUSH PRIVILEGES;
+exit
+}}}
+PLEASE NOTE
+
+Here we are using <your Password> as the password for LibreNMS to access MySQL. Please replace <your Password> with, Please do not forget the password as you will need it in the future
+
+==== Install LibreNMS ====
+
+The NMS is the host is where the web server and SNMP poller run.
+
+Install the required software:
+{{{
+apt-get install libapache2-mod-php7.0 php7.0-cli php7.0-mysql php7.0-gd php7.0-snmp php-pear php7.0-curl snmp graphviz php7.0-mcrypt php7.0-json apache2 fping imagemagick whois mtr-tiny nmap python-mysqldb snmpd php-net-ipv4 php-net-ipv6 rrdtool git
+}}}
+
+The packages listed above are an all-inclusive list of packages that were necessary on a clean install of Ubuntu 16.0
+
+==== snmp ====
+
+You need to configure snmpd appropriately if you have not already done so. We will do a minimal snmp configuration on our server -- '''please DON'T''' do this if you've already configured SNMP earlier!
+{{{
+# mv /etc/snmp/snmpd.conf /etc/snmp/snmpd.conf.orig
+# vi /etc/snmp/snmpd.conf
+}}}
+and, add the following line to the empty file:
+{{{
+rocommunity NetManage 127.0.0.1
+}}}
+And, now restart the snmp service so that the changes become active.
+{{{
+# service snmpd restart
+}}}
+You can verify that snmp now responds to you locally by typing:
+{{{
+# snmpstatus -v2c -c NetManage 127.0.0.1 sysStatus
+}}}
+
+==== php ====
+
+In both '''/etc/php/7.0/apache2/php.ini''' and '''/etc/php/7.0/cli/php.ini''', ensure '''date.timezone''' is set to your preferred time zone.
+
+See <http://php.net/manual/en/timezones.php> or files under ''/usr/share/zoneinfo'' for a list of supported timezones. For this workshop we are all going to use the same timezone.
+
+In the two archives noted above find the line that reads:
+{{{
+;date.timezone =
+}}}
+and change it to:
+{{{
+date.timezone = Asia/Colombo
+}}}
+Save and exit from the files.
+
+ 
+==== Adding the LibreNMS user ====
+
+We need to create a LibreNMS system user, librenms
+
+# useradd librenms -d /opt/librenms -M -r
+# usermod -a -G librenms www-data
+
+ 
+==== Cloning the LibreNMS source code with git ====
+
+LibreNMS is installed using git. If you're not familiar with git, check out the git book or the tips at git ready. The initial install from github.com is called a ''git clone''; subsequent updates are done through ''git pull''.
+
+The initial clone can take quite a while (nearly 3 minutes on a 10Mbps connection is typical) as the size of the software repository is 220+ MB in size.
+
+Run the following:
+{{{
+# cd /opt
+# git clone https://github.com/librenms/librenms.git librenms
+}}}
+At this point, you should have a ''librenms'' directory, with the most recent revision checked out.
+
+
+==== Web Interface ====
+
+To prepare the web interface (and adding devices shortly), you'll need to create and change the ownership of a directory as well as create an Apache Virtul Host definition.
+
+First, create and chown the ''rrd'' directory and create the ''logs'' directory:
+{{{
+# cd /opt/librenms
+# mkdir rrd logs
+# chown -R librenms:librenms /opt/librenms
+# chmod 775 rrd
+# chown www-data /opt/librenms
+}}}
+Next, create '''/etc/apache2/sites-available/librenms.conf''':
+{{{
+ # vi /etc/apache2/sites-available/librenms.conf
+}}}
+Add the following lines:
+{{{
+<VirtualHost *:80>
+  DocumentRoot /opt/librenms/html/
+  ServerName librenms."your domain".ws.ac.lk
+  CustomLog /opt/librenms/logs/access_log combined
+  ErrorLog /opt/librenms/logs/error_log
+  AllowEncodedSlashes NoDecode
+  <Directory "/opt/librenms/html/">
+    Require all granted
+    AllowOverride All
+    Options FollowSymLinks MultiViews
+  </Directory>
+</VirtualHost>
+}}}
+
+Now enable the Virtual Host, but wait to restart Apache
+{{{
+# a2ensite librenms.conf
+# a2enmod rewrite
+# service apache2 restart
+}}}
+