{"id":1659,"date":"2017-10-12T00:10:02","date_gmt":"2017-10-12T00:10:02","guid":{"rendered":"http:\/\/www.incredigeek.com\/home\/?p=1659"},"modified":"2017-10-12T00:49:31","modified_gmt":"2017-10-12T00:49:31","slug":"install-librenms-on-ubuntu-with-https","status":"publish","type":"post","link":"https:\/\/www.incredigeek.com\/home\/install-librenms-on-ubuntu-with-https\/","title":{"rendered":"Install LibreNMS on Ubuntu with HTTPS"},"content":{"rendered":"

The goal of this guide is to install LibreNMS on an Ubuntu Server with a self signed certificate.\u00a0 Most of the steps are copied out of the LibreNMS Documentation found here<\/a>.<\/p>\n

Install required packages<\/strong><\/p>\n

sudo apt install apache2 composer fping git graphviz imagemagick libapache2-mod-php7.0 mariadb-client mariadb-server mtr-tiny nmap php7.0-cli php7.0-curl php7.0-gd php7.0-json php7.0-mcrypt php7.0-mysql php7.0-snmp php7.0-xml php7.0-zip python-memcache python-mysqldb rrdtool snmp snmpd whois<\/pre>\n
Create LibreNMS user<\/strong><\/p>\n
sudo useradd librenms -d \/opt\/librenms -M -r\r\nsudo usermod -a -G librenms www-data<\/pre>\n
Install LibreNMS<\/strong><\/p>\n
cd \/opt\r\nsudo git clone https:\/\/github.com\/librenms\/librenms.git librenms<\/pre>\n
Configure MySQL<\/strong><\/p>\n
sudo systemctl restart mysql\r\nsudo mysql -uroot -p<\/pre>\n
Run the following MySQL commands to create the LibreNMS user. Change password to your own password.<\/p>\n
CREATE DATABASE librenms CHARACTER SET utf8 COLLATE utf8_unicode_ci;\r\nCREATE USER 'librenms'@'localhost' IDENTIFIED BY 'password';\r\nGRANT ALL PRIVILEGES ON librenms.* TO 'librenms'@'localhost';\r\nFLUSH PRIVILEGES;\r\nexit<\/pre>\n
Edit following file<\/p>\n
sudo vi \/etc\/mysql\/mariadb.conf.d\/50-server.cnf<\/pre>\n
Add the following inside the [mysqld] section<\/p>\n
innodb_file_per_table=1\r\nsql-mode=\"\"\r\nlower_case_table_names=0<\/pre>\n
Restart MySQL<\/p>\n
sudo systemctl restart mysql<\/pre>\n
Configure PHP<\/strong><\/p>\n
Edit the two files and set the time zone, date.timezone.\u00a0 Example “America\/New_York”<\/p>\n
sudo vi \/etc\/php\/7.0\/apache2\/php.ini\r\nsudo vi \/etc\/php\/7.0\/cli\/php.ini<\/pre>\n
Then run these commands<\/p>\n
sudo a2enmod php7.0\r\nsudo a2dismod mpm_event\r\nsudo a2enmod mpm_prefork\r\nsudo phpenmod mcrypt<\/pre>\n
Generate Self signed certificate<\/strong><\/p>\n
Enable ssl in apache<\/p>\n
sudo a2enmod ssl<\/code><\/pre>\n
Generate Cert<\/p>\n
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout \/etc\/ssl\/private\/localhost.key<\/span> -out \/etc\/ssl\/certs\/localhost.crt<\/span><\/pre>\n
Configure Apache<\/strong><\/p>\n
Edit the following config file<\/p>\n
sudo vi \/etc\/apache2\/sites-available\/librenms.conf<\/pre>\n
Add the following<\/p>\n
<VirtualHost *:443>\r\n DocumentRoot \/opt\/librenms\/html\/\r\n ServerName librenms.example.com\r\n SSLEngine on\r\n SSLCertificateFile \/etc\/ssl\/certs\/localhost.crt\r\n SSLCertificateKeyFile \/etc\/ssl\/private\/localhost.key\r\n CustomLog \/opt\/librenms\/logs\/access_log combined\r\n ErrorLog \/opt\/librenms\/logs\/error_log\r\n AllowEncodedSlashes NoDecode\r\n <Directory \"\/opt\/librenms\/html\/\">\r\n Require all granted\r\n AllowOverride All\r\n Options FollowSymLinks MultiViews\r\n <\/Directory>\r\n<\/VirtualHost><\/span><\/pre>\n
Run the following commands<\/p>\n
sudo a2ensite librenms.conf\r\nsudo a2enmod rewrite\r\nsudo systemctl restart apache2<\/pre>\n
Configure snmpd<\/p>\n
sudo cp \/opt\/librenms\/snmpd.conf.example \/etc\/snmp\/snmpd.conf<\/pre>\n
Set the SNMP community string in the following file<\/p>\n
sudo vi \/etc\/snmp\/snmpd.conf<\/pre>\n
Then run these commands<\/p>\n
sudo curl -o \/usr\/bin\/distro https:\/\/raw.githubusercontent.com\/librenms\/librenms-agent\/master\/snmp\/distro\r\nsudo chmod +x \/usr\/bin\/distro\r\nsudo systemctl restart snmpd<\/pre>\n
Setup Crontab<\/strong><\/p>\n
sudo cp \/opt\/librenms\/librenms.nonroot.cron \/etc\/cron.d\/librenms<\/pre>\n
Copy logrotate config<\/strong><\/p>\n
sudo cp \/opt\/librenms\/misc\/librenms.logrotate \/etc\/logrotate.d\/librenms<\/pre>\n
Set permissions<\/strong><\/p>\n
mkdir -p \/opt\/librenms\/rrd \/opt\/librenms\/logs\r\nsudo chown -R librenms:librenms \/opt\/librenms\r\nsudo setfacl -d -m g::rwx \/opt\/librenms\/rrd \/opt\/librenms\/logs\r\nsudo setfacl -R -m g::rwx \/opt\/librenms\/rrd \/opt\/librenms\/logs<\/pre>\n
Web Installer<\/strong><\/p>\n
Restart apache<\/p>\n
sudo systemctl restart apache2<\/pre>\n
Finish the install by going to<\/p>\n
https:\/\/your-server\/install.php<\/pre>\n
Change “your-server” to your server’s ip address, or hostname.\u00a0 Since we created a self signed certificate, you’ll need to accept the https error.<\/p>\n
Validate<\/strong><\/p>\n
Back on the command line run the php validation script<\/p>\n
sudo \/opt\/librenms\/validate.php<\/pre>\n
Finally log into your new LibreNMS instance by going to <\/p>\n
https:\/\/your-server<\/pre>\n
Change “your-server” to your server’s IP address or hostname.<\/p>\n","protected":false},"excerpt":{"rendered":"
The goal of this guide is to install LibreNMS on an Ubuntu Server with a self signed certificate.\u00a0 Most of the steps are copied out of the LibreNMS Documentation found here. Install required packages sudo apt install apache2 composer fping … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[352,3,28],"tags":[357,353,7,134,356,49],"class_list":["post-1659","post","type-post","status-publish","format-standard","hentry","category-librenms","category-linux","category-ubuntu","tag-https","tag-librenms","tag-linux-2","tag-monitoring","tag-ssl","tag-ubuntu-2"],"_links":{"self":[{"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/posts\/1659","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/comments?post=1659"}],"version-history":[{"count":11,"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/posts\/1659\/revisions"}],"predecessor-version":[{"id":1671,"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/posts\/1659\/revisions\/1671"}],"wp:attachment":[{"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/media?parent=1659"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/categories?post=1659"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/tags?post=1659"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}