mirror/librenms-librenms
1
0
Fork 0
mirror of https://github.com/librenms/librenms.git synced 2024-10-07 16:52:45 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs: Install Docs Update for min PHP ver (#7630)

Browse Source 
* docs: Install Docs Update

* Some changes..
This commit is contained in:
Søren Rosiak
2017-11-15 09:12:14 +01:00
committed by Neil Lathwood
parent ac6341671d
commit ec2256c350
9 changed files with 32 additions and 76 deletions
Download Patch File Download Diff File Expand all files Collapse all files

64
doc/Installation/Installation-CentOS-6-Apache-Nginx.md
View File

@@ -1,7 +1,7 @@
source: Installation/Installation-CentOS-6-Apache-Nginx.md
NOTE: What follows is a very rough list of commands. This works on a fresh install of CentOS 6.x.
> NOTE: 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 become a user with root privileges with `sudo -s` or `sudo -i`.
NOTE: These instructions assume you are the root user. If you are not, prepend `sudo` to all shell commands (the ones that aren't at `mysql>` prompts) or temporarily become a user with root privileges with `sudo -s`.
**Please note the minimum supported PHP version is 5.6.4**
### On the DB Server ###
@@ -9,7 +9,6 @@ This host is where the MySQL database runs. It could be the same machine as you
> ** Whilst we are working on ensuring LibreNMS is compatible with MySQL strict mode, for now, please disable this after mysql is installed.
**CentOS 6**:
You are free to choose between using MySQL or MariaDB:
**MySQL**
@@ -26,19 +25,8 @@ chkconfig mariadb on
service mariadb start
```
**CentOS 7**
(NOTE: In CentOS 7 there is only mariadb in official repo)
**MariaDB**
```bash
yum install net-snmp mariadb-server mariadb-client
systemctl enable mariadb
systemctl start mariadb
```
Now continue with the installation:
**CentOS 6**
```bash
chkconfig snmpd on
service snmpd start
@@ -46,14 +34,6 @@ mysql_secure_installation
mysql -uroot -p
```
**CentOS 7**
```bash
systemctl enable snmpd
systemctl start snmpd
mysql_secure_installation
mysql -uroot -p
```
Enter the MySQL/MariaDB root password to enter the command-line interface.
Create database.
@@ -93,11 +73,10 @@ or
### On the NMS ###
Install necessary software. The packages listed below are an all-inclusive list of packages that were necessary on a clean install of CentOS 6.4 or 7. It also requires the EPEL repository. Net_IPv6 is required even if your network environment does not support IPv6.
Install necessary software. The packages listed below are an all-inclusive list of packages that were necessary on a clean install of CentOS 6.x. It also requires the EPEL repository. Net_IPv6 is required even if your network environment does not support IPv6.
Note if not using HTTPd (Apache): RHEL requires `httpd` to be installed regardless of of `nginx`'s (or any other web-server's) presence.
**CentOS 6**
```bash
yum install epel-release
yum install php php-cli php-gd php-mysql php-snmp php-pear php-curl httpd net-snmp graphviz graphviz-php mysql ImageMagick jwhois nmap mtr rrdtool MySQL-python net-snmp-utils vixie-cron php-mcrypt fping git
@@ -105,19 +84,12 @@ Note if not using HTTPd (Apache): RHEL requires `httpd` to be installed regardle
pear install Net_IPv6-1.2.2b2
```
**CentOS 7**
```bash
yum install epel-release
yum install php php-cli php-gd php-mysql php-snmp php-pear php-curl httpd net-snmp graphviz graphviz-php mariadb ImageMagick jwhois nmap mtr rrdtool MySQL-python net-snmp-utils cronie php-mcrypt fping git
pear install Net_IPv4-1.3.4
pear install Net_IPv6-1.2.2b2
```
### Configure SNMPD on localhost ###
Edit `/etc/snmp/snmpd.conf` to enable self-polling. An absolute minimal config for snmpd is:
rocommunity public 127.0.0.1
You may either edit the default configuration file to your liking, or backup the default config file and replace it entirely with your own. To apply your changes, run `service snmpd restart` for Centos 6, or `systemctl restart snmpd` for Centos 7 (w/ systemd). If you have deployed a separate database server, you will likely want to configure snmpd on that host as well.
You may either edit the default configuration file to your liking, or backup the default config file and replace it entirely with your own. To apply your changes, run `service snmpd restart` for Centos 6.x. If you have deployed a separate database server, you will likely want to configure snmpd on that host as well.
### Adding the librenms-user for Apache ###
@@ -136,16 +108,10 @@ You may either edit the default configuration file to your liking, or backup the
Set `httpd` to start on system boot.
**CentOS 6: **
```bash
chkconfig --levels 235 httpd on
```
**CentOS 7 (with Systemd): **
```bash
systemctl enable httpd
```
In `/etc/php.ini`, ensure `date.timezone` is set to your preferred time zone. See http://php.net/manual/en/timezones.php for a list of supported timezones. Valid
examples are: "America/New York", "Australia/Brisbane", "Etc/UTC".
Please also ensure that `allow_url_fopen` is enabled. Other functions needed for LibreNMS include `exec,passthru,shell_exec,escapeshellarg,escapeshellcmd,proc_close,proc_open,popen`.
@@ -168,7 +134,7 @@ If you are running Apache below version 2.2.18:
```
If you are running Apache 2.2.18 or higher (current version in Centos 7 official repo):
If you are running Apache 2.2.18 or higher:
```apache
<VirtualHost *:80>
DocumentRoot /opt/librenms/html/
@@ -192,20 +158,12 @@ rn /etc/httpd/conf.d/welcome.conf /etc/httpd/conf.d/welcome.conf.bak
If you choose to run Nginx, you will need to install necessary extra software and let it start on system boot.
**CentOS 6**
```bash
yum install nginx php-fpm
chkconfig nginx on
chkconfig php-fpm on
```
**CentOS 7**
```bash
yum install nginx php-fpm
systemctl enable nginx
systemctl enable php-fpm
```
Modify permissions and configuration for `php-fpm` to use nginx credentials.
mkdir /var/lib/php/session
@@ -268,7 +226,7 @@ First, create and chown the `rrd` directory and create the `logs` directory
If you're planing on running rrdcached, make sure that the path is also chmod'ed to 775 and chown'ed to librenms:librenms.
**SELinux**
> if you're using SELinux (in Centos 7 this is the defualt) you need to allow web server user to write into logs directory.
> if you're using SELinux you need to allow web server user to write into logs directory.
> semanage tool is a part of policycoreutils-python, so if don't have it, you can install it
> **Please note that running LibreNMS with SELinux is still experimental and we cannot guarantee that everything will be working fine for now.**
@@ -289,22 +247,12 @@ Set selinux to allow httpd to sendmail
### Start the web-server: ###
**CentOS 6**
# For HTTPd (Apache):
service httpd restart
# For Nginx:
service nginx restart
**CentOS 7**
# For HTTPd (Apache):
systemctl restart httpd
# For Nginx:
systemctl restart nginx
### Web Installer ###
At this stage you can launch the web installer by going to `http://IP/install.php` and follow the on-screen instructions. Alternatively if you want to continue the setup manually then perform the manual install steps. If you cannot reach the installer, stop here and solve that problem before proceeding. Afterwards, Add the following line to the end of `config.php`:

8
doc/Installation/Installation-CentOS-7-Apache.md
View File

@@ -1,10 +1,12 @@
source: Installation/Installation-CentOS-7-Apache.md
> NOTE: 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 become a user with root privileges with `sudo -s` or `sudo -i`.
**Please note the minimum supported PHP version is 5.6.4**
## Install Required Packages ##
yum install epel-release
rpm -Uvh https://mirror.webtatic.com/yum/el7/webtatic-release.rpm
yum install cronie fping git httpd ImageMagick jwhois mariadb mariadb-server mtr MySQL-python net-snmp net-snmp-utils nmap php71w php71w-cli php71w-common php71w-curl php71w-gd php71w-mcrypt php71w-mysql php71w-process php71w-snmp php71w-xml php71w-zip python-memcached rrdtool
@@ -88,7 +90,7 @@ Add the following config, edit `ServerName` as required:
Install the policy tool for SELinux:
yum install policycoreutils-python
Configure the contexts needed by LibreNMS:
semanage fcontext -a -t httpd_sys_content_t '/opt/librenms/logs(/.*)?'
@@ -171,4 +173,4 @@ Now that you've installed LibreNMS, we'd suggest that you have a read of a few o
We hope you enjoy using LibreNMS. If you do, it would be great if you would consider opting into the stats system we have, please see [this page](http://docs.librenms.org/General/Callback-Stats-and-Privacy/) on what it is and how to enable it.
If you would like to help make LibreNMS better there are [many ways to help](http://docs.librenms.org/Support/FAQ/#what-can-i-do-to-help). You can also [back LibreNMS on Open Collective](https://t.libren.ms/donations).
If you would like to help make LibreNMS better there are [many ways to help](http://docs.librenms.org/Support/FAQ/#what-can-i-do-to-help). You can also [back LibreNMS on Open Collective](https://t.libren.ms/donations).

4
doc/Installation/Installation-CentOS-7-Nginx.md
View File

@@ -1,6 +1,8 @@
source: Installation/Installation-CentOS-7-Nginx.md
> NOTE: 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 become a user with root privileges with `sudo -s` or `sudo -i`.
**Please note the minimum supported PHP version is 5.6.4**
## Install Required Packages ##
yum install epel-release
@@ -206,4 +208,4 @@ Now that you've installed LibreNMS, we'd suggest that you have a read of a few o
We hope you enjoy using LibreNMS. If you do, it would be great if you would consider opting into the stats system we have, please see [this page](http://docs.librenms.org/General/Callback-Stats-and-Privacy/) on what it is and how to enable it.
If you would like to help make LibreNMS better there are [many ways to help](http://docs.librenms.org/Support/FAQ/#what-can-i-do-to-help). You can also [back LibreNMS on Open Collective](https://t.libren.ms/donations).
If you would like to help make LibreNMS better there are [many ways to help](http://docs.librenms.org/Support/FAQ/#what-can-i-do-to-help). You can also [back LibreNMS on Open Collective](https://t.libren.ms/donations).

5
doc/Installation/Installation-Ubuntu-1404-Apache.md
View File

@@ -1,8 +1,7 @@
source: Installation/Installation-Ubuntu-1404-Apache.md
> NOTE: 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 become a user with root privileges with `sudo -s` or `sudo -i`.
> NOTE: These instructions have been tested on a fresh install of Ubuntu 12.04 and 14.04.
> NOTE: 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 become a user with root privileges with `sudo -s` or `sudo -i`.
**Please note the minimum supported PHP version is 5.6.4**
### On the DB Server ###

4
doc/Installation/Installation-Ubuntu-1404-Lighttpd.md
View File

@@ -1,7 +1,7 @@
source: Installation/Installation-Ubuntu-1404-Lighttpd.md
> NOTE: What follows is a very rough list of commands. I have taken the INSTALL.md and modified it for Lighttpd on Debian 7
> NOTE: 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 become a user with root privileges with `sudo -s` or `sudo -i`.
> NOTE: These instructions assume you are the root user. If you are not, prepend `sudo` to all shell commands (the ones that aren't at `mysql>` prompts) or temporarily become a user with root privileges with `sudo -s`.
**Please note the minimum supported PHP version is 5.6.4**
### On the DB Server ###

5
doc/Installation/Installation-Ubuntu-1404-Nginx.md
View File

@@ -1,8 +1,7 @@
source: Installation/Installation-Ubuntu-1404-Nginx.md
> NOTE: 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 become a user with root privileges with `sudo -s` or `sudo -i`.
> NOTE: These instructions have been tested on a fresh install of Ubuntu 12.04 and 14.04.
> NOTE: 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 become a user with root privileges with `sudo -s` or `sudo -i`.
**Please note the minimum supported PHP version is 5.6.4**
### On the DB Server ###

6
doc/Installation/Installation-Ubuntu-1604-Apache.md
View File

@@ -1,10 +1,12 @@
source: Installation/Installation-Ubuntu-1604-Apache.md
> NOTE: 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 become a user with root privileges with `sudo -s` or `sudo -i`.
**Please note the minimum supported PHP version is 5.6.4**
## Install Required Packages ##
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
#### Add librenms user
useradd librenms -d /opt/librenms -M -r
@@ -148,4 +150,4 @@ Now that you've installed LibreNMS, we'd suggest that you have a read of a few o
We hope you enjoy using LibreNMS. If you do, it would be great if you would consider opting into the stats system we have, please see [this page](http://docs.librenms.org/General/Callback-Stats-and-Privacy/) on what it is and how to enable it.
If you would like to help make LibreNMS better there are [many ways to help](http://docs.librenms.org/Support/FAQ/#what-can-i-do-to-help). You can also [back LibreNMS on Open Collective](https://t.libren.ms/donations).
If you would like to help make LibreNMS better there are [many ways to help](http://docs.librenms.org/Support/FAQ/#what-can-i-do-to-help). You can also [back LibreNMS on Open Collective](https://t.libren.ms/donations).

4
doc/Installation/Installation-Ubuntu-1604-Nginx.md
View File

@@ -1,6 +1,8 @@
source: Installation/Installation-Ubuntu-1604-Nginx.md
> NOTE: 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 become a user with root privileges with `sudo -s` or `sudo -i`.
**Please note the minimum supported PHP version is 5.6.4**
## Install Required Packages ##
apt install composer fping git graphviz imagemagick mariadb-client mariadb-server mtr-tiny nginx-full nmap php7.0-cli php7.0-curl php7.0-fpm php7.0-gd php7.0-mcrypt php7.0-mysql php7.0-snmp php7.0-xml php7.0-zip python-memcache python-mysqldb rrdtool snmp snmpd whois
@@ -154,4 +156,4 @@ Now that you've installed LibreNMS, we'd suggest that you have a read of a few o
We hope you enjoy using LibreNMS. If you do, it would be great if you would consider opting into the stats system we have, please see [this page](http://docs.librenms.org/General/Callback-Stats-and-Privacy/) on what it is and how to enable it.
If you would like to help make LibreNMS better there are [many ways to help](http://docs.librenms.org/Support/FAQ/#what-can-i-do-to-help). You can also [back LibreNMS on Open Collective](https://t.libren.ms/donations).
If you would like to help make LibreNMS better there are [many ways to help](http://docs.librenms.org/Support/FAQ/#what-can-i-do-to-help). You can also [back LibreNMS on Open Collective](https://t.libren.ms/donations).

8
doc/Installation/Installing-LibreNMS.md
View File

@@ -1,15 +1,17 @@
source: Installation/Installing-LibreNMS.md
# Installing LibreNMS
We have some pre-built VirtualBox images you can use to get started:
##Images
We have some pre-built VirtualBox images you can use to get started. Please note that these images are pre-built for VirtualBox, hence they might not work with other hypervisors without converting them:
[Ubuntu 16.04](http://docs.librenms.org/Installation/Ubuntu-image/)
[CentOS 7](http://docs.librenms.org/Installation/CentOS-image/)
If you want to install yourself then we have some new documentation which should make it easy.
##Manually
If you want to install manually then we have some documentation which should make it easy.
> Please note the following docs are new and may not be 100% complete, please provide feedback on your experience.
**Please note the minimum supported PHP version is 5.6.4**
[Ubuntu 16.04 Apache](http://docs.librenms.org/Installation/Installation-Ubuntu-1604-Apache/)