Difference between revisions of "Pandora: Documentation en: Installing"

From Pandora FMS Wiki
Jump to: navigation, search
(Unattended Windows Agent Installation)
(Package installation for CentOS 8)
 
(105 intermediate revisions by 10 users not shown)
Line 40: Line 40:
 
</table>
 
</table>
  
(*) In addition to the above recommendations, we recommend installing MySQL on a standalone server and installing Percona XTraDB instead of standard MySQL.
+
(*) In addition to the these recommendations, we recommend installing MySQL on a standalone server and installing Percona XTraDB instead of standard MySQL.
  
  
 
<br>
 
<br>
{{Warning|In case you install Pandora FMS in a virtual environment, be sure to assign an independent disk with reserved space and a high access speed. }}
+
{{Warning|In case you install Pandora FMS in a virtual environment, make sure to assign an independent disk with reserved space and high access speed. }}
  
 
{{Tip|We strongly recommend the use of ''SSD'' disks, due to the high impact they have on performance improvement.}}
 
{{Tip|We strongly recommend the use of ''SSD'' disks, due to the high impact they have on performance improvement.}}
  
{{Tip|A 25GB disk is recommended, with a minimum of 15GB. If you are going to use functionalities such as log storage or want to save information more than one month old, you should use the ''history database''.}}
+
{{Tip|A 25GB disk is recommended, with a minimum of 15GB. If features such as log storage are going to be used, or information more than one month old is going to be saved, ''history database'' should be used.}}
  
 
== Minimum software requirements ==
 
== Minimum software requirements ==
Line 79: Line 79:
 
* '''Server'''
 
* '''Server'''
  
- Linux: Pandora FMS Server service must be executed as root permissions. It is possible the execution as non-root user, being a special and different procedure, more information in this link.
+
- Linux: Pandora FMS Server service must be executed as root permission. Execution as non-root user is possible, being a special and different procedure. Find out more information in this link.
  
-Windows: Pandora FMS Server service must be executed as administrator permissions.
+
-Windows: Pandora FMS Server service must be executed as administrator permission.
  
 
* '''Console'''
 
* '''Console'''
Line 93: Line 93:
 
* '''Agent'''
 
* '''Agent'''
  
-Linux: The Pandora FMS Server Software Agent must be executed as root permissions in order to have all the agent functionalities, although it is also possible to execute it with other permissions..
+
-Linux: The Pandora FMS Server Software Agent must be executed as root permission in order to have all the agent features available, although it is also possible to execute it with other permissions..
  
-Windows: Pandora FMS Server Software Agent must be executed as administrator permissions.
+
-Windows: Pandora FMS Server Software Agent must be executed as administrator permission.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 120: Line 120:
 
</tr>
 
</tr>
 
</table>
 
</table>
There are Pandora FMS server functionalities that are not supported for Windows. To learn more about these functionalities visit the following [[Pandora:Documentation_en:Installing#Server_and_Console_Installation_in_Windows| link.]]
+
Some Pandora FMS server features are not supported for Windows. To learn more about these features, click on the following [[Pandora:Documentation_en:Installing#Server_and_Console_Installation_in_Windows| link.]]
  
 
== Database requisites ==
 
== Database requisites ==
Line 127: Line 127:
 
<tr>
 
<tr>
 
<th style=' border-color: #000000; text-align:middle; background-color: #7CA12A; color:#FFFFFF'>BBDD</th>
 
<th style=' border-color: #000000; text-align:middle; background-color: #7CA12A; color:#FFFFFF'>BBDD</th>
<th style=' border-color: #000000; text-align:center; background-color: #7CA12A; color:#FFFFFF'>Detalles</th>
+
<th style=' border-color: #000000; text-align:center; background-color: #7CA12A; color:#FFFFFF'>Details</th>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
Line 133: Line 133:
 
<td>
 
<td>
 
* Version 5.5
 
* Version 5.5
* For the standard installation, a user with creation privileges in the pandora DB is required. In case of not having this user, a manual installation can be done.
+
* For standard installation, a user with creating privileges in the pandora DB is required. In case of not having this user, a manual installation can be performed.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 139: Line 139:
 
<th style=' border-color: #000000; text-align:middle; background-color: #7CA12A; color:#FFFFFF'>Percona XTraDB</th>
 
<th style=' border-color: #000000; text-align:middle; background-color: #7CA12A; color:#FFFFFF'>Percona XTraDB</th>
 
<td>
 
<td>
Percona XTraDB installation is recommended for large Pandora FMS environments where more than 4000 agents will be created.
+
Percona XTraDB installation is recommended for large Pandora FMS environments where more than 4000 agents must be created.
  
 
* Version 5.5
 
* Version 5.5
* For the standard installation, a user with creation privileges in the pandora DB is required. In case of not having this user it will be possible to make a manual installation.
+
* For standard installation, a user with creating privileges in the pandora DB is required. In case of not having this user, it will be possible to carry out manual installation.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 148: Line 148:
  
  
{{Warning|You will need to have all this BEFORE you start installing Pandora FMS. If you don't know how to install a MySQL server, look for documentation about the whole process. We can't provide all that documentation since it varies in each system, distribution and/or version.}}
+
{{Warning|All of this is needed BEFORE you start installing Pandora FMS. If you do not know how to install MySQL server, look for documentation about the whole process. We cannot provide all that documentation since it is different in each system, distribution and/or version.}}
  
 
== Satellite Server Requirements==
 
== Satellite Server Requirements==
Line 159: Line 159:
 
<th style=' border-color: #000000; text-align:middle; background-color: #7CA12A; color:#FFFFFF'>Hardware</th>
 
<th style=' border-color: #000000; text-align:middle; background-color: #7CA12A; color:#FFFFFF'>Hardware</th>
 
<td>
 
<td>
As it happens with Pandora FMS installation, the hardware requirements of the system that will host the satellite server will depend on the monitoring volume that it will have to do.
+
Similarly to Pandora FMS installation, the hardware requirements of the system that will host the satellite server will depend on the monitoring volume to be managed.
For environments with less than 1000 agents, we recommend a minimum of 1 core at 2GHz and 1 GB of RAM.
+
For environments with less than 1000 agents, a minimum of 1 core at 2GHz and 1 GB of RAM is recommended.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 205: Line 205:
 
<td> TCP </td>
 
<td> TCP </td>
 
<td> Pandora FMS Console (API Communication) </td>
 
<td> Pandora FMS Console (API Communication) </td>
<td> Use of API/CLI functionality </td>
+
<td> Use of API/CLI feature </td>
 
<td> Browser/Server that starts the query -> Pandora FMS Console Server</td>
 
<td> Browser/Server that starts the query -> Pandora FMS Console Server</td>
 
</tr>
 
</tr>
Line 221: Line 221:
 
<td> UDP </td>
 
<td> UDP </td>
 
<td> Pandora FMS Server </td>
 
<td> Pandora FMS Server </td>
<td> Traps reception </td>
+
<td> Trap reception </td>
 
<td> Trap generator device -> Pandora FMS Server </td>
 
<td> Trap generator device -> Pandora FMS Server </td>
 
</tr>
 
</tr>
Line 228: Line 228:
 
<td> TCP </td>
 
<td> TCP </td>
 
<td> Pandora FMS Console (API Communication)</td>
 
<td> Pandora FMS Console (API Communication)</td>
<td> Use of API/CLI functionality </td>
+
<td> Use of API/CLI feature </td>
 
<td> Browser/Server that starts the query -> Pandora FMS Console Server </td>
 
<td> Browser/Server that starts the query -> Pandora FMS Console Server </td>
 
</tr>
 
</tr>
Line 262: Line 262:
 
<td> TCP </td>
 
<td> TCP </td>
 
<td> Pandora FMS Server </td>
 
<td> Pandora FMS Server </td>
<td> Conection with Selenium GRID </td>
+
<td> Connection with Selenium GRID </td>
 
<td> Pandora FMS Server -> Selenium Server </td>
 
<td> Pandora FMS Server -> Selenium Server </td>
 
</tr>
 
</tr>
Line 284: Line 284:
 
<td> Pandora FMS Agents </td>
 
<td> Pandora FMS Agents </td>
 
<td> Tentacle Communication </td>
 
<td> Tentacle Communication </td>
<td> Agente Software Agent Server -> Pandora FMS Server </td>
+
<td> Software Agent Server Agent -> Pandora FMS Server </td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<th colspan= 5 style=' border-color: #000000; text-align:center; background-color: #7CA12A; color:#FFFFFF'> It is recommended to facilitate the communication from the Pandora FMS server and console to the whole network. For standard monitoring you would need as minimum:</th>
+
<th colspan= 5 style=' border-color: #000000; text-align:center; background-color: #7CA12A; color:#FFFFFF'> It is recommended to facilitate communication from Pandora FMS server and console to the whole network. For standard monitoring you should need minimum:</th>
 
<tr>
 
<tr>
 
<th style=' border-color: #000000; text-align:middle; background-color: #7CA12A; color:#FFFFFF'>80 </th>
 
<th style=' border-color: #000000; text-align:middle; background-color: #7CA12A; color:#FFFFFF'>80 </th>
Line 306: Line 306:
 
<td> TCP </td>
 
<td> TCP </td>
 
<td> Pandora FMS Server </td>
 
<td> Pandora FMS Server </td>
<td> Monitorización web para servidor WUX </td>
+
<td> Web monitoring for WUX server </td>
 
<td> Pandora FMS Server -> Server to monitor </td>
 
<td> Pandora FMS Server -> Server to monitor </td>
 
</tr>
 
</tr>
Line 312: Line 312:
 
<th style=' border-color: #000000; text-align:middle; background-color: #7CA12A; color:#FFFFFF'>ICMP </th>
 
<th style=' border-color: #000000; text-align:middle; background-color: #7CA12A; color:#FFFFFF'>ICMP </th>
 
<td> ICMP </td>
 
<td> ICMP </td>
<td> Consola y Pandora FMS Server </td>
+
<td> Console and Pandora FMS Server </td>
 
<td> Web monitoring for WUX server </td>
 
<td> Web monitoring for WUX server </td>
 
<td> Pandora FMS Server -> Server to monitor </td>
 
<td> Pandora FMS Server -> Server to monitor </td>
Line 320: Line 320:
 
== Package Dependencies ==
 
== Package Dependencies ==
  
Pandora FMS has a strong dependency on the GNU/Linux Operating System, but it also needs additional packages which,  in many cases, aren't installed by default. During the installation process, there is a detailed list of package dependencies for Debian, Ubuntu and OpenSUSE.
+
Pandora FMS has a strong dependency on the GNU/Linux Operating System, but it also needs additional packages which,  in many cases, are not installed by default. During the installation process, there is a detailed list of package dependencies for Debian, Ubuntu and OpenSUSE.
  
 
== Issues prior to Installation ==
 
== Issues prior to Installation ==
Line 326: Line 326:
 
=== MySQL ===
 
=== MySQL ===
  
You will need to have a MySQL Server installed BEFORE configuring Pandora FMS, since the next step after installing the Pandora packages, is to configure access to the databases. To do that, it must be operational. If you are installing the MySQL Server at the same time as Pandora FMS, remember that you need to set up the root user for MySQL. This is easily done in two steps:
+
You will need to have MySQL Server installed BEFORE configuring Pandora FMS, since the next step after installing Pandora FMS packages, is to configure access to the databases. To do that, it must be operational. If you are installing the MySQL Server at the same time as Pandora FMS, remember that you need to set up the root user for MySQL. This can be easily done in two steps:
  
1. Please start the MySQL Server daemon:
+
1. Start MySQL Server daemon:
  
 
  /etc/init.d/mysql start
 
  /etc/init.d/mysql start
  
2. Configure the root password for the MySQL root user:
+
2. Configure the root password for MySQL root user:
  
 
  mysqladmin password <password>
 
  mysqladmin password <password>
  
In ''<password>'', you have to type the password for the MySQL root user (which is different from the systems 'root' user). The system is going to ask for this password throughout the entire Pandora FMS installation process.
+
In ''<password>'', type in the password for MySQL root user (which is different from the system's 'root' user). The system will ask for this password throughout the entire Pandora FMS installation process.
  
 
=== Pandora FMS Installation Order ===
 
=== Pandora FMS Installation Order ===
  
You're required to follow this sequence in order to install Pandora FMS properly:
+
You are required to follow this sequence in order to install Pandora FMS properly:
  
 
# Install console
 
# Install console
 
# Install server
 
# Install server
  
The reason for this is the MySQL database is configured during the initial configuration phase of the console installation. To ensure the correct working of the server, it's recommended to conduct the whole console's installation process first.
+
The reason for this is that MySQL database is configured during the initial configuration phase of the console installation. To ensure the correct working of the server, it is recommended to conduct the whole console installation process first.
  
The Pandora FMS Server and console are also possible to be hosted on different machines, because you can configure the server to utilize a remote MySQL database by means of the server's configuration file.
+
It is also possible to host Pandora FMS Server and console in different machines, because the server can be configured to use a remote MySQL database by means of the server configuration file.
  
Regarding the agent: You may install it before or after installing the server and console, because the agent works independently and is capable of being installed on any machine.
+
Regarding the agent: You may install it before or after installing the server and console, because the agent works independently and it may be installed on any machine.
  
 
=== Installing the Enterprise Version ===  
 
=== Installing the Enterprise Version ===  
The proper order for an Enterprise installation is as follows:
+
The correct order for an Enterprise installation is as follows:
  
 
* Install the open-source console.
 
* Install the open-source console.
Line 358: Line 358:
 
* When accessing the console, a box will appear requiring you to enter your Enterprise license code.
 
* When accessing the console, a box will appear requiring you to enter your Enterprise license code.
  
Validation of the license is only done in the console. Not on the server.
+
Validation of the license is only done in the console. Not in the server.
  
We can find details on how to correctly enter the license in the following section: [[Pandora:Documentation en:Installing#License_Application | '''License Application v5.X''']] window opens.
+
Details on how to correctly enter the license can be found in the following section: [[Pandora:Documentation en:Installing#License_Application | '''License Application v5.X''']] window opens.
  
 
==== Special Requirements for the Enterprise Version ====
 
==== Special Requirements for the Enterprise Version ====
Line 368: Line 368:
 
== Installation using ISO or "Software appliance"  ==
 
== Installation using ISO or "Software appliance"  ==
  
This DVD ISO contains a modified CentOS7 system, with Pandora FMS software, all its dependencies, pre-configured and ready to install along with the operating system in a machine (virtual or real). Due to the length of this section, we have established a special screen shot-equipped section. It's called [[Pandora:QuickGuides_EN:General_Quick_Guide#Installing_the_Appliance_CD|'''Appliance CD Installation.''']]
 
  
== Installation under Docker ==
+
Download the CD image from the Download section of our website and burn the ISO image onto a DVD, or run the system from that file if you are using a virtualized system (XenServer, VMware, VirtualBox, etc). There are CD images for both 32- and 64-bit installations.
  
=== Get the latest stable version ===
+
The following screen will be displayed at the beginning of the boot process. If you do not press any key, the process will automatically load the Live CD, or you can press any key, select the "Install Pandora FMS" option and press "enter" to start the installation.
To get the latest stable version:
 
  
    curl -sSL http://pandorafms.org/getpandora  | sh
+
<center>
 +
[[image:install_1.png|400px]]
 +
</center>
  
 +
The graphic installer will lead you step by step throughout the whole installation process. This installer is a standard installation process used by CentOS, and it is available in different languages. It is a very easy process but special attention must be paid when entering the superuser password (root), and when asked about the hard drive partitioning:
  
{{Warning|This command requires Docker Engine installed and running.}}
+
<center>
 +
[[image:install_2.png|500px]]]
 +
<br>
 +
Select the preferred language
 +
</center>
 +
<br>
  
=== Advanced installation ===
+
<center>
 +
[[image:install_3.png|500px]]
 +
</center>
  
Pandora FMS runs as a container under Docker environments. It can be launched as follows:
+
Select and configure all the necessary options to install, “Date & Time”, “Keyboard” and “Installation Destination”.
    docker run -d --name pandorafms pandorafms/pandorafms:7
+
Remember to activate the network interface, or else it will need to activated manually after installation.
  
{{Tip|Docker images are updated on a daily basis}}
+
<center>
 +
[[image:install_4.png|500px]]
 +
[[image:install_5.png|500px]]
 +
<br>
 +
Activate the network interface and optionally change the hostname
 +
</center>
 +
<br>
  
{{Tip|The latest stable version is 7.}}
+
When clicking the installation destination button, the partition process will start.
  
== Installing the VMWare Virtual Machine ==
+
<center>
 
+
[[image:install_6.png|500px]]
Alongside the Centos ISO, you can find a virtual machine which contains an already installed Pandora FMS under 'sourceforge.net'. This image is tested with VMWare ESX, VMWare Workstation, VirtualBox and Hyper-V. To run it under Hyper-V, you're required to export the VMDX and VDH files from the 'MVDC.exe' executable. They are available after you've installed the Microsoft Virtual Machine Converter.
+
<br>
 
+
Select the disk where the installation will be performed and click on done.
To install it, you have to execute the '.ovf' file under 'Virtualbox' and 'VMWare Workstation'. Under ESX and Hyper-V, you're required to import the image under 'Import VM' and select the virtual image there.
+
[[image:install_7.png|500px]]
 +
<br>
 +
</center>
 +
Select the partitioning, unless you have advanced knowledge use the option "Click here to create them automatically".
 +
<center>
 +
<br>
 +
[[image:install_8.png|500px]]
 +
<br>
 +
Verify the created partitions and click on Done.
 +
<br>
 +
[[image:install_9.png|500px]]
 +
<br>
 +
Accept Changes.
 +
<br>
 +
[[image:install_10.png|500px]]
 +
<br>
 +
Click on Begin Installation.
 +
<br>
 +
[[image:install_11.png|500px]]
 +
<br>
 +
Here you can assign the root password and optionally create a user.
  
The credentials for this machine are the following:
+
</center>
  
''User:'' ''' root'''
+
Now just wait until the process is finished and the system restarts automatically.
  
''Password:'' ''' pandora'''
+
== Installing the ISO image using a USB Stick ==
  
''Console User:'' ''' admin'''
 
  
''Password:'' ''' pandora'''
+
To install the Pandora FMS appliance from a USB flash drive, follow these steps:
  
''MySQL user:''''' root'''
+
* Download the Pandora FMS ISO image from the download section.
 +
* Download the program ''rufus'' to prepare your USB for the installation (https://rufus.akeo.ie/)
 +
* Insert the flash drive.
 +
* Start the program ''rufus''.
  
''Password:'' ''' pandora'''
+
<center>
 +
[[image:Usb_installation_1.PNG]]
 +
</center>
  
{{Warning|For security reasons, please change the passwords used during the installation as soon as possible.}}
+
* Select the Pandora FMS ISO image.
  
== Installation under SUSE (OpenSUSE or SLES) ==
+
<center>
 +
[[image:Usb_installation_2.PNG]]
 +
</center>
  
=== Automatized Installation by the Official Repository ===
+
* Press START to start the creation of the Pandora FMS installation USB.
  
To be able to choose this method -the fastest and most convenient-, you have to have access to internet from the server where you are going to install Pandora FMS. All steps must be executed as root (or under sudo).
+
<center>
 +
[[image:Usb_installation_3.PNG]]
 +
</center>
  
'''Step 1:''' Create a repository :
+
<center>
 +
[[image:Usb_installation_4.PNG]]
 +
</center>
 +
 
 +
* Your Pandora FMS installation USB device is ready
  
#'''SLES 12 SP3'''
+
<center>
zypper ar -f http://firefly.artica.es/suse PandoraFMS_Official_Repo
+
[[image:Usb_installation_5.PNG]]
zypper ar -f http://download.opensuse.org/repositories/server:/php:/applications/SLE_12_SP3/
+
</center>
zypper ar -f http://download.opensuse.org/repositories/devel:/languages:/perl/SLE_12_SP3/ Perl
 
  
wget --no-check-certificate https://dev.mysql.com/get/mysql80-community-release-sles12-1.noarch.rpm
 
rpm -i mysql80-community-release-sles12-1.noarch.rpm
 
  
#'''openSUSE (15.0)'''
+
* Connect the USB to the machine where you want to install Pandora FMS.
zypper ar -f http://firefly.artica.es/suse PandoraFMS_Official_Repo
+
* When starting the system, configure the BIOS to start first from USB.
zypper ar -f http://download.opensuse.org/repositories/server:/php:/applications/openSUSE_Leap_15.0/ Php5
 
zypper ar -f http://download.opensuse.org/repositories/devel:/languages:/perl/openSUSE_Leap_15.0/Perl
 
 
wget --no-check-certificate https://dev.mysql.com/get/mysql80-community-release-sl15-1.noarch.rpm
 
rpm -ivh mysql80-community-release-sl15-1.noarch.rpm
 
  
 +
The following screen should be displayed:
  
'''Step 2:''' Update the repository's information:
+
<center>
 +
[[image:Usb_installation_6.PNG]]
 +
</center>
  
zypper refresh
+
Select "Installing from USB stick" and continue the installation as described in the previous chapter.
  
'''Step 3:''' Install Pandora FMS and some of its dependencies :
+
== Package installation for CentOS 8 ==
  
zypper install pandorafms_console pandorafms_server apache2-mod_php5
+
To install Pandora FMS by packages in CentOS 8 it will be necessary first to define the following variables:
  
{{Warning|For versions of Pandora FMS 729 or higher, it will be necessary to update to PHP7 so the console works}}
+
PANDORA_CONSOLE=/var/www/html/pandora_console
 +
CONSOLE_PATH=/var/www/html/pandora_console
 +
PANDORA_SERVER_CONF=/etc/pandora/pandora_server.conf
 +
PANDORA_SERVER_BIN=/usr/bin/pandora_server
 +
PANDORA_HA_BIN=/usr/bin/pandora_ha
 +
PANDORA_TABLES_MIN=160
 +
DBHOST=127.0.0.1
 +
DBNAME=pandora
 +
DBUSER=pandora
 +
DBPASS=pandora
 +
DBPORT=3306
  
=== Manual RPM Installation ===
+
Once the variables are defined and to install the necessary packages, we will first configure <b>dnf</b>, to configure it it will be necessary to execute the following commands.
  
==== Previous Dependencies Installation ====
+
dnf install -y \
 +
    epel-release \
 +
    tar \
 +
    dnf-utils \
 +
    http://rpms.remirepo.net/enterprise/remi-release-8.rpm
  
For this documentation we will make use of the Suse '''Zypper''' system that allows you to resolve dependencies and download packages directly from the repositories on the internet. If you don't have Zypper, install it, it's much more comfortable and fast. If this is not possible, dependencies can be downloaded in. rpm format from the internet, but the process is considerably longer and more laborious.
+
dnf module reset php
 +
dnf module install -y php:remi-7.3
 +
yum config-manager --set-enabled PowerTools
  
The following package dependencies, included in the SUSE system, must be installed:
 
  
  apache2 apache2-mod_php5 php5 php5-gd php5-gettext php5-json php5-mbstring php5-ldap php5-mysql \
+
It will also be necessary to install a database <b>percona</b>.  
  php5-pear php5-snmp php5-zip nmap perl-DBD-mysql perl-DBI perl-Date-Calc perl-HTML-Parser \
+
 
perl-HTML-Encoding perl-HTML-Tree perl-IO-Socket-inet6 perl-Socket6 perl-Mail-Sendmail perl-NetAddr-IP \  
+
 
perl-TimeDate perl-XML-Simple perl-XML-Twig perl-libwww-perl mysql-client mysql-max mysql  \
+
dnf install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
net-snmp xorg-x11-fonts-core php5-pear-db php5-curl php5-xmlrpc perl-SNMP graphviz graphviz-gd \
+
dnf module disable -y mysql
perl-Encode-Locale perl-JSON
+
rm -rf /etc/my.cnf
 +
dnf install -y Percona-Server-server-57
 +
 
 +
 
 +
Once with <b>dnf</b> and <b>percona</b> installed we can start to install all the necessary dependencies for the <b>console</b>:
 +
 
 +
 
 +
  dnf install -y \
 +
    php \
 +
    postfix \
 +
    php-mcrypt \php-cli \
 +
    php-gd \
 +
    php-curl \
 +
    php-session \
 +
    php-mysqlnd \
 +
    php-ldap \
 +
    php-zip \
 +
    php-zlib \
 +
    php-fileinfo \
 +
    php-gettext \
 +
    php-snmp \
 +
    php-mbstring \
 +
    php-pecl-zip \
 +
    php-xmlrpc \
 +
    libxslt \
 +
    wget \
 +
    php-xml \
 +
    httpd \
 +
    mod_php \
 +
    atk \
 +
    avahi-libs \
 +
    cairo \
 +
    cups-libs \
 +
    fribidi \
 +
    gd \
 +
    gdk-pixbuf2 \
 +
    ghostscript \
 +
    graphite2 \
 +
    graphviz \
 +
    gtk2 \
 +
    harfbuzz \
 +
    hicolor-icon-theme \
 +
    hwdata \
 +
    jasper-libs \
 +
    lcms2 \
 +
    libICE \
 +
    libSM \
 +
    libXaw \
 +
    libXcomposite \
 +
    libXcursor \
 +
    libXdamage \
 +
    libXext \
 +
    libXfixes \
 +
    libXft \
 +
    libXi \
 +
    libXinerama \
 +
    libXmu \
 +
    libXrandr \
 +
    libXrender \
 +
    libXt \
 +
    libXxf86vm \
 +
    libcroco \
 +
    libdrm \
 +
    libfontenc \
 +
    libglvnd \
 +
    libglvnd-egl \
 +
    libglvnd-glx \
 +
    libpciaccess \
 +
    librsvg2 \
 +
    libthai \
 +
    libtool-ltdl \
 +
    libwayland-client \
 +
    libwayland-server \
 +
    libxshmfence \
 +
    mesa-libEGL \
 +
    mesa-libGL \
 +
    mesa-libgbm \
 +
    mesa-libglapi \
 +
    pango \
 +
    pixman \
 +
    xorg-x11-fonts-75dpi \
 +
    xorg-x11-fonts-misc \
 +
    poppler-data \
 +
    php-yaml
 +
 
 +
 
 +
With the console dependencies already installed it's time to install the <b>server dependencies</b>:
 +
 
  
 +
dnf install -y http://www6.atomicorp.com/channels/atomic/centos/7/x86_64/RPMS/wmi-1.3.14-4.el7.art.x86_64.rpm
  
{{Tip|Unlike SLES, OpenSUSE doesn't have a 'mysql-max' package. You may install the MySQL standard package instead without experiencing any problems.}}
+
dnf install -y \
{{Warning|For versions of Pandora FMS 729 or higher, it is necessary to install the dependencies of PHP7 for a correct use of the console}}
+
    vim \
 +
    fping \
 +
    perl-IO-Compress \
 +
    nmap \
 +
    sudo \
 +
    perl-Time-HiRes \
 +
    perl-Math-Complex \
 +
    libnsl \
 +
    net-snmp-utils
  
In order to install all dependencies execute:
 
  
zypper install ..
+
In the <b>Community</b> version some extra dependencies will be needed:
  
Followed by the whole package list, specified in the paragraph above, this is going to display a screen like the one below:
+
dnf install -y  GeoIP \
 +
GeoIP-GeoLite-data \
 +
dwz \
 +
efi-srpm-macros \
 +
ghc-srpm-macros \
 +
go-srpm-macros \
 +
ocaml-srpm-macros \
 +
openblas-srpm-macros \
 +
perl \
 +
perl-Algorithm-Diff \
 +
perl-Archive-Tar \
 +
perl-Archive-Zip \
 +
perl-Attribute-Handlers \
 +
perl-B-Debug \
 +
perl-CPAN \
 +
perl-CPAN-Meta \
 +
perl-CPAN-Meta-Requirements \
 +
perl-CPAN-Meta-YAML \
 +
perl-Compress-Bzip2 \
 +
perl-Config-Perl-V \
 +
perl-DBD-MySQL \
 +
perl-DBI \
 +
perl-DB_File \
 +
perl-Data-Dump \
 +
perl-Data-OptList \
 +
perl-Data-Section \
 +
perl-Devel-PPPort \
 +
perl-Devel-Peek \
 +
perl-Devel-SelfStubber \
 +
perl-Devel-Size \
 +
perl-Digest-HMAC \
 +
perl-Digest-SHA \
 +
perl-Encode-Locale \
 +
perl-Encode-devel \
 +
perl-Env \
 +
perl-ExtUtils-CBuilder \
 +
perl-ExtUtils-Command \
 +
perl-ExtUtils-Embed \
 +
perl-ExtUtils-Install \
 +
perl-ExtUtils-MM-Utils \
 +
perl-ExtUtils-MakeMaker \
 +
perl-ExtUtils-Manifest \
 +
perl-ExtUtils-Miniperl \
 +
perl-ExtUtils-ParseXS \
 +
perl-File-Fetch \
 +
perl-File-HomeDir \
 +
perl-File-Listing \
 +
perl-File-Which \
 +
perl-Filter \
 +
perl-Filter-Simple \
 +
perl-Geo-IP \
 +
perl-HTML-Parser \
 +
perl-HTML-Tagset \
 +
perl-HTML-Tree \
 +
perl-HTTP-Cookies \
 +
perl-HTTP-Date \
 +
perl-HTTP-Message \
 +
perl-HTTP-Negotiate \
 +
perl-IO-HTML \
 +
perl-IO-Socket-INET6 \
 +
perl-IO-Zlib \
 +
perl-IO-stringy \
 +
perl-IPC-Cmd \
 +
perl-IPC-SysV \
 +
perl-IPC-System-Simple \
 +
perl-JSON \
 +
perl-JSON-PP \
 +
perl-LWP-MediaTypes \
 +
perl-Locale-Codes \
 +
perl-Locale-Maketext \
 +
perl-Locale-Maketext-Simple \
 +
perl-MRO-Compat \
 +
perl-Math-BigInt \
 +
perl-Math-BigInt-FastCalc \
 +
perl-Math-BigRat \
 +
perl-Memoize \
 +
perl-Module-Build \
 +
perl-Module-CoreList \
 +
perl-Module-CoreList-tools \
 +
perl-Module-Load \
 +
perl-Module-Load-Conditional \
 +
perl-Module-Loaded \
 +
perl-Module-Metadata \
 +
perl-NTLM \
 +
perl-Net-HTTP \
 +
perl-Net-Ping \
 +
perl-NetAddr-IP \
 +
perl-Package-Generator \
 +
perl-Params-Check \
 +
perl-Params-Util \
 +
perl-Perl-OSType \
 +
perl-PerlIO-via-QuotedPrint \
 +
perl-Pod-Checker \
 +
perl-Pod-Html \
 +
perl-Pod-Parser \
 +
perl-SelfLoader \
 +
perl-Socket6 \
 +
perl-Software-License \
 +
perl-Sub-Exporter \
 +
perl-Sub-Install \
 +
perl-Sys-Syslog \
 +
perl-Test \
 +
perl-Test-Harness \
 +
perl-Test-Simple \
 +
perl-Text-Balanced \
 +
perl-Text-Diff \
 +
perl-Text-Glob \
 +
perl-Text-Template \
 +
perl-Thread-Queue \
 +
perl-Time-Piece \
 +
perl-TimeDate \
 +
perl-Try-Tiny \
 +
perl-Unicode-Collate \
 +
perl-WWW-RobotRules \
 +
perl-XML-NamespaceSupport \
 +
perl-XML-Parser \
 +
perl-XML-SAX \
 +
perl-XML-SAX-Base \
 +
perl-XML-Simple \
 +
perl-XML-Twig \
 +
perl-autodie \
 +
perl-bignum \
 +
perl-devel \
 +
perl-encoding \
 +
perl-experimental \
 +
perl-inc-latest \
 +
perl-libnetcfg \
 +
perl-libwww-perl \
 +
perl-local-lib \
 +
perl-open \
 +
perl-perlfaq \
 +
perl-srpm-macros \
 +
perl-utils \
 +
perl-version \
 +
python-srpm-macros \
 +
python3-pyparsing \
 +
python3-rpm-macros \
 +
qt5-srpm-macros \
 +
redhat-rpm-config \
 +
rust-srpm-macros \
 +
systemtap-sdt-devel \
 +
perl-TermReadKey \
 +
perl \
 +
perl-DBD-MySQL \
 +
perl-DBI
  
Getting repositories data...
+
After this, and only in the <b>Community</b> version, you will need to install the following package:  
Reading packets installed...
+
 
perl-DBI already installed.
+
  dnf install -y https://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29/RPM%20CentOS%2C%20RHEL/perl-Net-Telnet-3.04-1.el8.noarch.rpm
perl-HTML-Parser already installed.
 
perl-TimeDate already installed.
 
perl-XML-Simple already installed.
 
perl-libwww-perl already installed.
 
xorg-x11-fonts-core already installed.
 
Resolving dependencies...
 
 
Following NEW packages will be installed:
 
  apache2 apache2-mod_php5 apache2-prefork apache2-utils libapr1 libapr-util1 libdnet1
 
  liblua5_1 libmm14 libmysqlclient15 mysql mysql-client mysql-Max net-snmp nmap
 
perl-Bit-Vector perl-Carp-Clan perl-Data-ShowTable perl-Date-Calc perl-Date-Manip
 
perl-DBD-mysql perl-HTML-Encoding perl-HTML-Tree perl-IO-Socket-inet6
 
perl-Mail-Sendmail perl-NetAddr-IP perl-SNMP php5 php5-ctype php5-dom php5-gd
 
php5-gettext php5-hash php5-iconv php5-json php5-ldap php5-mbstring php5-mysql
 
php5-openssl php5-pdo php5-pear php5-snmp php5-sqlite php5-tokenizer php5-xmlreader
 
php5-xmlwriter php5-zip php5-zlib t1lib perl-JSON
 
 
Total Size: 19.1 M. After the operation, additional 55.9 M will be used.
 
  Continue? [Yes / no]:
 
  
Click 'yes' to download Zypper and install the packages.
+
After these steps, we will disable <b>SELINUX</b> and the firewall.  
  
When finished, you're required to install some extra packages. Under OpenSuse, the required packages for Pandora FMS are at https://sourceforge.net/projects/pandora/files/Pandora%20FMS%207.0NG/Final/. Additional RPMs to satisfy the dependencies: [http://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29/RPM%20SUSE/ from the Pandora FMS Sourceforge website.] The additional RPMs are the following:
+
setenforce 0
 +
sed -i -e "s/^SELINUX=.*/SELINUX=disabled/g" /etc/sysconfig/selinux
 +
systemctl disable firewalld --now
  
perl-time-format php-pear-xml_rpc wmic smstools perl-HTML-Tree perl-XML-Twig
+
Then we can start configuring the database:
  
 +
systemctl start mysqld
 +
mysql -uroot -p$(grep "temporary password" /var/log/mysqld.log | rev | cut -d' ' -f1 | rev)
  
{{Tip|Extra packages like 'Perl-HTML-Tree' and 'Perl-XML-Twig' require manual installation.}}
+
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('Pandor4!');
 +
UNINSTALL PLUGIN validate_password;
 +
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('pandora');
 +
quit
  
{{Tip|In Centos7 wmic is not an explicit requirement for pandorafms_server but is still needed by the WMIServer. You can find the binary file at [https://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29/wmic_centOS7_x64.zip/download the SourceForge web site].}}
+
echo "create database $DBNAME" | mysql -uroot -ppandora -P$DBPORT -h$DBHOST
 +
echo "GRANT ALL PRIVILEGES ON $DBNAME.* TO \"$DBUSER\"@'%' identified by \"$DBPASS\"" | mysql -uroot -ppandora -P$DBPORT -h$DBHOST
  
 +
We will also generate the file <b>my.cnf</b>.
  
If you intend to use the Recon Server, install these additional packages:
 
  
  perl-net-traceroute perl-net-traceroute-pureperl xprobe2
+
  POOL_SIZE=$(grep -i total /proc/meminfo | head -1 | awk '{print $(NF-1)*0.4/1024}' | sed s/\\..*$/M/g)
 +
cat > /etc/my.cnf << EO_CONFIG_F
 +
[mysqld]
 +
datadir=/var/lib/mysql
 +
socket=/var/lib/mysql/mysql.sock
 +
user=mysql
 +
character-set-server=utf8
 +
skip-character-set-client-handshake
 +
# Disabling symbolic-links is recommended to prevent assorted security risks
 +
symbolic-links=0
 +
# Mysql optimizations for Pandora FMS
 +
# Please check the documentation in http://pandorafms.com for better results
 +
max_allowed_packet = 64M
 +
innodb_buffer_pool_size = $POOL_SIZE
 +
innodb_lock_wait_timeout = 90
 +
innodb_file_per_table
 +
innodb_flush_log_at_trx_commit = 0
 +
innodb_flush_method = O_DIRECT
 +
innodb_log_file_size = 64M
 +
innodb_log_buffer_size = 16M
 +
innodb_io_capacity = 100
 +
thread_cache_size = 8
 +
thread_stack    = 256K
 +
max_connections = 100
 +
key_buffer_size=4M
 +
read_buffer_size=128K
 +
read_rnd_buffer_size=128K
 +
sort_buffer_size=128K
 +
join_buffer_size=4M
 +
query_cache_type = 1
 +
query_cache_size = 64M
 +
query_cache_min_res_unit = 2k
 +
query_cache_limit = 256K
 +
sql_mode=""
 +
[mysqld_safe]
 +
log-error=/var/log/mysqld.log
 +
pid-file=/var/run/mysqld/mysqld.pid
 +
EO_CONFIG_F
  
These RPM files can be found on the official distribution site of Pandora FMS Software in a specific dependencies directory for OpenSUSE.
 
  
{{Tip|Please make sure to download the appropriate packages for OpenSUSE.}}
+
Once the changes have been saved, it will be necessary to restart the <b>mysqld</b> service.
  
Please put them in a directory to install them, e.g.: '/tmp/extra' and execute the following command:
+
systemctl restart mysqld
  
  rpm -i *.rpm
+
And we will enable the services <b>mysql</b>, <b>apache</b> and <b>php</b>.  
  
==== Server Installation ====
+
systemctl enable mysqld --now
 +
systemctl enable httpd --now
 +
systemctl enable php-fpm --now
  
Just execute:
+
With all the environment ready, it's time to install <b>Pandora FMS</b>. The first thing will be to create a directory to store all the data. 
  
  rpm -i pandorafms_server-5.1SP2-1.noarch.rpm
+
  mkdir $HOME/pandora && cd $HOME/pandora
  
==== Console Installation ====
+
{{Warning|It will be necessary to download the packages of the <b>console</b>, <b>enterprise console</b> and <b>enterprise server</b> from Sourceforge or the links provided by the support team.}}
  
Please execute the RPM installation tool for packages in order to install the package which contains the Pandora FMS Console:
+
With the packages already prepared, we can start the installation:
  
  rpm -i pandorafms_console-5.1SP2-1.noarch.rpm
+
  yum install -y $HOME/pandora/pandorafms*.rpm
  
=== Uninstalling Pandora FMS ===
+
Pandora server installation (only for the <b>Enterprise</b> version):
  
You're able to uninstall any of Pandora FMS components by using the following commands:
+
tar xvfz $HOME/pandora/pandorafms_server* && cd pandora_server && ./pandora_server_installer --install --ha; cd -
  
  rpm -e pandorafms_agent
+
Once the process is finished, we will populate the database:
  rpm -e pandorafms_console
+
 
rpm -e pandorafms_server
+
  mysql -u$DBUSER -p$DBPASS -P$DBPORT -h$DBHOST $DBNAME < $PANDORA_CONSOLE/pandoradb.sql
 +
  mysql -u$DBUSER -p$DBPASS -P$DBPORT -h$DBHOST $DBNAME < $PANDORA_CONSOLE/pandoradb_data.sql
 +
 
 +
Then we will have to configure the console.
  
The Pandora FMS database won't get uninstalled if any of the Pandora FMS packages are - but all files from any other package (including the configuration files) will be deleted, but the database will have to be deleted manually.
+
cat > $CONSOLE_PATH/include/config.php << EO_CONFIG_F
 +
<?php
 +
\$config["dbtype"] = "mysql";
 +
\$config["dbname"]="$DBNAME";
 +
\$config["dbuser"]="$DBUSER";
 +
\$config["dbpass"]="$DBPASS";
 +
\$config["dbhost"]="$DBHOST";
 +
\$config["homedir"]="/var/www/html/pandora_console";
 +
\$config["homeurl"]="/pandora_console";
 +
error_reporting(0);
 +
\$ownDir = dirname(__FILE__) . '/';
 +
include (\$ownDir . "config_process.php");
 +
  EO_CONFIG_F
  
== Installation in Red Hat Enterprise Linux / Fedora / CentOS ==
+
cat > /etc/httpd/conf.d/pandora.conf << EO_CONFIG_F
 +
<Directory "/var/www/html">
 +
    Options Indexes FollowSymLinks
 +
    AllowOverride All
 +
    Require all granted
 +
</Directory>
 +
EO_CONFIG_F
  
The installation process is nearly the same as the one from SUSE. Please keep in mind that RHEL, CentOS or Fedora RPM packages aren't the same as the ones in SUSE - there are also some incompatibilities.
+
sed -i -e "s/php_flag engine off//g" $PANDORA_CONSOLE/images/.htaccess
 +
sed -i -e "s/php_flag engine off//g" $PANDORA_CONSOLE/attachment/.htaccess
  
First of all, you will need to activate certain official Redhat/Centos/Fedora repositories to perform dependency installation. The repositories to be activated are EXTRAS, UPDATES and the additional installation of the EPEL repository.
+
chmod 600 $CONSOLE_PATH/include/config.php
 +
chown apache. $CONSOLE_PATH/include/config.php
 +
mv $CONSOLE_PATH/install.php $CONSOLE_PATH/install.done
  
Edit /etc/yum.repos.d/CentOS-Base.repo and enable EXTRAS, and UPDATES repos. Usually should be something like this:
 
  
 +
Then we will prepare the file <b>php.ini</b>. 
  
  [updates]
+
  sed -i -e "s/^max_input_time.*/max_input_time = -1/g" /etc/php.ini
name=CentOS-$releasever - Updates
+
sed -i -e "s/^max_execution_time.*/max_execution_time = 0/g" /etc/php.ini
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates
+
  sed -i -e "s/^upload_max_filesize.*/upload_max_filesize = 800M/g" /etc/php.ini
gpgcheck=0
+
sed -i -e "s/^memory_limit.*/memory_limit = 500M/g" /etc/php.ini
   
 
[extras]
 
name=CentOS-$releasever - Extras
 
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=extras
 
gpgcheck=0
 
  
Add the EPEL repository:
+
cat > /var/www/html/index.html << EOF_INDEX
 +
<meta HTTP-EQUIV="REFRESH" content="0; url=/pandora_console/">
 +
EOF_INDEX
  
  [EPEL]
+
  systemctl restart php-fpm
  Name = EPEL
+
  systemctl restart httpd
baseurl = http://dl.fedoraproject.org/pub/epel/$releasever/$basearch/
 
enabled = 1
 
gpgcheck = 0
 
  
Please refresh your repository information with this command:
+
The server configuration file will be prepared. 
  
  yum makecache
+
  sed -i -e "s/^dbhost.*/dbhost $DBHOST/g" $PANDORA_SERVER_CONF
 +
sed -i -e "s/^dbname.*/dbname $DBNAME/g" $PANDORA_SERVER_CONF
 +
sed -i -e "s/^dbuser.*/dbuser $DBUSER/g" $PANDORA_SERVER_CONF
 +
sed -i -e "s|^dbpass.*|dbpass $DBPASS|g" $PANDORA_SERVER_CONF
 +
sed -i -e "s/^dbport.*/dbport $DBPORT/g" $PANDORA_SERVER_CONF
  
=== Installation using the Pandora FMS Repository ===
+
We will also enable the service <b>ha</b>.
  
You're going to need YUM and access to the Internet. First, you're required to create a reference to the Pandora FMS official repository for CentOS 7. This also applies for the usage under RHEL7.
+
systemctl enable pandora_ha --now
 +
service tentacle_serverd start
  
vi /etc/yum.repos.d/pandorafms.repo
 
 
Add these contents:
 
  
[artica_pandorafms]
 
name=CentOS7 - PandoraFMS official repo
 
baseurl=http://firefly.artica.es/centos7
 
gpgcheck=0
 
enabled=1
 
  
 +
In the <b>Community</b> version we will need to execute the following commands to enable the server:
  
Refresh your repository information:
+
systemctl enable pandora_server --now
 +
systemctl start pandora_server
 +
service tentacle_serverd start
  
yum makecache
 
  
And install Pandora FMS, along with the mysql server (it is an optional dependency, but you will need a MySQL server if you don't have one already installed or accessible in another server).
+
Install <b>Phantom</b>.
  
yum install pandorafms_console pandorafms_server mariadb-server
 
  
Download all the necessary packages and leave the system ready for configuration and use.
+
wget https://downloads.sourceforge.net/project/pandora/Tools%20and%20dependencies%20%28All%20versions%29/DEB%20Debian%2C%20Ubuntu/phantomjs ; chmod +x phantomjs; mv phantomjs /usr/bin/
  
{{Tip|Mariadb-server replaces the mysql-server package, but it depends on the distro you're using (it is not the same CentOS as RHEL, you will have to use one or the other, being the differences of use minimum when using Pandora).}}
+
We will enable the <b>cron</b> of the console:
  
=== Manual Installation by RPM Files ===
+
echo "* * * * * root wget -q -O - --no-check-certificate http://127.0.0.1/pandora_console/enterprise/cron.php >> /var/www/html/pandora_console/log/cron.log" >> /etc/crontab
  
Most dependencies should be resolved using YUM or another automatic tool. All dependencies are marked as required packages in the RPM definition. If you have already configured the required repositories in the previous step, this operation will be almost automatic.
+
Then you may go to the server ip and should enter the Pandora Console up and running
  
In the case of CentOS it will be necessary to install the following dependencies:
 
  
yum install php php-gd graphviz php-mysql php-pear-DB php-zip php-mbstring php-ldap \
+
It is recommended to [https://pandorafms.com/docs/index.php?title=Pandora:Documentation_es:Instalacion#Instalaci.C3.B3n_Agentes_Pandora_FMS install the agent] to automonitor the server.
php-snmp php-ldap php-common make perl-CPAN perl-HTML-Tree perl-DBI perl-DBD-mysql \
 
perl-libwww-perl perl-XML-Simple perl-XML-Twig perl-XML-SAX perl-NetAddr-IP \
 
net-snmp perl-SNMP net-tools perl-IO-Socket-INET6 perl-Socket6 nmap sudo xprobe2 \
 
perl-Encode-Locale
 
  
It is possible that if you use Fedora or Redhat the names of some packages are slightly different, so we will use these added to the previous ones:
+
== Installation under Docker ==
  
yum install net-snmp-perl perl-JSON perl-NetAddr-IP perl-Socket6 \
+
=== Run the latest stable version ===
perl-Time-HiRes perl-XML-Twig perl-IO-Socket-INET6
+
To run the latest stable version, type in:
  
Some dependencies (like 'wmic' or 'xprobe2') aren't contained in the official RHEL repositories. We're providing them on our Sourceforge download page in the "Tools and Dependecies" section [https://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29].
+
    curl -sSL http://pandorafms.org/getpandora  | sh
  
In the meantime, for Red Hat Enterprise Linux 6 it will be sufficient to install these others, as several of the packages required for the console and server are included in the php and perl and serial dependencies:
+
Once Pandora FMS is running, point your browser to <nowiki>http://localhost/pandora_console</nowiki> and log-in as user ''admin'' (the default password is ''pandora'').
  
yum install php php-common graphviz
+
{{Warning|This command requires Docker Engine to be installed and running.}}
 
yum install perl-HTML-Tree perl-DBD-mysql perl-XML-Simple perl-XML-SAX \
 
perl-NetAddr-IP net-snmp perl-SNMP net-tools perl-IO-Socket-INET6 perl-Socket6 nmap wmic xprobe2
 
  
{{Warning|If you're using a version prior to RHEL6, some dependencies could have another name,In the case of perl-SNMP, in CentOS5, RHEL5, etc, the dependency to obtain would be net-snmp-perl.}}
+
=== Advanced installation ===
  
{{Warning|For versions of Pandora FMS 729 or higher, it is necessary to install the dependencies of PHP7 for a correct use of the console}}
+
Pandora FMS runs as a container under Docker environments. It can be launched as follows:
 +
    docker run -d --name pandorafms pandorafms/pandorafms:7
  
In order to install the RPM, just use the 'rpm -i' or the yum command directly:
+
{{Tip|Docker images are updated on a daily basis}}
  
rpm -i pandorafms_server-x.x-x.noarch.rpm
+
{{Tip|The latest stable version is 7.}}
  
or
+
== Installing the VMWare Virtual Machine ==
  
yum install pandorafms_server-x.x-x.noarch.rpm
+
Alongside the Centos ISO, you can find a virtual machine which contains an already installed Pandora FMS ISO in Sourceforge. This image is tested with VMWare ESX, VMWare Workstation, VirtualBox and Hyper-V. To run it under Hyper-V, you are required to export the VMDX and VDH files from the 'MVDC.exe' executable. They are available after installing the Microsoft Virtual Machine Converter.
  
If you encounter any problems at the time you're trying to access the Pandora FMS Console installation web page, please check if SELinux is active: In this case, it's mandatory to deactivate it. Please follow the [[Pandora:FAQ#I_cannot_access_the_Pandora_Console_installation_web_page_in_CentOS.|FAQ]] procedures in such a case.
+
To install it, execute the '.ovf' file for 'Virtualbox' and 'VMWare Workstation'. And for ESX and Hyper-V, import the image under 'Import VM' and select the virtual image there.
  
 +
The credentials for this machine are the following:
  
{{Warning|RHEL and CentOS 5.x use PHP 5.1 by default. This version is '''not''' compatible with Pandora FMS. You're required to use PHP version 5.2 or above. Tested in php55w. For versions of Pandora FMS 729 or higher, its required to use PHP version 7.2}}
+
''User:'' ''' root'''
  
To do so, we recommend using the following repository for CentOS6/RHEL6, which contains PHP 5.6:
+
''Password:'' ''' pandora'''
  
[remi]
+
''Console User:'' ''' admin'''
name=Les RPM de remi pour Enterprise Linux 6 - $basearch
 
#baseurl=http://rpms.famillecollet.com/enterprise/6/remi/$basearch/
 
mirrorlist=http://rpms.famillecollet.com/enterprise/6/remi/mirror
 
enabled=1
 
gpgcheck=1
 
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-remi
 
  
 +
''Password:'' ''' pandora'''
  
[remi-php56]
+
''MySQL user:''''' root'''
name=Les RPM de remi de PHP 5.6 pour Enterprise Linux 6 - $basearch
 
#baseurl=http://rpms.famillecollet.com/enterprise/6/php56/$basearch/
 
mirrorlist=http://rpms.famillecollet.com/enterprise/6/php56/mirror
 
# WARNING: If you enable this repository, you must also enable "remi"
 
enabled=1
 
gpgcheck=1
 
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-remi
 
  
 +
''Password:'' ''' pandora'''
  
GPG key for remi repository can be found here: http://rpms.remirepo.net/RPM-GPG-KEY-remi
+
{{Warning|Due to security reasons, please change the passwords used during the installation as soon as possible.}}
  
===  Uninstalling Pandora in CentOS/RHEL ===
+
== Installation under SUSE (OpenSUSE or SLES) ==
  
Just execute the order
+
=== Automatized Installation by the Official Repository ===
  
yum remove pandorafms_console pandorafms_server
+
To be able to choose this method -the fastest and most convenient-, access internet from the server where Pandora FMS is going to be installed. All steps must be executed as root (or under sudo).
  
If you have installed MySQL and no longer need it, you can also delete it with the same command:
+
'''Step 1:''' Create a repository :
  
  yum remove mysql-server
+
  #'''SLES 12 SP3'''
 +
zypper ar -f http://firefly.artica.es/suse PandoraFMS_Official_Repo
 +
zypper ar -f http://download.opensuse.org/repositories/server:/php:/applications/SLE_12_SP3/
 +
zypper ar -f http://download.opensuse.org/repositories/devel:/languages:/perl/SLE_12_SP3/ Perl
  
== Installation under Debian and Ubuntu ==
+
wget --no-check-certificate https://dev.mysql.com/get/mysql80-community-release-sles12-1.noarch.rpm
 +
rpm -i mysql80-community-release-sles12-1.noarch.rpm
  
Installing Pandora FMS '''version 10.04 or above''' is recommended. In the Debian Stable version (Squeeze) there are problems with some libraries and applications that Pandora FMS needs for some components. The Debian LWP library does not implement certain methods for SSL, and this is necessary for the Enteprise modules of WEB monitoring. You can fix this by installing a newer version of LWP using CPAN (manual method).  
+
#'''openSUSE (15.0)'''
 +
zypper ar -f http://firefly.artica.es/suse PandoraFMS_Official_Repo
 +
zypper ar -f http://download.opensuse.org/repositories/server:/php:/applications/openSUSE_Leap_15.0/ Php5
 +
zypper ar -f http://download.opensuse.org/repositories/devel:/languages:/perl/openSUSE_Leap_15.0/Perl
 +
 +
wget --no-check-certificate https://dev.mysql.com/get/mysql80-community-release-sl15-1.noarch.rpm
 +
rpm -ivh mysql80-community-release-sl15-1.noarch.rpm
  
When installing you need to add the official repositories of each version. For example, to install the libencode-locale-perl and snmp-mibs-downloader packages in a Debian Squeeze, you will need to add the following repositories to the file named /etc/apt/sources.list
 
  
 +
'''Step 2:''' Update the repository's information:
  
  deb http://ftp.us.debian.org/debian/ squeeze main non-free
+
  zypper refresh
deb http://ftp.at.debian.org/debian-cd/ squeeze-backports main
 
  
Alternatively, for Debian Wheezy:
+
'''Step 3:''' Install Pandora FMS and some of its dependencies :
  
  deb http://ftp.debian.org/debian/dists/Debian9.6/ wheezy-backports main
+
  zypper install pandorafms_console pandorafms_server apache2-mod_php5
deb http://ftp.us.debian.org/debian/ wheezy main non-free
 
  
Once they have been added you need to execute 'apt-get update' to apply the changes.
+
{{Warning|From Pandora FMS version 729 onwards, PHP7 is needed for the console to work.}}
  
Due to the way in which Debian/Ubuntu manages the packages, it is more than recommended to install Pandora FMS in a system that has access to the online package repositories (or a replica in the local network). A dependency on Debian can involve dozens of sub-dependencies, so preparing an accurate list of packages needed for offline installation can be a very complex task.
+
=== Manual RPM Installation ===
  
=== Installation with Artica Private Repository ===
+
==== Previous Dependencies Installation ====
  
There's also a much faster and easier method: just add the Artica Private Repository. It contains any and all the Ubuntu and Debian packages you might require.
+
For this documentation, Suse '''Zypper''' system, that allows you to resolve dependencies and download packages directly from the repositories on the internet, will be used. If you do not have Zypper, install it, it is much more convenient and fast. If it is not possible, dependencies can be downloaded in. rpm format from the internet, but the process is considerably longer and more cumbersome.
  
In order to do so, please edit the file '/etc/apt/sources.list' and add the following line:
+
The following package dependencies, included in the SUSE system, must be installed:
  
For Debian Squeeze:
+
apache2 apache2-mod_php5 php5 php5-gd php5-gettext php5-json php5-mbstring php5-ldap php5-mysql \
 +
php5-pear php5-snmp php5-zip nmap perl-DBD-mysql perl-DBI perl-Date-Calc perl-HTML-Parser \
 +
perl-HTML-Encoding perl-HTML-Tree perl-IO-Socket-inet6 perl-Socket6 perl-Mail-Sendmail perl-NetAddr-IP \
 +
perl-TimeDate perl-XML-Simple perl-XML-Twig perl-libwww-perl mysql-client mysql-max mysql  \
 +
net-snmp xorg-x11-fonts-core php5-pear-db php5-curl php5-xmlrpc perl-SNMP graphviz graphviz-gd \
 +
perl-Encode-Locale perl-JSON
  
deb http://firefly.artica.es/debian/squeeze /
 
  
For Debian Wheezy:
+
{{Tip|Unlike SLES, OpenSUSE does not have a 'mysql-max' package. You may install MySQL standard package instead without experiencing any issues.}}
 +
{{Warning|For versions of Pandora FMS 729 or higher, it is necessary to install the dependencies of PHP7 for correct console use}}
  
deb http://firefly.artica.es/debian/wheezy /
+
In order to install all dependencies execute:
  
Execute as root (sudo)
+
zypper install ..
  
apt-get update
+
Followed by the whole package list, specified in the paragraph above, this is going to display a screen like the one below:
  
Installation of Pandora FMS by apt-get:
+
Getting repositories data...
 
+
Reading packets installed...
<pre>
+
perl-DBI already installed.
[email protected]:~# apt-get install pandorafms-console pandorafms-server pandorafms-agent-unix
+
perl-HTML-Parser already installed.
Reading package lists... Done
+
perl-TimeDate already installed.
Building dependency tree     
+
perl-XML-Simple already installed.
Reading state information... Done
+
perl-libwww-perl already installed.
The following extra packages will be installed:
+
xorg-x11-fonts-core already installed.
  apache2-mpm-prefork apache2-utils apache2.2-common dbconfig-common graphviz libapache2-mod-php5 libcgraph5 libcurl3 libgd2-xpm libgvpr1
+
Resolving dependencies...
  libio-socket-inet6-perl libnetaddr-ip-perl libonig2 libqdbm14 libsnmp-perl libsocket6-perl libssh2-1 libtime-format-perl
+
  libxml-namespacesupport-perl libxml-sax-expat-perl libxml-sax-perl libxml-simple-perl nmap php-db php-gettext php-pear php5 php5-cli php5-common
+
The following NEW packages will be installed:
  php5-curl php5-gd php5-ldap php5-mysql php5-snmp php5-suhosin php5-xmlrpc smistrip snmp snmp-mibs-downloader snmpd xprobe
+
  apache2 apache2-mod_php5 apache2-prefork apache2-utils libapr1 libapr-util1 libdnet1
Suggested packages:
+
liblua5_1 libmm14 libmysqlclient15 mysql mysql-client mysql-Max net-snmp nmap
  apache2-doc apache2-suexec apache2-suexec-custom graphviz-doc libgd-tools php5-dev
+
perl-Bit-Vector perl-Carp-Clan perl-Data-ShowTable perl-Date-Calc perl-Date-Manip
The following packages will be REMOVED:
+
perl-DBD-mysql perl-HTML-Encoding perl-HTML-Tree perl-IO-Socket-inet6
  libgd2-noxpm
+
perl-Mail-Sendmail perl-NetAddr-IP perl-SNMP php5 php5-ctype php5-dom php5-gd
The following NEW packages will be installed:
+
php5-gettext php5-hash php5-iconv php5-json php5-ldap php5-mbstring php5-mysql
  apache2-mpm-prefork apache2-utils apache2.2-common dbconfig-common graphviz libapache2-mod-php5 libcgraph5 libcurl3 libgd2-xpm libgvpr1
+
php5-openssl php5-pdo php5-pear php5-snmp php5-sqlite php5-tokenizer php5-xmlreader
  libio-socket-inet6-perl libnetaddr-ip-perl libonig2 libqdbm14 libsnmp-perl libsocket6-perl libssh2-1 libtime-format-perl
+
php5-xmlwriter php5-zip php5-zlib t1lib perl-JSON
  libxml-namespacesupport-perl libxml-sax-expat-perl libxml-sax-perl libxml-simple-perl nmap pandorafms-agent-unix pandorafms-console
+
  pandorafms-server php-db php-gettext php-pear php5 php5-cli php5-common php5-curl php5-gd php5-ldap php5-mysql php5-snmp php5-suhosin php5-xmlrpc
+
Total Size: 19.1 M. After the operation, additional 55.9 M will be used.
  smistrip snmp snmp-mibs-downloader snmpd xprobe
+
  Continue? [Yes / no]:
0 upgraded, 44 newly installed, 1 to remove and 0 not upgraded.
 
Need to get 40.9 MB of archives.
 
After this operation, 90.8 MB of additional disk space will be used.
 
Do you want to continue [Y/n]? y
 
WARNING: The following packages cannot be authenticated!
 
  pandorafms-agent-unix pandorafms-console pandorafms-server
 
Install these packages without verification [y/N]? y
 
</pre>
 
  
{{Warning|For versions of Pandora FMS 729 or higher, it is necessary to install the dependencies of PHP7 for a correct use of the console}}
+
Click 'yes' to download Zypper and install the packages.
  
=== Manual Installation by DEB Packages ===
+
When finished, you will be required to install some extra packages. OpenSuse does not contain all the dependencies needed by Pandora FMS. Additional RPMs to meet these dependencies: [http://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29/RPM%20SUSE/ from the Pandora FMS Sourceforge website.] The additional RPMs are the following:
  
Under Debian or Ubuntu, the dependencies are the following:
+
perl-time-format php-pear-xml_rpc wmic smstools perl-HTML-Tree perl-XML-Twig
  
Server:
 
  
snmp snmpd libtime-format-perl libxml-simple-perl libdbi-perl libnetaddr-ip-perl
+
{{Tip|Extra packages like 'Perl-HTML-Tree' and 'Perl-XML-Twig' require manual installation.}}
libhtml-parser-perl wmi-client xprobe2 nmap traceroute
 
libio-socket-inet6-perl libhtml-tree-perl libsnmp-perl snmp-mibs-downloader
 
libio-socket-multicast-perl libsnmp-perl libjson-perl libencode-locale-perl
 
  
 +
{{Tip|In Centos7 wmic it is not an explicit requirement for pandorafms_server but is still needed by the WMIServer. You can find the binary file at [https://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29/wmic_centOS7_x64.zip/download the SourceForge web site].}}
  
{{Tip|If the 'wmi-client' package is not available in the repositories, you're required to download it from the [http://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20(All%20versions)/DEB%20Debian,%20Ubuntu/ Pandora FMS Sourceforge website.]}}
 
  
{{Tip|If you are installing Pandora FMS in a Debian Squeeze, you will need to add the "Non-Free" repository to access the snmp-mibs-downloader package.}}
+
If you intend to use the Recon Server, install these additional packages:
  
Console:
+
perl-net-traceroute perl-net-traceroute-pureperl xprobe2
  
php5 libapache2-mod-php5 apache2 mysql-server php5-gd php5-mysql php-pear php5-snmp php-db php-gettext
+
These RPM files can be found on the official distribution site of Pandora FMS Software in a specific dependency directory for OpenSUSE.
graphviz mysql-client php5-curl php5-xmlrpc php5-ldap
 
  
{{Warning|For versions of Pandora FMS 729 or higher, it is necessary to install the dependencies of PHP7 for a correct use of the console}}
+
{{Tip|Please make sure to download the appropriate packages for OpenSUSE.}}
  
In order to install the Server package or the console, you first have to implement all of the required dependencies. This is done by installing all the previously mentioned packages by using the command ''apt-get'' along with root privileges:
+
Put them in a directory to install them, e.g.: '/tmp/extra' and execute the following command:
  
  apt-get install  snmp snmpd libtime-format-perl libxml-simple-perl libxml-twig-perl libdbi-perl
+
  rpm -i *.rpm
libnetaddr-ip-perl libhtml-parser-perl wmi-client xprobe2 nmap libmail-sendmail-perl traceroute
 
libio-socket-inet6-perl libhtml-tree-perl libsnmp-perl snmp-mibs-downloader libio-socket-multicast-perl
 
libsnmp-perl libjson-perl php5 libapache2-mod-php5 apache2 mysql-server php5-gd php5-mysql php-pear
 
php5-snmp php-db php-gettext graphviz mysql-client php5-curl php5-xmlrpc php5-ldap dbconfig-common
 
  
 +
==== Server Installation ====
  
This command will install all the dependencies required to install the Pandora FMS Server and its console into a Debian or Ubuntu system.
+
Just execute:
  
{{Tip|The character '\' is used as a line divider. You may copy and paste it directly out of this documentation into the console and the line breaks will be considered as such.}}
+
rpm -i pandorafms_server-5.1SP2-1.noarch.rpm
  
 +
==== Console Installation ====
  
 +
Execute the RPM installation tool for packages in order to install the package which contains the Pandora FMS Console:
  
                   
+
rpm -i pandorafms_console-5.1SP2-1.noarch.rpm
The installation with the DEB packages is very easy.  
 
  
FIf we do not have internet connection, we install the dependencies. Then we install the Pandora FMS packages, in this example all Pandora FMS components are installed together.
+
=== Uninstalling Pandora FMS ===
  
dpkg -i pandorafms-console_xxx.deb pandorafms-server_xxxx.deb
+
To uninstall any of Pandora FMS components, use any of the following commands:
  
Once the command has been executed, you might see that some dependencies are missing. If so, you can try to solve it automatically by using the following command:
+
rpm -e pandorafms_agent
 +
rpm -e pandorafms_console
 +
rpm -e pandorafms_server
  
apt-get -f install
+
The Pandora FMS database will not be uninstalled if any of the Pandora FMS packages are - but all files from any other package (including the configuration files) will be deleted, however the database must be deleted manually.
  
This will attempt to download all the necessary missing packages from the automated installation of Pandora FMS on the system. Once the necessary packages have been installed, you're required to continue with the installation of all Pandora FMS components.
+
== Installation in Red Hat Enterprise Linux / Fedora / CentOS ==
  
{{Warning|In some Ubuntu versions you will have to move the directory /var/www/pandora_console/ to the public directory of the web server by default /var/www/html/pandora_console }}
+
The installation process is nearly the same as the one from SUSE. Keep in mind that RHEL, CentOS or Fedora RPM packages are not the same as the ones in SUSE - since SUSE RPMs use a different package version, with a different compression algorithm which makes them incompatible.
  
In order to complete the installation of the Pandora FMS Console, you have to access the console URL and follow the steps suggested by the installation wizard. If the console is installed on a server with the IP '10.20.34.54', you're required to enter the following URL:
+
First of all, activate certain official Redhat/Centos/Fedora repositories to perform dependency installation. The repositories to be activated are EXTRAS, UPDATES and the additional installation of the EPEL repository.
  
http://10.20.34.54/pandora_console
+
Edit /etc/yum.repos.d/CentOS-Base.repo and enable EXTRAS, and UPDATES repos. Usually it should be something similar to this:
  
=== Uninstalling Pandora FMS ===
 
  
  dpkg -r pandorafms-console-enterprise
+
  [updates]
  dpkg -r pandorafms-console
+
name=CentOS-$releasever - Updates
 +
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates
 +
gpgcheck=0
 +
 +
[extras]
 +
  name=CentOS-$releasever - Extras
 +
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=extras
 +
gpgcheck=0
  
== Installation in FreeBSD ==
+
Add the EPEL repository:
  
To install Pandora FMS server, FreeBSD 10.x or later is recommended.
+
[EPEL]
If you want to install it to FreeBSD 9.x or earlier with the following instructions, the package management system of FreeBSD should be updated to pkgng.
+
Name = EPEL
 +
baseurl = http://dl.fedoraproject.org/pub/epel/$releasever/$basearch/
 +
enabled = 1
 +
gpgcheck = 0
  
=== Previous Dependencies Installation ===
+
Please refresh your repository information with this command:
  
In FreeBSD, the dependencies are the following:
+
yum makecache
  
Server:
+
=== Installation using official Pandora FMS Repository ===
 
 
p5-DBI p5-Mail-Sendmail p5-NetAddr-IP p5-XML-Simple p5-Time-Format p5-HTML-Parser
 
p5-Net-Traceroute-PurePerl p5-IO-Socket-INET6 p5-DBD-mysql p5-XML-Twig p5-JSON
 
net-snmp nmap xprobe coreutils net-snmp wmi-client
 
  
In order to install the Pandora FMS Server, you're required to implement all the dependencies before doing so. It's recommended to do so by using pkg command.
+
YUM and access to the Internet is required. First, create a reference to the Pandora FMS official repository for CentOS 7. This also applies for the usage under RHEL7.
  
You may install all the necessary dependencies in the following way:
+
vi /etc/yum.repos.d/pandorafms.repo
 +
 +
Add these contents:
  
e.g.) p5-DBI installation.
+
[artica_pandorafms]
  pkg install p5-DBI
+
name=CentOS7 - PandoraFMS official repo
 +
baseurl=http://firefly.artica.es/centos7
 +
gpgcheck=0
 +
  enabled=1
  
Console:
 
  
apache24, php5, php5-snmp, php5-session, php5-gettext, php5-mbstring, php5-ldap,
+
Refresh your repository information:
php5-mysql, php5-gd, php5-zip, php5-zlib, php5-json, php5-curl, php5-filter, pear,
 
pear-DB, pear-XML_RPC, graphviz
 
  
In order to install the Pandora FMS Console, you will have to implement all of the previously mentioned dependencies. You may use the packages to do so.
+
yum makecache
  
{{Warning |From version 729 of Pandora FMS it is necessary to update to PHP7 for the proper functioning of the tool}}
+
And install Pandora FMS, along with the mysql server (it is an optional dependency, but MySQL server is needed if you do not have one already installed or accessible in another server).
  
=== Console Installation ===
+
yum install pandorafms_console pandorafms_server mariadb-server
  
There are no Pandora FMS Console package files for FreeBSD. The Pandora console must be installed by using the installer.
+
Download all the necessary packages and leave the system ready for configuration and use.
  
Installation via the installer is described in the section named 'Manual Installation from Sources in Linux/Unix' below.
+
{{Tip|Mariadb-server replaces the mysql-server package, but it depends on the used distro (CentOS is not the same as RHEL, one or the other must be used, being the differences almost unnoticeable when using Pandora FMS).}}
  
Under FreeBSD with apache 2.4, the Pandora FMS console directory is:
+
=== Manual Installation through RPM Files ===
  
/usr/local/www/apache24/data/pandora_console
+
Most dependencies should be resolved using YUM or another automatic tool. All dependencies are marked as required packages in the RPM definition. If you have already configured the required repositories in the previous step, this operation will be almost automatic.
  
=== Server Installation ===
+
In the case of CentOS it will be necessary to install the following dependencies:
  
There are no Pandora FMS Server package files for FreeBSD. You're required to install the Pandora Server by using the installer.
+
yum install php php-gd graphviz php-mysql php-pear-DB php-zip php-mbstring php-ldap php-snmp php-ldap php-common make perl-CPAN perl-HTML-Tree perl-DBI perl-DBD-mysql perl-libwww-perl perl-XML-Simple perl-XML-Twig perl-XML-SAX perl-NetAddr-IP net-snmp perl-SNMP net-tools perl-IO-Socket-INET6 perl-Socket6 nmap sudo xprobe2 perl-Encode-Locale php-xmlrpc libxslt php-xml
  
Installation via the installer is described in the section named 'Manual Installation from Sources in Linux / UNIX' below.
+
It is possible that if you use Fedora or Redhat the names of some packages are slightly different, so use these in addition to the previous ones:
  
The file locations and startup script structures are different from Linux. We're going to show the FreeBSD-specific procedures below.
+
yum install net-snmp-perl perl-JSON perl-NetAddr-IP perl-Socket6 \
 +
perl-Time-HiRes perl-XML-Twig perl-IO-Socket-INET6
  
After installation add the following lines to the '/etc/rc.conf' file:
+
Some dependencies (like 'wmic' or 'xprobe2') are not contained in the official RHEL repositories. They are provided on our Sourceforge download page in the "Tools and Dependecies" section [https://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29].
  
pandora_server_enable="YES"
+
In the meantime, for Red Hat Enterprise Linux 6 just install these ones, since several of the packages required for the console and server are included in the php and perl and serial dependencies:
tentacle_server_enable="YES"
 
  
These settings are required to enable Pandora, the Pandora Servers and Tentacle. Otherwise, they are '''not''' going to be launched.
+
yum install php php-common graphviz
 +
 +
yum install perl-HTML-Tree perl-DBD-mysql perl-XML-Simple perl-XML-SAX \
 +
perl-NetAddr-IP net-snmp perl-SNMP net-tools perl-IO-Socket-INET6 perl-Socket6 nmap wmic xprobe2
  
On FreeBSD, most of the Pandora server's files are gong to be installed in the directory named '/usr/local'.
+
{{Warning|If you are using a version prior to RHEL6, some dependencies could have another name. In the case of perl-SNMP, in CentOS5, RHEL5, etc, the dependency to obtain would be net-snmp-perl.}}
  
pandora_server, tentacle_server:
+
{{Warning|For versions of Pandora FMS 729 or higher, it is necessary to install the PHP7 dependencies for a correct console use}}
/usr/local/bin/pandora_server
 
/usr/local/bin/tentacle_server
 
Startup script:
 
/usr/local/etc/rc.d/pandora_server
 
/usr/local/etc/rc.d/tentacle_server
 
Configuration file:
 
/usr/local/etc/pandora/pandora_server.conf
 
util:
 
/usr/local/share/pandora_server/util/*
 
Man pages:
 
/usr/local/man/man1/*
 
Other:
 
The 'data_in' and log directories are the same as the ones under Linux.
 
  
== Installation in NetBSD ==
+
In order to install the RPM, just use the 'rpm -i' or the yum command directly:
  
From versions 5.0 and above, Pandora FMS supports the use of NetBSD.
+
rpm -i pandorafms_server-x.x-x.noarch.rpm
  
=== Previous Dependencies Installation ===
+
or
  
In NetBSD the dependencies are as follows:
+
yum install pandorafms_server-x.x-x.noarch.rpm
  
Server:
+
If you encounter any problems when you try to access the Pandora FMS Console installation web page, check whether SELinux is active: In this case, it is mandatory to deactivate it. Please follow the [[Pandora:FAQ#I_cannot_access_the_Pandora_Console_installation_web_page_in_CentOS.|FAQ]] procedures in such case.
  
mysql55-server databases/p5-DBI mail/p5-Mail-Sendmail net/p5-NetAddr-IP textproc/p5-XML-Simple
 
time/p5-Time-Format www/p5-HTML-Parser net/nmap net/p5-IO-Socket-INET6
 
database/p5-DBD-mysql textproc/p5-XML-Twig  sysutils/coreutils converters/p5-JSON net/net-snmp
 
  
In order to install the Pandora FMS Server, you are required to implement all of the dependencies (using 'pkgsrc', recommended) before doing so.
+
{{Warning|RHEL and CentOS 5.x use PHP 5.1 by default. This version is '''not''' compatible with Pandora FMS. You are required to use PHP version 5.2 or higher. Tested in php55w. For versions of Pandora FMS 729 or higher, its required to use PHP version 7.2}}
  
You may install all dependencies like this:
+
To do so, it is recommended to use the following repository for CentOS6/RHEL6, which contains PHP 5.6:
  
e.g.) p5-DBI installation.
+
[remi]
  cd /usr/pkgsrc/databases/p5-DBI
+
name=Les RPM de remi pour Enterprise Linux 6 - $basearch
  make
+
#baseurl=<nowiki>http://rpms.famillecollet.com/enterprise/6/remi/$basearch/
  make install
+
  mirrorlist=http://rpms.famillecollet.com/enterprise/6/remi/mirror</nowiki>
 +
enabled=1
 +
  gpgcheck=1
 +
  gpgkey=<nowiki>file:///etc/pki/rpm-gpg/RPM-GPG-KEY-remi</nowiki>
  
Subsequently, you're required to install 'Net::Traceroute::PurePerl' and 'LWP::Simple' using CPAN.
 
  
  perl -MCPAN -e 'install Net::Traceroute::PurePerl'
+
  [remi-php56]
  perl -MCPAN -e 'install LWP::Simple'
+
name=Les RPM de remi de PHP 5.6 pour Enterprise Linux 6 - $basearch
 +
#baseurl=<nowiki>http://rpms.famillecollet.com/enterprise/6/php56/$basearch/
 +
mirrorlist=http://rpms.famillecollet.com/enterprise/6/php56/mirror</nowiki>
 +
# WARNING: If you enable this repository, you must also enable "remi"
 +
enabled=1
 +
gpgcheck=1
 +
  gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-remi
  
'xprobe' is also required to be installed by compiling the source package.
 
  
You may download it from :
+
GPG key for remi repository can be found here: http://rpms.remirepo.net/RPM-GPG-KEY-remi
  
http://sourceforge.net/projects/xprobe/files/latest/download
+
===  Uninstalling Pandora FMS in CentOS/RHEL ===
  
If you're unable to compile it without some errors showing up, please modify the following files and try again:
+
Just execute the command
  
* Add ' '''include <cstdlib>''' ' to 'libs-external/USI++/src/ip.cc'.
+
yum remove pandorafms_console pandorafms_server
* Add ' '''include <cstdlib>''' ' to 'libs-external/USI++/src/misc.cc'.
 
* Add ' '''include <cstring>''' ' to 'libs-external/USI++/usi++/tcp.h'.
 
  
Console:
+
If MySQL is installed but it is no longer needed, it can also be deleted with the same command:
  
  www/apache22, lang/php54, net/php-snmp, www/ap-php, devel/php-gettext,
+
  yum remove mysql-server
converters/php-mbstring, databases/php-ldap, databases/php-mysql, raphics/php-gd,
 
archivers/php-zip, archivers/php-zlib, textproc/php-json, www/php-curl, lang/pear,
 
databases/pear-DB, graphics/graphviz,
 
  
In order to install the Pandora FMS Console, you're required to implement all of the dependencies before doing so. You may use 'pkgsrc' for that.
+
== Installation in Debian and Ubuntu ==
  
{{Warning |From version 729 of Pandora FMS it is necessary to update to PHP7 for the proper functioning of the tool}}
+
Installing Pandora FMS '''version 10.04 or higher''' is recommended. In Debian Stable version (Squeeze), there are problems with some libraries and applications that Pandora FMS needs for some components. Debian LWP library does not implement certain methods for SSL, and this is necessary for Enteprise modules of WEB monitoring. It can be fixed by installing a newer version of LWP using CPAN (manual method).
  
In addition, you're required to install the 'XML_RPC' using the 'pear' command as shown below.
+
When installing it, add the official repositories of each version. For example, to install the libencode-locale-perl and snmp-mibs-downloader packages in a Debian Squeeze, add the following repositories to the file named /etc/apt/sources.list
  
pear install XML_RPC
 
  
=== Console Installation ===
+
deb http://ftp.us.debian.org/debian/ squeeze main non-free
 +
deb http://ftp.at.debian.org/debian-cd/ squeeze-backports main
  
There are no Pandora FMS Console package files for NetBSD. You're required to install the pandora console by using the installer.
+
Alternatively, for Debian Wheezy:
  
How to install it by the installer is described in the section named 'Manual Installation from Sources in Linux/Unix' below.
+
deb http://ftp.debian.org/debian/dists/Debian9.6/ wheezy-backports main
 +
deb http://ftp.us.debian.org/debian/ wheezy main non-free
  
On NetBSD with apache 2.2, the Pandora FMS Console directory is the one mentioned below.
+
Once they have been added, execute 'apt-get update' to apply the changes.
  
/usr/pkg/share/httpd/htdocs/pandora_console
+
Due to the way in which Debian/Ubuntu manages the packages, it is more than recommended to install Pandora FMS in a system that has access to the online package repositories (or a replica in the local network). A dependency on Debian can involve dozens of sub-dependencies, so preparing an accurate list of packages needed for offline installation can be a very complex task.
  
=== Server Installation ===
+
=== Installation with Artica Private Repository ===
  
There are no Pandora FMS Server package files for NetBSD. Install the Pandora server by using the installer.
+
There is also a much quicker and easier method: just add the Artica Private Repository. It contains any and all the Ubuntu and Debian packages you might require.
  
Installation via the installer is described in the section named 'Manual Installation from Sources in Linux/Unix' below.
+
In order to do so, edit the file '/etc/apt/sources.list' and add the following line:
  
The file locations and startup script structures are different from the one under Linux. We're going to show the NetBSD specific procedures below.
+
For Debian Squeeze:
  
After the installation, you're required to add the following lines to the '/etc/rc.conf':
+
deb http://firefly.artica.es/debian/squeeze /
  
pandora_server="YES"
+
For Debian Wheezy:
tentacle_server="YES"
 
  
To enable the Pandora Servers, Pandora and Tentacle, these settings are required. Otherwise, they are '''not''' going to be launched.
+
deb http://firefly.artica.es/debian/wheezy /
  
On NetBSD, most of the Pandora FMS Server files are installed under '/usr/local'.
+
Execute as root (sudo)
  
pandora_server, tentacle_server:
+
  apt-get update
  /usr/local/bin/pandora_server
 
/usr/local/bin/tentacle_server
 
  
Startup script:
+
Installation of Pandora FMS by apt-get:
/etc/rc.d/pandora_server
 
/etc/rc.d/tentacle_server
 
  
Configuration file:
+
<pre>
/usr/local/etc/pandora/pandora_server.conf
+
[email protected]:~# apt-get install pandorafms-console pandorafms-server pandorafms-agent-unix
util:
+
Reading package lists... Done
/usr/local/share/pandora_server/util/*
+
Building dependency tree     
 
+
Reading state information... Done
Man pages:
+
The following extra packages will be installed:
/usr/share/man/man1/*
+
  apache2-mpm-prefork apache2-utils apache2.2-common dbconfig-common graphviz libapache2-mod-php5 libcgraph5 libcurl3 libgd2-xpm libgvpr1
 +
  libio-socket-inet6-perl libnetaddr-ip-perl libonig2 libqdbm14 libsnmp-perl libsocket6-perl libssh2-1 libtime-format-perl
 +
  libxml-namespacesupport-perl libxml-sax-expat-perl libxml-sax-perl libxml-simple-perl nmap php-db php-gettext php-pear php5 php5-cli php5-common
 +
  php5-curl php5-gd php5-ldap php5-mysql php5-snmp php5-suhosin php5-xmlrpc smistrip snmp snmp-mibs-downloader snmpd xprobe
 +
Suggested packages:
 +
  apache2-doc apache2-suexec apache2-suexec-custom graphviz-doc libgd-tools php5-dev
 +
The following packages will be REMOVED:
 +
  libgd2-noxpm
 +
The following NEW packages will be installed:
 +
  apache2-mpm-prefork apache2-utils apache2.2-common dbconfig-common graphviz libapache2-mod-php5 libcgraph5 libcurl3 libgd2-xpm libgvpr1
 +
  libio-socket-inet6-perl libnetaddr-ip-perl libonig2 libqdbm14 libsnmp-perl libsocket6-perl libssh2-1 libtime-format-perl
 +
  libxml-namespacesupport-perl libxml-sax-expat-perl libxml-sax-perl libxml-simple-perl nmap pandorafms-agent-unix pandorafms-console
 +
  pandorafms-server php-db php-gettext php-pear php5 php5-cli php5-common php5-curl php5-gd php5-ldap php5-mysql php5-snmp php5-suhosin php5-xmlrpc
 +
  smistrip snmp snmp-mibs-downloader snmpd xprobe
 +
0 upgraded, 44 newly installed, 1 to remove and 0 not upgraded.
 +
Need to get 40.9 MB of archives.
 +
After this operation, 90.8 MB of additional disk space will be used.
 +
Do you want to continue [Y/n]? y
 +
WARNING: The following packages cannot be authenticated!
 +
  pandorafms-agent-unix pandorafms-console pandorafms-server
 +
Install these packages without verification [y/N]? y
 +
</pre>
  
Other:
+
{{Warning|For versions of Pandora FMS 729 or higher, it is necessary to install the dependencies of PHP7 for a correct use of the console}}
The 'data_in' and log directories are the same as the ones under Linux.
 
  
== Manual Installation from Sources under Linux / UNIX / MAC OS ==
+
=== Manual Installation by DEB Packages ===
  
It will be necessary to download the files in "tarball" format (. tar. gz,. tgz or. tar. bz2) and unzip it. To do this, locate the latest version of Pandora FMS and download the files from here: https://sourceforge.net/projects/pandora/files/.
+
Under Debian or Ubuntu, the dependencies are the following:
  
 +
Server:
 +
 +
snmp snmpd libtime-format-perl libxml-simple-perl libdbi-perl libnetaddr-ip-perl
 +
libhtml-parser-perl wmi-client xprobe2 nmap traceroute
 +
libio-socket-inet6-perl libhtml-tree-perl libsnmp-perl snmp-mibs-downloader
 +
libio-socket-multicast-perl libsnmp-perl libjson-perl libencode-locale-perl
  
=== Console Installation ===
 
  
Once you've opened the console zip file, please follow these steps:
+
{{Tip|If the 'wmi-client' package is not available in the repositories, download it from the [http://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20(All%20versions)/DEB%20Debian,%20Ubuntu/ Pandora FMS Sourceforge website.]}}
  
1. Acquire root privileges by entering:
+
{{Tip|If you are installing Pandora FMS in a Debian Squeeze, add the "Non-Free" repository to access the snmp-mibs-downloader package.}}
  
su -
+
Console:
  
2. Copy to '/tmp' and execute:
+
php5 libapache2-mod-php5 apache2 mysql-server php5-gd php5-mysql php-pear php5-snmp php-db php-gettext
 +
graphviz mysql-client php5-curl php5-xmlrpc php5-ldap
  
tar xvzf pandorafms_console-X.Y.tar.gz
+
{{Warning|For versions of Pandora FMS 729 or higher, it is necessary to install the dependencies of PHP7 for a correct use of the console}}
cd pandora_console
 
./pandora_console_install --install
 
  
=== Server Installation ===
+
In order to install the Server package or the console, implement all of the required dependencies. This is done by installing all the previously mentioned packages by using the command ''apt-get'' along with root privileges:
  
Once you've opened the server zip file named 'pandorafms_server-3.0.0.tar.gz' or similar, please follow the below mentioned steps:
+
apt-get install  snmp snmpd libtime-format-perl libxml-simple-perl libxml-twig-perl libdbi-perl
 +
libnetaddr-ip-perl libhtml-parser-perl wmi-client xprobe2 nmap libmail-sendmail-perl traceroute
 +
libio-socket-inet6-perl libhtml-tree-perl libsnmp-perl snmp-mibs-downloader libio-socket-multicast-perl
 +
libsnmp-perl libjson-perl php5 libapache2-mod-php5 apache2 mysql-server php5-gd php5-mysql php-pear
 +
php5-snmp php-db php-gettext graphviz mysql-client php5-curl php5-xmlrpc php5-ldap dbconfig-common
  
1. We acquire root privileges:
 
  
su -
+
This command will install all the dependencies required to install the Pandora FMS Server and its console into a Debian or Ubuntu system.
 +
                   
 +
Installation with the DEB packages is very easy.
  
2. We copy it to '/tmp' and execute:
+
If there is no internet connection, install the dependencies. Then install the Pandora FMS packages, in this example all Pandora FMS components are installed together.
  
  tar xvzf pandorafms_server-X.Y.tar.gz
+
  dpkg -i pandorafms-console_xxx.deb pandorafms-server_xxxx.deb
cd pandora_server
 
./pandora_server_installer --install
 
  
If you're experiencing any dependency-related problems, you're required to rectify them before attempting any installation. We might be able to force the installation and ignore the problems with the dependencies, but Pandora FMS wouldn't work properly in this case.
+
Once the command has been executed, you might see that some dependencies are missing. If so, you can try to solve it automatically by using the following command:
  
=== Server Manual Installation (from source code) ===
+
apt-get -f install
  
Alternatively to the generic installation script, you can "compile" the Pandora FMS code through the Perl interpreter of your system. This process simply installs the minimum libraries and executables, but does not alter the boot scripts system, maintenance scripts, configuration or anything else that strictly concerns the application and its libraries. This process is indicated when you have to update the server code, but without overwriting its configuration.
+
This will attempt to download all the necessary missing packages from the automated installation of Pandora FMS on the system. Once the necessary packages have been installed, continue with the installation of all Pandora FMS components.
  
To do this, unzip your server code to /tmp, as described in the previous step.
+
{{Warning|In some Ubuntu versions you must move the /var/www/pandora_console/ directory to the public directory of the web server by default /var/www/html/pandora_console }}
  
1. We acquire root privileges:
+
In order to complete the installation of the Pandora FMS Console, access the console URL and follow the steps suggested by the installation wizard. If the console is installed on a server with the IP '10.20.34.54', enter the following URL:
  
  su -
+
  <nowiki>http://10.20.34.54/pandora_console</nowiki>
  
2. We copy it to '/tmp' and in there, we execute:
+
=== Uninstalling Pandora FMS ===
  
  tar xvzf pandorafms_server-X.Y.tar.gz
+
  dpkg -r pandorafms-console-enterprise
  cd pandora_server
+
  dpkg -r pandorafms-console
perl Makefile.PL
 
make
 
make install
 
  
If any dependency is missing or there is another problem, the system will warn you. If you see a message similar to:
+
== Installation in FreeBSD ==
  
Warning: prerequisiete Mail::Sendmail 0 not found
+
To install Pandora FMS server, FreeBSD 10.x or later is recommended.
Warning: prerequisiete Net::Traceroute::PurePerl 0 not found
+
If you want to install it to FreeBSD 9.x or earlier with the following instructions, the package management system of FreeBSD should be updated to pkgng.
  
It means that there are some Perl packages that Pandora FMS needs and that the system doesn't have installed. Check the previous paragraphs to know how to install the necessary dependencies to be able to install Pandora FMS. However, you can temporarily ignore these warnings (that's why they are warnings and not errors) and force the installation. You are sure to have problems at one time or another as you are missing a component needed to function. However, if you know that the component that is not installed will not be used (e. g. traceroute is used exclusively for Pandora FMS Recon Server), you can continue with no poblems.
+
=== Previous Dependencies Installation ===
  
After this process, these files are automatically copied:
+
In FreeBSD, the dependencies are the following:
  
/usr/local/bin/pandora_server
+
Server:
/usr/local/bin/pandora_exec
 
  
And several. pm files (Perl libraries) that Pandora FMS needs. Those. pm libraries are copied to different directories, depending on the version of your distribution and distribution. For example in Ubuntu 9.04 they are copied to:
+
p5-DBI p5-Mail-Sendmail p5-NetAddr-IP p5-XML-Simple p5-Time-Format p5-HTML-Parser
 +
p5-Net-Traceroute-PurePerl p5-IO-Socket-INET6 p5-DBD-mysql p5-XML-Twig p5-JSON
 +
net-snmp nmap xprobe coreutils net-snmp wmi-client
  
/usr/local/share/perl/5.10.0/PandoraFMS/
+
In order to install the Pandora FMS Server, implement all the dependencies before doing so. It is recommended to do so by using pkg command.
  
In SUSE/SLES 11 they're copied to:
+
You may install all the necessary dependencies in the following way:
  
/usr/lib/perl5/site_perl/5.10.0/PandoraFMS/
+
e.g.) p5-DBI installation.
 +
pkg install p5-DBI
  
== Installing the Enterprise Version ==
+
Console:
  
To install the Enterprise version of Pandora FMS, we have to install the packages "Open" of the Console and Server, and then add the packages "Enterprise" of each one. In the case of the '''Console''' we will use one package or another, depending on the distribution we have installed.
+
apache24, php5, php5-snmp, php5-session, php5-gettext, php5-mbstring, php5-ldap,
 +
php5-mysql, php5-gd, php5-zip, php5-zlib, php5-json, php5-curl, php5-filter, pear,
 +
pear-DB, pear-XML_RPC, graphviz
  
=== Enterprise Console Installation ===
+
In order to install the Pandora FMS Console, implement all of the previously mentioned dependencies. You may use the packages to do so.
  
For Red Hat Enterprise Linux / CentOS / Fedora:
+
{{Warning|From Pandora FMS version 729 onwards, PHP7 is needed for the console to work.}}
  
rpm -i pandorafms_console_enterprise-X.X.noarch.rpm
+
=== Console Installation ===
  
For SUSE:
+
There are no Pandora FMS Console package files for FreeBSD. The Pandora FMS console must be installed by using the installer.
  
rpm -i pandorafms_console_enterprise-X.X.noarch.rpm
+
Installation via the installer is described in the section named 'Manual Installation from Sources in Linux/Unix' below.
  
For Debian / Ubuntu:
+
Under FreeBSD with apache 2.4, the Pandora FMS console directory is:
  
  dpkg -i pandorafms_console_enterprise_xxx.deb
+
  /usr/local/www/apache24/data/pandora_console
  
To install the Enterprise Console by using the source code:
+
=== Server Installation ===
  
Once you've opened the console and arrived at the location of the compressed file named 'pandorafms_console-X.X.tar.gz' or similar, please follow the below mentioned steps:
+
There are no Pandora FMS Server package files for FreeBSD. You are required to install the Pandora FMS Server by using the installer.
  
1. We acquire root privileges by entering:
+
Installation via the installer is described in the section named 'Manual Installation from Sources in Linux / UNIX' below.
  
su -
+
The file locations and startup script structures are different from Linux. The FreeBSD-specific procedures are shown below.
  
2. Copy it to '/tmp' and in there execute:
+
After installation, add the following lines to the '/etc/rc.conf' file:
  
  tar xvzf pandorafms_console-X.Xtar.gz
+
  pandora_server_enable="YES"
 +
tentacle_server_enable="YES"
  
Then, please copy it to the directory in which your Pandora FMS open-source console is installed. It's either '/var/www/pandora_console' for Debian or Ubuntu, or '/srv/www/htdocs/pandora_console/' for SUSE, RH, Fedora, etc. (or any other directory, depending on your distribution).  
+
These settings are required to enable Pandora FMS, Pandora FMS Servers and Tentacle. Otherwise, they are '''not''' going to be launched.
  
Debian:
+
On FreeBSD, most of the Pandora FMS server's files are going to be installed in the directory named '/usr/local'.
  
  cp -R enterprise /var/www/pandora_console
+
pandora_server, tentacle_server:
 +
  /usr/local/bin/pandora_server
 +
/usr/local/bin/tentacle_server
 +
Startup script:
 +
/usr/local/etc/rc.d/pandora_server
 +
/usr/local/etc/rc.d/tentacle_server
 +
Configuration file:
 +
/usr/local/etc/pandora/pandora_server.conf
 +
util:
 +
/usr/local/share/pandora_server/util/*
 +
Man pages:
 +
/usr/local/man/man1/*
 +
Other:
 +
The 'data_in' and log directories are the same as the ones under Linux.
  
SUSE:
+
== Installation in NetBSD ==
  
cp -R enterprise /srv/www/htdocs/pandora_console
+
From versions 5.0 and above, Pandora FMS supports the use of NetBSD.
  
3. Just change the permissions in case the files are intended to get used by the web server's user, e.g.:
+
=== Previous Dependencies Installation ===
  
Debian:
+
In NetBSD, the dependencies are as follows:
  
chown -R www-data /var/www/pandora_console/enterprise
+
Server:
  
SUSE:
+
mysql55-server databases/p5-DBI mail/p5-Mail-Sendmail net/p5-NetAddr-IP textproc/p5-XML-Simple
 +
time/p5-Time-Format www/p5-HTML-Parser net/nmap net/p5-IO-Socket-INET6
 +
database/p5-DBD-mysql textproc/p5-XML-Twig  sysutils/coreutils converters/p5-JSON net/net-snmp
  
chown -R wwwrun /srv/www/htdocs/pandora_console/enterprise
+
In order to install the Pandora FMS Server, implement all of the dependencies (using 'pkgsrc', recommended) before doing so.
  
It's recommended to conduct the [[Pandora:Documentation en:Installing#License_Application | License Activation]] at this point.
+
You may install all dependencies like this:
  
=== Enterprise Server Installation ===
+
e.g.) p5-DBI installation.
 +
cd /usr/pkgsrc/databases/p5-DBI
 +
make
 +
make install
  
First make sure the Open version of the server is installed. Then proceed to install the enterprise version in order to install the Enterprise '''Server.'''
+
Next, install 'Net::Traceroute::PurePerl' and 'LWP::Simple' using CPAN.
  
Once you have the zip file with the server, named pandorafms_server_enterprise-X. X. tar. gz or similar, please follow the below mentioned steps:  
+
perl -MCPAN -e 'install Net::Traceroute::PurePerl'
 +
perl -MCPAN -e 'install LWP::Simple'
  
1. Acquire root privileges:
+
'xprobe' is also required to be installed by compiling the source package.
  
su -
+
You may download it from :
  
2. Copy it to '/tmp' and execute:
+
http://sourceforge.net/projects/xprobe/files/latest/download
  
tar xvzf pandorafms_server_enterprise-X.X.tar.gz
+
If you are unable to compile it without some errors showing up, modify the following files and try again:
cd pandora_server/
 
# ./pandora_server_installer --install
 
  
If the Pandora FMS Server Binary isn't contained in the default directory '/usr/bin', you'll have to indicate the directory as follows:
+
* Add ' '''include <cstdlib>''' ' to 'libs-external/USI++/src/ip.cc'.
 +
* Add ' '''include <cstdlib>''' ' to 'libs-external/USI++/src/misc.cc'.
 +
* Add ' '''include <cstring>''' ' to 'libs-external/USI++/usi++/tcp.h'.
  
# PREFIX=/usr/local ./pandora_server_installer --install
+
Console:
  
After installing, the server is going to restart (/etc/init.d/pandora_server restart). Subsequently, the Enterprise Servers are going to be shown as enabled.
+
www/apache22, lang/php54, net/php-snmp, www/ap-php, devel/php-gettext,
 +
converters/php-mbstring, databases/php-ldap, databases/php-mysql, raphics/php-gd,
 +
archivers/php-zip, archivers/php-zlib, textproc/php-json, www/php-curl, lang/pear,
 +
databases/pear-DB, graphics/graphviz,  
  
{{Warning|Do not restart the server until the Pandora FMS Enteprise license key installation is complete, otherwise the server will not start and your monitoring service will be interrupted.}}
+
In order to install Pandora FMS Console, implement all of the dependencies before doing so. You may use 'pkgsrc' for that.
  
<center>
+
{{Warning |From version 729 of Pandora FMS it is necessary to update to PHP7 for the proper functioning of the tool}}
[[image:Pandora_server_view.png | 800px]]
 
</center>
 
  
==== Installing to a different path ====
+
In addition, install the 'XML_RPC' using the 'pear' command as shown below.
  
To install the Pandora FMS Server to a different path, specify it with the ''--destdir'' option:
+
pear install XML_RPC
  
./pandora_server_installer --install --destdir <path>
+
=== Console Installation ===
  
After the installation, you should manually configure your Pandora FMS to run at startup and configure the database maintenance script, ''pandora_db'', to run periodically. For example, on Linux (replace ''<destdir>'' with the actual path passed to ''--destdir''):
+
There are no Pandora FMS Console package files for NetBSD. Install the Pandora FMS console by using the installer.
  
ln -s <destdir>/etc/init.d/pandora_server /etc/init.d/
+
How to install it by means of the installer is described in the section named 'Manual Installation from Sources in Linux/Unix' below.
echo "\"<destdir>/usr/share/pandora_server/util/pandora_db\" \
 
\"<destdir>/etc/pandora/pandora_server.conf\" >/dev/null 2>&1" > /etc/cron.hourly/pandora_db
 
  
==== Running as a non-privileged user ====
+
On NetBSD with apache 2.2, the Pandora FMS Console directory is the one mentioned below.
  
To make the Pandora FMS server run as a non-privileged user, install it as the user you want it to run as with the ''--no-root'' option:
+
/usr/pkg/share/httpd/htdocs/pandora_console
  
./pandora_server_installer --install --no-root
+
=== Server Installation ===
  
==== Installing with a non-privileged user ====
+
There are no Pandora FMS Server package files for NetBSD. Install the Pandora FMS server by using the installer.
  
''--no-root'' can be combined with ''--destdir'' to install the Pandora FMS server with an unprivileged user, as long as this user has write permissions on the path passed to ''--destdir''. For example:
+
Installation via the installer is described in the section named 'Manual Installation from Sources in Linux/Unix' below.
  
./pandora_server_installer --install --no-root --destdir /opt/pandora
+
File locations and startup script structures are different from the ones under Linux. NetBSD specific procedures are shown below.
  
== Server and Console Installation in Windows ==
+
After installation, add the following lines to '/etc/rc.conf':
  
From Pandora FMS versions 5.1 and above, there is a Windows installer which allows us to install: '''Nginx''', '''PHP''', '''MySQL''', '''Pandora FMS''' and some dependencies necessary for the server and console operation under Windows.
+
pandora_server="YES"
 +
tentacle_server="YES"
  
<br><br>
+
To enable the Pandora FMS Servers, Pandora FMS and Tentacle, these settings are required. Otherwise, they will '''not''' be launched.
{{Warning|Pandora FMS Console & server setup in '''Windows''' is not recommended for production systems, due to inferior performance compared to Linux. We are working to make it more stable and faster in future versions .}}
 
<br><br>
 
{{Warning |From version 729 of Pandora FMS it is necessary to update to PHP7 for the proper functioning of the tool}}
 
  
Some features of the Pandora FMS server rely on a Linux-based operating system and do not work on Windows:
+
On NetBSD, most of the Pandora FMS Server files are installed under '/usr/local'.
  
* [[Pandora:Documentation_en:Recon_Server#Recon_Scripts|Recon scripts]]
+
pandora_server, tentacle_server:
* [[Pandora:Documentation_en:IPAM|IPAM]]
+
/usr/local/bin/pandora_server
* [[Pandora:Documentation_en:UX_Monitoring|UX monitoring]]
+
/usr/local/bin/tentacle_server
* [[Pandora:Documentation_en:Transactional_Monitoring|Transactional monitoring]]
 
* [[Pandora:Documentation_en:Netflow|Netflow]]
 
* [[Pandora:Documentation_en:Remote_Monitoring#Monitoring_with_Plug_Ins_.28Server_Plugin.29|Server plug-ins]]. The default plug-ins are Linux scripts. You could, however, write your own scripts for Windows.
 
* [[Pandora:Documentation_en:Virtual_environment_monitoring#VMware|VMware plug-in]]
 
* [[Pandora:Documentation_en:Inventory|Remote inventory]]
 
* [[Pandora:Documentation_en:Log_Monitoring|Log monitoring]]
 
  
It is delivered as an installer in executable format (. exe) and for its basic installation you
+
Startup script:
only have to accept all the options listed below.  
+
/etc/rc.d/pandora_server
 +
/etc/rc.d/tentacle_server
  
Please select the language:
+
Configuration file:
 +
/usr/local/etc/pandora/pandora_server.conf
 +
util:
 +
/usr/local/share/pandora_server/util/*
  
<center>
+
Man pages:
[[image:Pandora_agent_3.0_RC3_install_windows_01_eng.png]]
+
/usr/share/man/man1/*
</center>
 
  
Please follow the installer steps:
+
Other:
 +
The 'data_in' and log directories are the same as the ones under Linux.
  
<center>
+
== Manual Installation from Sources under Linux / UNIX / MAC OS ==
[[image:Pandora_server_install_windows_011.png]]
 
</center>
 
  
Please accept the license terms:
+
It will be necessary to download the files in "tarball" format (. tar. gz,. tgz or. tar. bz2) and unzip them. To do it, locate the latest version of Pandora FMS and download the files from here: https://sourceforge.net/projects/pandora/files/.
  
<center>
 
[[image:Pandora_server_install_windows_021.png]]
 
</center>
 
  
Please select the components to install:
+
=== Console Installation ===
  
<center>
+
Once you have opened the console zip file, follow these steps:
[[image:Pandora_server_install_windows_031.png]]
 
</center>
 
  
{{Warning|If you have a previous version of the Console and the Server already installed and you want an update, check '''only''' the 'Update installed version' option.}}
+
1. Acquire root privileges by entering:
  
{{Tip|Nginx is a web server that replaces Apache, which was used in previous versions. This new server uses PHP with FastCGI, improving the Console performance.}}
+
su -
  
This installer is mainly prepared for an installation on a computer which doesn't have an already installed Nginx or MySQL. In case you have any other web server, such as IIS: it can be enabled, although you're required to disable it in order to work through Nginx.
+
2. Copy to '/tmp' and execute:
  
If you have a MySQL Server installed and running on the computer before installing the remaining components of Pandora FMS, you will have to modify the MySQL root password, for "pandora". This change is necessary in order for the database to be created which has to be able to assign permissions to the Pandora FMS Database correctly. Once you've installed Pandora FMS on your computer, please feel free to replace the password.
+
tar xvzf pandorafms_console-X.Y.tar.gz
 +
cd pandora_console
 +
./pandora_console_install --install
  
After selecting the components to install, you're required to specify the installation path:
+
=== Server Installation ===
  
 +
Once you have opened the server zip file named 'pandorafms_server-3.0.0.tar.gz' or similar, follow the steps described below:
  
<center>
+
1. Acquire root privileges:
[[image:Pandora_server_install_windows_041.png]]
 
</center>
 
  
The components are going to be installed. The only component which requires a user validation is Nginx. It will ask for the Pandora FMS server's name or IP address:
+
su -
  
<center>
+
2. Copy it to '/tmp' and execute:
[[image:Pandora_server_install_windows_051.png]]
 
</center>
 
  
 +
tar xvzf pandorafms_server-X.Y.tar.gz
 +
cd pandora_server
 +
./pandora_server_installer --install
  
As denoted above, other components are installed besides MySQL and Nginx. In case they are already installed, you may see a message like this:
+
If you experience any dependency-related problems, fix them before attempting any installation. It might be possible to force the installation and ignore the problems with the dependencies, but Pandora FMS will not work properly in that case.
  
<center>
+
=== Server Manual Installation (from source code) ===
[[image:Pandora_server_install_windows_06.png]]
 
</center>
 
  
Please remember that Microsoft Visual C++ is required for the modules to work properly.
+
Alternatively to the general installation script, you can "compile" the Pandora FMS code through the Perl interpreter of your system. This process simply installs the minimum libraries and executables, but does not alter the boot script system, maintenance scripts, configuration or anything else that strictly concerns the application and its libraries. This process is recommended when the server code must be updated, but without overwriting its configuration.
  
<center>
+
To do it properly, unzip your server code to /tmp, as described in the previous step.
[[image:Pandora_server_install_windows_06_21.png]]
 
</center>
 
  
Nginx requires '''Microsoft Visual C++ 2012''', while if you are running a '''Windows 2008 Professional R2''' system, you will need to install '''Microsot Visual C++ 2008'''.  Installing '''Microsoft Visual C++ 2010 SP1 Redistributable Package''' might be required as well for Nmap and the ICMP Enterprise Server to work properly.
+
1. Acquire root privileges:
  
 +
su -
  
'''Microsoft Visual C++ 2008'''
+
2. Copy it to '/tmp' and once there, execute:
  
https://www.microsoft.com/en-us/download/details.aspx?id=29
+
tar xvzf pandorafms_server-X.Y.tar.gz
 +
cd pandora_server
 +
perl Makefile.PL
 +
make
 +
make install
  
 +
If any dependency is missing or there is another problem, the system will warn you. If you see a message similar to:
  
'''Microsoft Visual C++ 2010 SP1 Redistributable Package'''
+
Warning: prerequisiete Mail::Sendmail 0 not found
 +
Warning: prerequisiete Net::Traceroute::PurePerl 0 not found
  
https://www.microsoft.com/en-us/download/details.aspx?id=8328
+
It means that there are some Perl packages that Pandora FMS needs and that the system does not have them installed. Check the previous paragraphs to know how to install the necessary dependencies to be able to install Pandora FMS. However, you can temporarily ignore these warnings (that is why they are warnings and not errors) and force the installation. But you will surely have problems at one time or another since you are missing a component needed to function. However, if you know that the component that is not installed will not be used (e. g. traceroute is used exclusively for Pandora FMS Recon Server), you can continue without any problem.
  
 +
After this process, these files are automatically copied:
  
'''Visual C++ 2012 (Update 4)'''
+
/usr/local/bin/pandora_server
 +
/usr/local/bin/pandora_exec
  
https://www.microsoft.com/en-US/download/details.aspx?id=30679
+
And several. pm files (Perl libraries) that Pandora FMS needs. Those. pm libraries are copied to different directories, depending on the version of your distribution and distribution. For example in Ubuntu 9.04 they are copied to:
  
'''Visual C++ 2015 '''
+
/usr/local/share/perl/5.10.0/PandoraFMS/
  
https://www.microsoft.com/es-es/download/details.aspx?id=48145
+
In SUSE/SLES 11 they are copied to:
  
Please wait until the files are copied and all the setup-related settings are carried out.
+
/usr/lib/perl5/site_perl/5.10.0/PandoraFMS/
  
<center>
+
== Installing the Enterprise Version ==
[[image:Pandora_server_install_windows_071.png]]
 
</center>
 
  
Until the installation is complete as shown below.
+
To install the Enterprise version of Pandora FMS, install the packages "Open" of the Console and Server, and then add the packages "Enterprise" of each one. In the case of the '''Console''' use one package or another, depending on the installed distribution.
  
<center>
+
=== Enterprise Console Installation ===
[[image:Pandora_server_install_windows_081.png]]
 
</center>
 
  
Once completed the browser on the login screen will open automatically. In case Enterprise Version is installed, you're going to be asked for the license code which will be provided from Artica for implementation. Except for the Enterprise Version, the server is installed as a service and starts automatically during the installation process. If the installation of the Enterprise Version has been completed with no valid license code, the server is not going to boot.
+
For Red Hat Enterprise Linux / CentOS / Fedora:
  
In order to quickly start the process, please click on 'Start' and 'Programs'.
+
rpm -i pandorafms_console_enterprise-X.X.noarch.rpm
  
<center>
+
For SUSE:
[[image:Pandora_server_install_windows_091.png]]
+
 
</center>
+
rpm -i pandorafms_console_enterprise-X.X.noarch.rpm
  
Once the service is running properly, a ready-to-use console with all the servers is going to appear as shown on the picture below.
+
For Debian / Ubuntu:
  
 +
dpkg -i pandorafms_console_enterprise_xxx.deb
  
<center>
+
To install the Enterprise Console by using the source code:
[[image:Pandora_server_install_windows_101.png|800px]]
 
</center>
 
  
 +
Once you have opened the console and arrived at the location of the compressed file named 'pandorafms_console-X.X.tar.gz' or similar, follow the steps mentioned bellow:
  
=== Operation WMI modules in some Windows versions ===
+
1. Acquire root privileges by entering:
  
For security reasons, some Windows versions have limited users who can remotely query WMI. If these modules are not carried out, the solution is to run the service Satellite Server as an Administrator user.
+
su -
  
The process to follow is:
+
2. Copy it to '/tmp' and then execute:
  
Open the services:
+
tar xvzf pandorafms_console-X.Xtar.gz
  
<center>
+
Later, copy it to the directory in which your Pandora FMS open-source console is installed. It must be either '/var/www/pandora_console' for Debian or Ubuntu, or '/srv/www/htdocs/pandora_console/' for SUSE, RH, Fedora, etc. (or any other directory, depending on your distribution).
[[File:Instalacion windows7e.png|400px]]
 
</center>
 
  
Right click on the service and enter in Properties
+
Debian:
  
<center>
+
cp -R enterprise /var/www/pandora_console
[[File:Instalacion windows8e.png|700px]]
+
 
</center>
+
SUSE:
  
On the Log On window, select an account with Administrator permissions and apply changes:
+
cp -R enterprise /srv/www/htdocs/pandora_console
  
<center>
+
3. Just change the permissions in case the files are intended to get used by the web server user, e.g.:  
[[File:Instalacion windows9e.png|500px]]
 
</center>
 
  
And after these changes, restart the service.
+
Debian:
  
=== Folders to consider in Windows ===
+
chown -R www-data /var/www/pandora_console/enterprise
  
There are a set of directories you need to set correctly in Pandora FMS Setup, which are:
+
SUSE:
  
- Remote Config directory
+
chown -R wwwrun /srv/www/htdocs/pandora_console/enterprise
  
- Attachment store
+
It is recommended to conduct the [[Pandora:Documentation en:Installing#License_Application | License Activation]] at this point.
  
<center>
+
=== Enterprise Server Installation ===
[[image:Path_windows.png|800px]]
 
</center>
 
  
- Server logs directory
+
First, make sure the Open version of the server is installed. Then proceed to install the enterprise version in order to install the Enterprise '''Server.'''
  
<center>
+
Once you have the zip file with the server, named pandorafms_server_enterprise-X. X. tar. gz or similar, follow the steps mentioned below:  
[[image:Path_windows2.png|800px]]
 
</center>
 
  
- Graphviz binary directory
+
{{Warning|We are working on a pilot version that will include upgrades in the Enterprise server. From 738 update on, it is advised to use Pandora FMS Enterprise server version E7. Version E6 should only be used in case of compatibility issues.}}
  
<center>
 
[[image:Path_windows3.png|800px]]
 
</center>
 
  
 +
1. Acquire root privileges:
  
{{Warning|It has been observed that it is necessary to install '''Microsoft Visual C++ 2008'''  in '''Windows 2008 Professional R2''' for the proper operation of Apache.}}
+
  su -
  
'''Microsoft Visual C++ 2008'''<br>
+
2. Copy it to '/tmp' and execute:
http://www.microsoft.com/es-es/download/details.aspx?id=29<br><br>
 
  
= Initial Configuration after Installation =
+
tar xvzf pandorafms_server_enterprise-X.X.tar.gz
 +
cd pandora_server/
 +
# ./pandora_server_installer --install
  
Post-installation order is:
+
If the Pandora FMS Server Binary is not contained in the default directory '/usr/bin', indicate the directory as follows:
  
# Create the database through the Pandora FMS web console installation wizard.
+
# PREFIX=/usr/local ./pandora_server_installer --install
# Modify the server configuration including access credentials to the databases generated by the previous step.
 
#Boot the server.
 
#Start local agent (if needed).
 
#Access Pandora FMS console for the first time to start using Pandora FMS.
 
  
==Tuning the settings in CentOS7==
+
After installing, restart the server (/etc/init.d/pandora_server restart). Then, the Enterprise Servers will be shown as enabled.
  
CentOS 7 is a good Linux distribution but it has its small details that we will try here briefly, which will make it easier to install Pandora FMS:
+
{{Warning|Do not restart the server until the Pandora FMS Enterprise license key installation is completed, otherwise the server will not start and your monitoring service will be interrupted.}}
  
CentOS 7 doesn't install ifconfig, to install it :
+
<center>
 +
[[image:Pandora_server_view.png | 800px]]
 +
</center>
  
  yum install net-tools
+
==== Installing on a different path ====
  
CentOS has a very aggressive firewall, and we need to disable it (later you can secure the server if needed):
+
To install the Pandora FMS Server on a different path, specify it with the ''--destdir'' option:
  
  systemctl disable firewalld
+
./pandora_server_installer --install --destdir <path>
  systemctl stop firewalld
 
  
CentOS 7 also has SELinux enabled by default, to disable it:
+
After the installation, configure the Pandora FMS server manually to run at startup and configure the database maintenance script, ''pandora_db'', to run periodically. For example, on Linux (replace ''<destdir>'' with the actual path passed to ''--destdir''):
  
  setenforce 0
+
ln -s <destdir>/etc/init.d/pandora_server /etc/init.d/
  sed -i 's/enforcing/disabled/g' /etc/selinux/config /etc/selinux/config
+
echo "\"<destdir>/usr/share/pandora_server/util/pandora_db\" \
 +
\"<destdir>/etc/pandora/pandora_server.conf\" >/dev/null 2>&1" > /etc/cron.hourly/pandora_db
  
We program both the WEB server and the database server for booting:
+
==== Running as a non-privileged user ====
  
  systemctl start httpd.service
+
To make the Pandora FMS server run as a non-privileged user, install it as the user you want it to run as with the ''--no-root'' option:
  systemctl enable httpd.service
 
  systemctl enable mariadb.service
 
  
We remove the private tmp fromt the systemd in Apache:
+
  ./pandora_server_installer --install --no-root
  
sed -i 's/PrivateTmp=true/PrivateTmp=false/g' /etc/systemd/system/multi-user.target.wants/httpd.service
+
==== Installing with a non-privileged user ====
  
== Initial Console Configuration ==
+
''--no-root'' can be combined with ''--destdir'' to install the Pandora FMS server with an unprivileged user, as long as this user has write permissions on the path passed to ''--destdir''. For example:
  
We're assuming all components (Database, Console, Server and Agent) will be executed on the same machine. If you haven't done it already, start the MySQL server and create an Admin password (root).
+
  ./pandora_server_installer --install --no-root --destdir /opt/pandora
  
/etc/init.d/mysql start
+
==== Phantomjs / PDF reports special install ====
  
Or, depending on the Linux version:
+
'''Phantomjs''' is a special component that is used to dynamically generate PDF graphs. It is required from version NG/724 onwards and replaces the previous system of PDF graphs. It will be necessary to install it in all the consoles and servers where PDF reports can be generated in an interactive way, by means of programmed execution or where it executes alerts that include embedded graphics.
  
service mariadb start
+
If you are using an ISO image of the NG/724 version or later, there is no need to install anything because the system already has the library installed.
  
Now create the password, for example "pandora123" for your MySQL root user:
+
If not, follow these steps to install Phantomjs:
  
mysqladmin password pandora123
+
# In case the installation is going to be performed in a Linux system, the dependencies required by the program are: fontconfig freetype freetype-devel fontconfig-devel libstdc++. On windows these are not necessary.
 +
# Download phantomjs. The tests performed during the development of this feature were based on phantomjs 2.1.1. You can get this version from the following links:
 +
## Linux [https://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29/DEB%20Debian%2C%20Ubuntu/phantomjs].
 +
## Windows: [https://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29/Windows/phantomjs-2.1.1-windows.zip].
 +
## Official page: http://phantomjs.org/download.html.
 +
# If you add phantomjs to the system path, no further configuration is necessary. Otherwise it will be necessary to configure the path to the phantomjs binary file in the Pandora FMS Console. To achieve this, go to Settings > General > phantomjs bin path. The user providing the web pages (Apache by default) should be able to run this file in the selected location.
  
Then start the Apache Server on your server:
+
yum install -y fontconfig freetype freetype-devel fontconfig-devel libstdc++
 +
mkdir -p /opt/phantomjs/bin && cd /opt/phantomjs/bin
 +
wget "https://netcologne.dl.sourceforge.net/project/pandora/Tools%20and%20dependencies%20%28All%20versions%29/DEB%20Debian%2C%20Ubuntu/phantomjs"
 +
chmod +x phantomjs
 +
ln -s /opt/phantomjs/bin/phantomjs /usr/bin/
  
/etc/init.d/apache2 start
+
== Server and Console Installation in Windows ==
  
Or:
+
From Pandora FMS versions 5.1 and above, there is a Windows installer which allows you to install: '''Nginx''', '''PHP''', '''MySQL''', '''Pandora FMS''' and some dependencies necessary for the server and console operation under Windows.
  
service httpd start
+
<br><br>
 +
{{Warning|Pandora FMS Console & server setup in '''Windows''' is not recommended for production systems, due to inferior performance compared to Linux. It is being worked on to make it more stable and faster in future versions .}}
 +
<br><br>
 +
{{Warning |From Pandora FMS version 729 onwards, PHP7 is needed for the console to work.}}
  
Now it should be possible to access through the browser to the IP address of our Pandora FMS server and complete the database creation process.
+
Some features of the Pandora FMS server rely on a Linux-based operating system and do not work on Windows:
  
If your server's IP is, for exmaple,  '192.168.5.54', please put the following line into the address bar of your browser:
+
* [[Pandora:Documentation_en:Recon_Server#Recon_Scripts|Recon scripts]]
 +
* [[Pandora:Documentation_en:IPAM|IPAM]]
 +
* [[Pandora:Documentation_en:UX_Monitoring|UX monitoring]]
 +
* [[Pandora:Documentation_en:Transactional_Monitoring|Transactional monitoring]]
 +
* [[Pandora:Documentation_en:Netflow|Netflow]]
 +
* [[Pandora:Documentation_en:Remote_Monitoring#Monitoring_with_Plug_Ins_.28Server_Plugin.29|Server plug-ins]]. The default plug-ins are Linux scripts. You can, however, write your own scripts for Windows.
 +
* [[Pandora:Documentation_en:Virtual_environment_monitoring#VMware|VMware plug-in]]
 +
* [[Pandora:Documentation_en:Inventory|Remote inventory]]
 +
* [[Pandora:Documentation_en:Log_Monitoring|Log monitoring]]
  
http://192.168.5.54/pandora_console/install.php
+
It is delivered as an installer in executable format (. exe) and for its basic installation you
 +
only have to accept all the options listed below.  
  
From now on, you're just required to follow the following steps in order to create the Pandora FMS DB.
+
Select the language:
  
 
<center>
 
<center>
[[Image:Pandora_install_1.png]]
+
[[image:Pandora_agent_3.0_RC3_install_windows_01_eng.png]]
 
</center>
 
</center>
  
Please click on 'Next'.
+
Follow the installer steps:
  
 
<center>
 
<center>
[[Image:Pandora_install_2.png]]
+
[[image:Pandora_server_install_windows_011.png]]
 
</center>
 
</center>
  
This screen is intended to verify that all software dependencies have been properly installed.
+
Accept the license terms:
 
 
Note: If you're required to install some dependencies, restart the web server in order for it to recognize them.
 
  
 
<center>
 
<center>
[[Image:Pandora_install_3.png]]
+
[[image:Pandora_server_install_windows_021.png]]
 
</center>
 
</center>
  
At this point, it configures the access data to your MySQL server. You're required to enter the root password which you've created in the previous step (which was 'pandora 1234' in the example).
+
Select the components to install:
 
 
<b>Note:</b> Please avoid blank spaces in the database name.
 
  
 
<center>
 
<center>
[[Image:Pandora_install_4.png]]
+
[[image:Pandora_server_install_windows_031.png]]
 
</center>
 
</center>
  
Enter the password for database access here:
+
{{Warning|If you have a previous version of the Console and the Server already installed and you want an update, check '''only''' the 'Update installed version' option.}}
 +
 
 +
{{Tip|Nginx is a web server that replaces Apache, which was used in previous versions. This new server uses PHP with FastCGI, improving the Console performance.}}
 +
 
 +
This installer is mainly prepared for an installation on a computer which does not have Nginx or MySQL already installed. In case you have any other web server, such as IIS: it can be enabled, although you must disable it in order to work through Nginx.
 +
 
 +
If you have a MySQL Server installed and running on the computer before installing the remaining components of Pandora FMS, replace the MySQL root password by "pandora". This change is necessary in order for the database to be created which has to be able to assign permissions to the Pandora FMS Database correctly. Once you have installed Pandora FMS on your computer, please feel free to replace the password.
 +
 
 +
After selecting the components to install, specify the installation path:
 +
 
  
 
<center>
 
<center>
[[Image:Paso5.png]]
+
[[image:Pandora_server_install_windows_041.png]]
 
</center>
 
</center>
  
Installation complete:
+
The components are going to be installed. The only component which requires a user validation is Nginx. It will ask for the Pandora FMS server's name or IP address:
  
 
<center>
 
<center>
[[Image:Paso6.png]]
+
[[image:Pandora_server_install_windows_051.png]]
 
</center>
 
</center>
  
  
=== License Application ===
+
As explained above, other components are installed besides MySQL and Nginx. In case they are already installed, you may see a message like this:
 
 
The Pandora FMS Enterprise version bears a different license key associated to each installation. To use the Enterprise Features and the console's remote updates, enter the license code in the console configuration section.
 
 
 
After installing the Enterprise version's Pandora FMS Console by any installation method, you're required to access the Pandora Console (http://IP/pandora_console/). Subsequently, the following welcome screen to accept the license appears:
 
  
 
<center>
 
<center>
[[Image:license_accept.png]]
+
[[image:Pandora_server_install_windows_06.png]]
 
</center>
 
</center>
  
After accepting the license, the Pandora FMS Database schema is going to change, adding required new tables for the use of the Enterprise Version. In this moment, a new screen to register the license key, which Artica has sent to you, will appear:
+
Please remember that Microsoft Visual C++ is required for the modules to work properly.
  
 
<center>
 
<center>
[[Image:license_setup.png]]
+
[[image:Pandora_server_install_windows_06_21.png]]
 
</center>
 
</center>
  
{{tip|It is very important that the pandora_server daemon is not started with the Enterprise version of the same one installed, without having enabled the Enterprise version of the console first, as errors will occur.}}
+
Nginx requires '''Microsoft Visual C++ 2012''', while if you are running a '''Windows 2008 Professional R2''' system, you will need to install '''Microsot Visual C++ 2008'''.  Installing '''Microsoft Visual C++ 2010 SP1 Redistributable Package''' might be required as well for Nmap and the ICMP Enterprise Server to work properly.
  
== Server Initialization and Basic Configuration ==
 
  
Pandora FMS has configured your database and created a MySQL user for gaining access to it. It has created a random password for the 'pandora' user that should be the one which was used to modify the defined password in the Pandora FMS Server.
+
'''Microsoft Visual C++ 2008'''
  
For this last step, you're required to edit the file named '/etc/pandora/pandora_server.conf' from your Pandora installation and look for the following line:
+
https://www.microsoft.com/en-us/download/details.aspx?id=29
  
dbpass pandora
 
  
Then replace 'pandora' for the password which was created by the wizard. Once this is done and the file is saved, you're able to start the Pandora FMS server by entering the following command:
+
'''Microsoft Visual C++ 2010 SP1 Redistributable Package'''
 +
 
 +
https://www.microsoft.com/en-us/download/details.aspx?id=8328
  
/etc/init.d/pandora_server start
 
  
The server should return start values like the ones below.
+
'''Visual C++ 2012 (Update 4)'''
  
Pandora FMS Server X.Y Build XXXX Copyright (c) 2004-2009 ArticaST
+
https://www.microsoft.com/en-US/download/details.aspx?id=30679
This program is OpenSource, licensed under the terms of GPL License version 2.
+
 
You can download latest versions and documentation at http://www.pandorafms.org
+
'''Visual C++ 2015 '''
  [*] Backgrounding Pandora FMS Server process.
+
 
 
+
https://www.microsoft.com/es-es/download/details.aspx?id=48145
The Pandora Server is now running with PID 2085.
 
  
{{tip|The tentacle_server is configured to start along with the system boot. If you intend to work with the Pandora FMS Server without rebooting the machine, it's recommended to manually restart this service.}}
+
Please wait until the files are copied and all the setup-related settings are carried out.
  
To boot the tentacle_server manually, you will need to type the command:
+
<center>
 +
[[image:Pandora_server_install_windows_071.png]]
 +
</center>
  
/etc/init.d/tentacle_serverd start
+
Until the installation is complete as shown below.
  
= Pandora FMS Agent Installation =
+
<center>
 +
[[image:Pandora_server_install_windows_081.png]]
 +
</center>
  
== Agent Requirements ==
+
Once completed, the browser on the login screen will open automatically. In case Enterprise Version is installed, you will be asked for the license code which will be provided from Artica for implementation. Except for the Enterprise Version, the server is installed as a service and starts automatically during the installation process. If the installation of the Enterprise Version has been completed with no valid license code, the server will not boot.
  
The agent can run on any computer with the minimum required operating system, either of the following:
+
In order to quickly start the process, click on 'Start' and 'Programs'.
  
<table cellpadding=6 cellspacing=0 style='background-color: #ECECEC;'>
+
<center>
<tr>
+
[[image:Pandora_server_install_windows_091.png]]
<th style='text-align:center; background-color: #7CA12A; color:#FFFFFF'>Component</th>
+
</center>
<th style='text-align:center; background-color: #7CA12A; color:#FFFFFF'>Operating  System</th>
+
 
</tr>
+
Once the service is running properly, a ready-to-use console with all the servers will appear as shown on the picture below.
<tr>
+
 
<td>Pandora Agent 4.0 or above</td>
+
 
<td>
+
<center>
* RedHat Enterprise (RHEL) 6.x
+
[[image:Pandora_server_install_windows_101.png|800px]]
* CentOS 6.x
+
</center>
* SLES 11 SP1 or above
+
 
* OpenSUSE 11.x or above
+
 
* Debian 5.x or above.
+
=== WMI module operation in some Windows versions ===
* Ubuntu 11 or above.
+
 
* HPUX B.11.11 or above, with Perl 5.8.
+
For security reasons, some Windows versions have limited users who can remotely query WMI. If these modules are not carried out, the solution is to run the service Satellite Server as an Administrator user.
* AIX 4.3.3 or above, with Perl 5.8.
+
 
* BSD Systems (NetBSD, OpenBSD, FreeBSD), with Perl 5.8.
+
The process to follow is:
* MacOSX 10.6 or higher.
+
 
* Solaris 8 or above, with Perl 5.8.
+
Open the services:
* Windows NT4 (see special notes for this section).
 
* Windows XP
 
* Windows 2000
 
* Windows 2003
 
* Windows 2008
 
* Windows 7
 
* Windows 8
 
* Windows 2012
 
</td>
 
</tr>
 
<tr>
 
<td>Pandora Android Agent 2.0 or above</td>
 
<td>
 
* Android 2.2 or above
 
</td>
 
</tr>
 
<tr>
 
<td>Pandora Embedded Agent 4.0 or above</td>
 
<td>
 
* Embedded devices, requires compiling
 
</td>
 
</tr>
 
</table>
 
  
 +
<center>
 +
[[File:Instalacion windows7e.png|400px]]
 +
</center>
  
<br>
+
Right click on the service and go to Properties
{{Tip|There is a special agent for Windows NT, which is basically the Unix agent compiled for Windows, although performance is much lower than that of a native Windows agent and native API access features are not present.}}
 
 
 
In UNIX environments, the following must also be installed:
 
  
* '''Perl 5.8''' or above
+
<center>
* Optionally the package '''unzip''' installed correctly and '''accessible in the path of the user''' that will run the agent (only if you want to use the file collections).
+
[[File:Instalacion windows8e.png|700px]]
 +
</center>
  
== Installing the agent from tarball ==
+
On the Log in window, select an account with Administrator permissions and apply changes:
  
This agent version is ready for installation on any Unix/Linux/MAC OS system.
+
<center>
 +
[[File:Instalacion windows9e.png|500px]]
 +
</center>
  
The agent does not require compilation or preparation, once we have the agent downloaded in. tar. gz format.
+
And after these changes, restart the service.
  
1. Acquire root privilges
+
=== Directories to consider in Windows ===
  
su -
+
There are a set of directories you need to set correctly in Pandora FMS Setup, which are:
  
2. Copy it to /tmp and insidee /tmp execute:
+
- Remote Config directory
  
tar xvzf pandorafms_X.Y_unix.tar.gz
+
- Attachment store
cd unix
 
./pandora_agent_installer --install
 
  
3. Start the aagent manually:
+
<center>
 
+
[[image:Path_windows.png|800px]]
  /etc/init.d/pandora_agent_daemon start
+
</center>
 +
 
 +
- Server logs directory
 +
 
 +
<center>
 +
[[image:Path_windows2.png|800px]]
 +
</center>
 +
 
 +
- Graphviz binary directory
 +
 
 +
<center>
 +
[[image:Path_windows3.png|800px]]
 +
</center>
 +
 
 +
 
 +
{{Warning|It has been observed that it is necessary to install '''Microsoft Visual C++ 2008'''  in '''Windows 2008 Professional R2''' for Apache to operate properly.}}
 +
 
 +
'''Microsoft Visual C++ 2008'''<br>
 +
http://www.microsoft.com/es-es/download/details.aspx?id=29<br><br>
 +
 
 +
= Initial Configuration after Installation =
  
=== Custom installation ===  
+
Post-installation order is:
 +
 
 +
# Create the database through the Pandora FMS web console installation wizard.
 +
# Modify the server configuration including access credentials to the databases generated by the previous step.
 +
#Boot the server.
 +
#Start local agent (if needed).
 +
#Access Pandora FMS console for the first time to start using Pandora FMS.
 +
 
 +
==Tuning the settings in CentOS7==
 +
 
 +
CentOS 7 is a good Linux distribution but it has small details that are included here briefly, which will make it easier to install Pandora FMS:
 +
 
 +
CentOS 7 does not install ifconfig, to install it :
 +
 
 +
  yum install net-tools
 +
 
 +
CentOS has a very aggressive firewall, and you need to disable it (later you can secure the server if needed):
 +
 
 +
  systemctl disable firewalld
 +
  systemctl stop firewalld
 +
 
 +
CentOS 7 also has SELinux enabled by default, to disable it:
 +
 
 +
  setenforce 0
 +
  sed -i 's/enforcing/disabled/g' /etc/selinux/config /etc/selinux/config
 +
 
 +
Program both the WEB server and the database server for booting:
 +
 
 +
  systemctl start httpd.service
 +
  systemctl enable httpd.service
 +
  systemctl enable mariadb.service
 +
 
 +
{{Warning|We recommend to enable <b>AllowOverride</b> option in Apache server to enable <b>.htaccess</b> security directives included in Pandora FMS console from version 744 onwards.}}
 +
 
 +
Remove the private tmp from the systemd in Apache:
 +
 
 +
sed -i 's/PrivateTmp=true/PrivateTmp=false/g' /etc/systemd/system/multi-user.target.wants/httpd.service
 +
 
 +
== Initial Console Configuration ==
 +
 
 +
It is assumed all components (Database, Console, Server and Agent) will be executed on the same machine. If you have not done it already, start the MySQL server and create an Admin password (root).
 +
 
 +
/etc/init.d/mysql start
 +
 
 +
Or, depending on the Linux version:
 +
 
 +
service mariadb start
 +
 
 +
Now create the password, for example "pandora123" for your MySQL root user:
 +
 
 +
mysqladmin password pandora123
 +
 
 +
Then start the Apache Server on your server:
 +
 
 +
/etc/init.d/apache2 start
 +
 
 +
Or:
 +
 
 +
service httpd start
 +
 
 +
Now it should be possible to access through the browser to the IP address of your Pandora FMS server and complete the database creation process.
 +
 
 +
If your server's IP is, for exmaple, '192.168.5.54', please type in the following line into the address bar of your browser:
 +
 
 +
<nowiki>http://192.168.5.54/pandora_console/install.php</nowiki>
 +
 
 +
From now on, follow the following steps in order to create the Pandora FMS DB.
 +
 
 +
<center>
 +
[[Image:Pandora_install_1.png]]
 +
</center>
 +
 
 +
Click on 'Next'.
 +
 
 +
<center>
 +
[[Image:Pandora_install_2.png]]
 +
</center>
 +
 
 +
This screen is intended to verify that all software dependencies have been properly installed.
 +
 
 +
Note: If you are required to install some dependencies, restart the web server in order for it to recognize them.
 +
 
 +
<center>
 +
[[Image:Pandora_install_3.png]]
 +
</center>
 +
 
 +
At this point, it configures the access data to your MySQL server. You are required to enter the root password that you have created in the previous step (which was 'pandora 1234' in the example).
 +
 
 +
<b>Note:</b> Please avoid blank spaces in the database name.
 +
 
 +
<center>
 +
[[Image:Pandora_install_4.png]]
 +
</center>
 +
 
 +
Enter the password for database access here:
 +
 
 +
<center>
 +
[[Image:Paso5new.png]]
 +
</center>
 +
 
 +
Installation complete:
 +
 
 +
<center>
 +
[[Image:Paso6.png]]
 +
</center>
 +
 
 +
 
 +
=== License Application ===
 +
 
 +
The Pandora FMS Enterprise version bears a different license key associated to each installation. To use the Enterprise Features and the console's remote updates, enter the license code provided by Ártica in the console configuration section.
 +
 
 +
For more information about how to activate the license, go to
 +
 
 +
[[Pandora:QuickGuides_EN:General_Quick_Guide | license activation.]]
 +
 
 +
== Server initial and basic configuration ==
 +
 
 +
Pandora FMS has configured your database and created a MySQL user to obtain access to it. It has created a random password for the 'pandora' user that should be the one used to modify the defined password in the Pandora FMS Server.
 +
 
 +
For this last step, edit the file named '/etc/pandora/pandora_server.conf' from your Pandora FMS installation and look for the following line:
 +
 
 +
dbpass pandora
 +
 
 +
Then replace 'pandora' for the password created by the wizard. Once this is done and the file is saved, you will able to start the Pandora FMS server by entering the following command:
 +
 
 +
/etc/init.d/pandora_server start
 +
 
 +
The server should return start values like the ones below.
 +
 
 +
Pandora FMS Server X.Y Build XXXX Copyright (c) 2004-2009 ArticaST
 +
This program is OpenSource, licensed under the terms of GPL License version 2.
 +
You can download latest versions and documentation at http://www.pandorafms.org
 +
  [*] Backgrounding Pandora FMS Server process.
 +
  Pandora FMS Server is now running with PID 2085.
 +
 
 +
{{tip|The tentacle_server is configured to start along with the system boot. If you intend to work with the Pandora FMS Server without rebooting the machine, it is recommended to manually restart this service.}}
 +
 
 +
To boot the tentacle_server manually, type in the command:
 +
 
 +
/etc/init.d/tentacle_serverd start
 +
 
 +
= Pandora FMS Agent Installation =
 +
 
 +
== Agent Requirements ==
 +
 
 +
The agent can run on any computer with the minimum required operating system, either of the following:
 +
 
 +
<table cellpadding=6 cellspacing=0 style='background-color: #ECECEC;'>
 +
<tr>
 +
<th style='text-align:center; background-color: #7CA12A; color:#FFFFFF'>Component</th>
 +
<th style='text-align:center; background-color: #7CA12A; color:#FFFFFF'>Operating  System</th>
 +
</tr>
 +
<tr>
 +
<td>Pandora Agent 4.0 or above</td>
 +
<td>
 +
* RedHat Enterprise (RHEL) 6.x
 +
* CentOS 6.x
 +
* SLES 11 SP1 or above
 +
* OpenSUSE 11.x or above
 +
* Debian 5.x or above.
 +
* Ubuntu 11 or above.
 +
* HPUX B.11.11 or above, with Perl 5.8.
 +
* AIX 4.3.3 or above, with Perl 5.8.
 +
* BSD Systems (NetBSD, OpenBSD, FreeBSD), with Perl 5.8.
 +
* MacOSX 10.6 or higher.
 +
* Solaris 8 or above, with Perl 5.8.
 +
* Windows NT4 (see special notes for this section).
 +
* Windows XP
 +
* Windows 2000
 +
* Windows 2003
 +
* Windows 2008
 +
* Windows 7
 +
* Windows 8
 +
* Windows 2012
 +
</td>
 +
</tr>
 +
<tr>
 +
<td>Pandora Android Agent 2.0 or above</td>
 +
<td>
 +
* Android 2.2 or above
 +
</td>
 +
</tr>
 +
<tr>
 +
<td>Pandora Embedded Agent 4.0 or above</td>
 +
<td>
 +
* Embedded devices, requires compiling
 +
</td>
 +
</tr>
 +
</table>
 +
 
 +
 
 +
<br>
 +
{{Tip|There is a special agent for Windows NT, which is basically the Unix agent compiled for Windows, although performance is much lower than that of a native Windows agent and native API access features are not present.}}
 +
 
 +
In UNIX environments, the following must also be installed:
 +
 
 +
* '''Perl 5.8''' or above
 +
* Optionally the package '''unzip''' installed correctly and '''accessible in the path of the user''' that will run the agent (only if you want to use the file collections).
 +
* It will be necessary to install the following dependency:
 +
perl-YAML-Tiny-1.73-2
 +
 
 +
== Installing the agent from tarball ==
 +
 
 +
This agent version is ready for installation on any Unix/Linux/MAC OS system.
 +
 
 +
The agent does not require compilation nor preparation, once the agent is downloaded in. tar. gz format.
 +
 
 +
1. Acquire root privilges
 +
 
 +
su -
 +
 
 +
2. Copy it to /tmp and insidee /tmp execute:
 +
 
 +
tar xvzf pandorafms_X.Y_unix.tar.gz
 +
cd unix
 +
./pandora_agent_installer --install
 +
 
 +
3. Start the agent manually:
 +
 
 +
/etc/init.d/pandora_agent_daemon start
 +
 
 +
=== Custom installation ===  
  
 
The agent can be installed in a directory defined by the user in an "integral" way, this means that all the files of the agent will be put in that directory: logs, configuration files, binaries, man pages, etc.
 
The agent can be installed in a directory defined by the user in an "integral" way, this means that all the files of the agent will be put in that directory: logs, configuration files, binaries, man pages, etc.
  
To use that method, simply run it as the following example:
+
To use that method, simply run it as the following example:
 
+
 
  ./pandora_agent_installer --install /opt/pandora
+
  ./pandora_agent_installer --install /opt/pandora
 
+
 
The only file that Pandora FMS will create outside this user-defined directory is the agent launcher in ''/etc/init. d/pandora_agent_daemon'' (or equivalent in other Unix systems), and the link in the directory of the system's boot level, for example ''/etc/rc. d/rc2. d/S90pandora_agent_daemon''.
+
The only file that Pandora FMS will create outside this user-defined directory is the agent launcher in ''/etc/init. d/pandora_agent_daemon'' (or equivalent in other Unix systems), and the link in the directory of the system's boot level, for example ''/etc/rc. d/rc2. d/S90pandora_agent_daemon''.
 
+
 
Moreover, the installation can be configured so that instead of running the agent with root user, it can run with another user. For example, for the agent to run with the Pandora user, it would be:
+
Moreover, the installation can be configured so that instead of running the agent with root user, it can run with another user. For example, for the agent to run with the Pandora FMS user, it would be:
 
+
 
  ./pandora_agent_installer --install /home/pandora pandora
+
  ./pandora_agent_installer --install /home/pandora pandora
 
+
 
When a custom user is specified, the agent must be installed in a custom location where the user has writing permissions (/home/pandora in the previous example).
+
When a custom user is specified, the agent must be installed in a custom location where the user has writing permissions (/home/pandora in the previous example).
 +
 
 +
 
 +
<br>
 +
{{Warning|The user '''pandora''' is deactivated by default, you must enable it by entering a valid shell in ''/etc/passwd'' if you want to use it to run the agent with that user.}}
 +
 
 +
{{Warning|For users with '''MAC OS X 10.11''' or higher (The Captain or newer): Apple has added a new security layer on OS X. Some root privileges have disappeared. When installing the Pandora FMS Agent, it will appear as a restricted process. Only restricted processes that are signed by Apple can modify these files. However, you can disable this security system by booting into recovery mode and deactivating it on a terminal by doing: csrutil disable.}}
 +
 
 +
===Agent installation in CentOS/RedHat ===
 +
 
 +
To install the software agent in CentOS/RedHat you should have downloaded the CentOS/Rehdat RPM package from our website.
 +
 
 +
To install it, simply run this command:
 +
 
 +
rpm -i pandorafms_agent-7.0NG-1.noarch.rpm
 +
 
 +
In case you have activated the CentOS repository, you can install the agent like this:
 +
 
 +
yum install pandorafms_agent
 +
 
 +
If using CentOS 8, it will be necessary to install the PowerTools repository. In can be installed with the following command:
  
 
+
yum install ./pandorafms_agent.noarch.rpm --enablerepo=PowerTools
<br>
 
{{Warning|The user '''pandora''' is deactivated by default, you must enable it by putting a valid shell in ''/etc/passwd'' if you want to use it to run the agent with that user.}}
 
 
 
{{Warning|For users with '''MAC OS X 10.11''' or higher (The Captain or newer): Apple has added a new security layer on OS X. Some root privileges have disappeared. When installing the Pandora FMS Agent, it will appear as a restricted process. Only restricted processes that are signed by Apple can modify these files. However, you can disable this security system by booting into recovery mode and deactivating it on a terminal by doing: csrutil disable.}}
 
 
 
===Agent installation in CentOS/RedHat ===
 
 
 
To install the software agent in CentOS/RedHat you should have downloaded the CentOS/Rehdat RPM package from our website.
 
 
 
To install it, simply run this command:
 
 
 
rpm -i pandorafms_agent-7.0NG-1.noarch.rpm
 
 
 
In case you have activated the CentOS repository, you can install the agent like this:
 
 
 
yum install pandorafms_agent
 
  
 
===Agent installation in Ubuntu/Debian ===
 
===Agent installation in Ubuntu/Debian ===
Line 1,639: Line 2,225:
 
===Agent installation in NetBSD and FreeBSD ===
 
===Agent installation in NetBSD and FreeBSD ===
  
Pandora FMS agents file does not exist for FreeBSD and NetBSD.
+
Pandora FMS agent file does not exist for FreeBSD and NetBSD.
 
You must install the Pandora FMS agent using the installer.
 
You must install the Pandora FMS agent using the installer.
  
Line 1,646: Line 2,232:
 
The file location and startup script structure are different from Linux.
 
The file location and startup script structure are different from Linux.
  
We will study the peculiarities of FreeBSD later on.
+
The particulars of FreeBSD will be discussed later on.
  
After installation, you should add the following line to /etc/rc. conf.
+
After installation, add the following line to /etc/rc. conf.
  
 
  pandora_agent_enable="YES"
 
  pandora_agent_enable="YES"
  
To enable the pandora agent, these settings are needed, otherwise the process cannot be started.
+
To enable the Pandora FMS agent, these settings are needed, otherwise the process cannot be started.
  
In FreeBSD, most pandora agent files are installed in /usr/local.
+
In FreeBSD, most Pandora FMS agent files are installed in /usr/local.
  
 
Agent:
 
Agent:
Line 1,667: Line 2,253:
 
  /usr/local/man/man1/*
 
  /usr/local/man/man1/*
 
Other:
 
Other:
  The data_in and log directories are the same as in Linux.
+
  The data_in and log directories are the same as those of Linux.
  
 
===Agent installation in Windows===
 
===Agent installation in Windows===
Line 1,673: Line 2,259:
 
The agent is delivered as an installer in executable format (. exe). The basic installation performs all the necessary steps and it is only necessary to accept all the options.
 
The agent is delivered as an installer in executable format (. exe). The basic installation performs all the necessary steps and it is only necessary to accept all the options.
  
To install the Pandora FMS agent in Windows, you only need to download and run it. The installer will guide you through the necessary steps in the language you select. In the following example shows the installation for Windows XP, remember that Pandora FMS works on any modern Microsoft platform (2000 or higher). It also has 32 and 64 bit versions.
+
To install the Pandora FMS agent in Windows, you only need to download and run it. The installer will guide you through the necessary steps in the language you select. The following example shows the installation for Windows XP, remember that Pandora FMS works on any modern Microsoft platform (2000 or higher). It also has 32 and 64 bit versions.
  
  
Line 1,693: Line 2,279:
 
</center>
 
</center>
  
Select the path where the Pandora FMS agent will be installed (by default it is installed in c: /program files/pandora_agent), but you can change it by clicking on Browse..., then click on Next:
+
Select the path where the Pandora FMS agent will be installed (by default it is installed in c: /program files/pandora_agent), but you can change it by clicking on Browse..., and then clicking on Next:
  
 
<center>
 
<center>
Line 1,715: Line 2,301:
 
</center>
 
</center>
  
Decide if you want to start Pandora FMS agent service at the moment, otherwise you will have to do it manually, or it will start when Windows restarts again.
+
Decide whether you want to start Pandora FMS agent service at the moment, otherwise you will have to do it manually, or it will start when Windows restarts again.
  
 
<center>
 
<center>
Line 1,728: Line 2,314:
 
  "Pandora FMS Windows Agent v7.0NG.VERSION-BUILD_ARCH.exe" /S
 
  "Pandora FMS Windows Agent v7.0NG.VERSION-BUILD_ARCH.exe" /S
  
In case we want to install the agent in a different path than the default one:  
+
In case you want to install the agent in a different path than the default one:  
  
 
  "Pandora FMS Windows Agent v7.0NG.VERSION-BUILD_ARCH.exe" /S /D=C:\Agent_Pandora
 
  "Pandora FMS Windows Agent v7.0NG.VERSION-BUILD_ARCH.exe" /S /D=C:\Agent_Pandora
  
{{WIP}}
+
You can also pass certain parameters so that they are written in the configuration file of the agent to be created. Thanks to these options, the deployment of Pandora FMS agents is much more customizable. The options per command line that are supported are the following:
 
 
También se pueden pasar ciertos parámetros para que se escriban en el fichero de configuración del agente. Gracias a estas opciones el despliegue de los agentes de Pandora puede ser mucho más personalizable. Las opciones por línea de comandos que se soportan son las siguientes:
 
  
* '''--ip''': Se corresponde con ''server_ip''.
+
* '''--ip''': Corresponds to the token ''server_ip''.
* '''--group''': Se corresponde con ''group''.
+
* '''--group''': Corresponds to the token''group''.
* '''--name''': Se corresponde con ''agent_name''. Al usar esta opción el agente no tendrá un nombre aleatorio sino que se usará el nombre que se le indique. En el fichero de configuración, se comenta la línea ''agent_name_cmd __rand__''.
+
* '''--alias''': Corresponds to the token''agent_alias''.
  
Por ejemplo, si se quiere un agente que pertenezca al grupo ''Applications'', con nombre ''Mifunne'' y que apunte al servidor con la IP ''192.168.0.59'' el comando sería:
+
For example, if you want to create an agent that belongs to the group''Applications'', with the name ''Mifunne'' and that points to the server with the IP ''192.168.0.59'', the command would be:
  
  "Pandora FMS Windows Agent v7.0NG.VERSION-BUILD_ARCH.exe" /S  --ip 192.168.0.59 --group Applications --name Mifunne
+
  "Pandora FMS Windows Agent v7.0NG.VERSION-BUILD_ARCH.exe" /S  --ip 192.168.0.59 --group Applications --alias Mifunne
  
 
====Unattended Uninstallation====
 
====Unattended Uninstallation====
  
The uninstaller that is an executable named <code>uninstall. exe</code> that is in the Pandora FMS installation directory also allows the unattended uninstaller, to do this you must run the uninstaller with the option <code>''' /S''' </code>.
+
The uninstaller that is an executable named <code>uninstall. exe</code> in the Pandora FMS installation directory also enables the unattended uninstaller, to do it, run the uninstaller with the option <code>''' /S''' </code>.
  
 
For example, assuming that Pandora FMS is installed in the default path:
 
For example, assuming that Pandora FMS is installed in the default path:
Line 1,752: Line 2,336:
 
  c:\program files\pandora_agent
 
  c:\program files\pandora_agent
  
We should execute:
+
You should execute:
  
 
  “c:\program files\pandora_agent\uninst.exe” /S
 
  “c:\program files\pandora_agent\uninst.exe” /S
Line 1,758: Line 2,342:
 
==== Using PandoraAgent.exe from the command line ====
 
==== Using PandoraAgent.exe from the command line ====
  
If we run pandoraagent.exe --help, it will show us something similar to this:
+
If you run pandoraagent.exe --help, it will show you something similar to this:
  
 
  Pandora agent for Windows. Version 3.0(Build 091125)
 
  Pandora agent for Windows. Version 3.0(Build 091125)
Line 1,777: Line 2,361:
 
This will prompt the service on the machine, based on the path where the. exe is located.
 
This will prompt the service on the machine, based on the path where the. exe is located.
  
If we want to uninstall it, it's the same process but using:
+
If you want to uninstall it, the process is the same but using:
  
 
  pandoraagent.exe --uninstall
 
  pandoraagent.exe --uninstall
  
If you want to test an ftp or ssh connection from the command line you can use the options above.
+
If you want to test an ftp or ssh connection from the command line, you can use the previous options.
  
 
==== Pandora FMS Windows Agent as a process ====
 
==== Pandora FMS Windows Agent as a process ====
  
It is possible, for debugging, testing and other unusual circumstances, to execute the agent in "Process"mode. This is done by running it from the command line:
+
It possible, for debugging, testing and other unusual circumstances, execute the agent in "Process"mode. This is done by running it from the command line:
  
 
  pandoraagent.exe --process
 
  pandoraagent.exe --process
  
There are some limitations in the execution of the process mode, since Pandora FMS is meant to run as a service and under the user SYSTEM. If you run it with another user without privileges, there will be functionalities that won't work properly.
+
There are some limitations in the execution of the process mode, since Pandora FMS is meant to run as a service and under the user SYSTEM. If you run it with another user without privileges, there will be functionalities that will not work properly.
  
 
[[Pandora:Documentation en|Go back to Pandora FMS documentation index]]
 
[[Pandora:Documentation en|Go back to Pandora FMS documentation index]]

Latest revision as of 08:04, 12 August 2020

Go back to Pandora FMS documentation index

Contents

1 Console and Pandora FMS Server Installation

1.1 Minimum hardware requirements

The requirements set out in this table are the minimum recommendations for different installations. These recommendations are calculated assuming that 80% of the modules have historical data and the average sampling time is 5 minutes. These recommendations are specified for an environment where they are installed in the same database server, server and console.

Hardware SMALL: up to 500 agents or 5000 modules MEDIUM: up to 2000 agents or 10000 modules BIG: For more than 4000 agents*
CPU 1 core at 2 GHz 2 cores at 2,5 GHz 4 cores at 3 GHz
RAM 4 GB 8 GB 16 GB
Hard drive 7200 rpm 15K rpm or SSD SSD
Disk Space 20GB minimum
40GB recommended
60GB minimum
120GB recommended
120GB minimum
250GB recommended

(*) In addition to the these recommendations, we recommend installing MySQL on a standalone server and installing Percona XTraDB instead of standard MySQL.



Template warning.png

In case you install Pandora FMS in a virtual environment, make sure to assign an independent disk with reserved space and high access speed.

 


Info.png

We strongly recommend the use of SSD disks, due to the high impact they have on performance improvement.

 


Info.png

A 25GB disk is recommended, with a minimum of 15GB. If features such as log storage are going to be used, or information more than one month old is going to be saved, history database should be used.

 


1.2 Minimum software requirements

Software Requirements
Operating System
  • Windows Server (2003 or higher)
  • RedHat Enterprise (RHEL) 7.X
  • CentOS 7.X (recommended)
  • SLES 11 SP1 or higher
  • OpenSUSE 11.X or higher
  • Debian 5, 6, 7 or higher
  • Ubuntu 11 or higher
  • FreeBSD 9.X and 10.X
  • Solaris 10/OpenSolaris
Pandora FMS does not give official support in these platforms
Permissions
  • Server

- Linux: Pandora FMS Server service must be executed as root permission. Execution as non-root user is possible, being a special and different procedure. Find out more information in this link.

-Windows: Pandora FMS Server service must be executed as administrator permission.

  • Console

To be able to use the console from any web browser, Apache must have read and execute permissions on the console files.

Additionally, the config.php file must have the 600 permissions (read and write for administrator/root).

It is necessary to have writing permissions in the server directory: /var/spool/pandora/.

  • Agent

-Linux: The Pandora FMS Server Software Agent must be executed as root permission in order to have all the agent features available, although it is also possible to execute it with other permissions..

-Windows: Pandora FMS Server Software Agent must be executed as administrator permission.

Console
  • PHP 7.2 -> For Pandora FMS version 729 or higher.
  • PHP 5 -> For Pandora FMS version 728 or older.
Browsers
  • Microsoft Edge
  • Opera
  • Chrome
  • Firefox

Firefox and Chrome are recommended to make use of interactive graphs and network maps.

Some Pandora FMS server features are not supported for Windows. To learn more about these features, click on the following link.

1.3 Database requisites

BBDD Details
MySQL Standard
  • Version 5.5
  • For standard installation, a user with creating privileges in the pandora DB is required. In case of not having this user, a manual installation can be performed.
Percona XTraDB

Percona XTraDB installation is recommended for large Pandora FMS environments where more than 4000 agents must be created.

  • Version 5.5
  • For standard installation, a user with creating privileges in the pandora DB is required. In case of not having this user, it will be possible to carry out manual installation.


Template warning.png

All of this is needed BEFORE you start installing Pandora FMS. If you do not know how to install MySQL server, look for documentation about the whole process. We cannot provide all that documentation since it is different in each system, distribution and/or version.

 


1.4 Satellite Server Requirements

Satellite Details
Hardware

Similarly to Pandora FMS installation, the hardware requirements of the system that will host the satellite server will depend on the monitoring volume to be managed. For environments with less than 1000 agents, a minimum of 1 core at 2GHz and 1 GB of RAM is recommended.

Dependencies

The main dependencies are:

  • Fping
  • Nmap
  • Perl
Binaries

The main dependencies are:

  • Linux 32 Bits
  • Linux 64 Bits
  • Windows 32 Bits
  • Windows 64 Bits
  • Raspberry

1.5 Port requirements

Port Protocol Service/Process Descripction Address
80 TCP Pandora FMS Console IP management Browser -> Pandora FMS Console Server
80 TCP Pandora FMS Console (API Communication) Use of API/CLI feature Browser/Server that starts the query -> Pandora FMS Console Server
80 TCP Metaconsole Communication between Metaconsole and Nodes Metaconsole server -> Node Server Node Server -> Metaconsole server
162 UDP Pandora FMS Server Trap reception Trap generator device -> Pandora FMS Server
443 TCP Pandora FMS Console (API Communication) Use of API/CLI feature Browser/Server that starts the query -> Pandora FMS Console Server
443 TCP Metaconsole Communication between Metaconsole and Nodes Metaconsole server -> Node server Node server -> Metaconsole server
3306 TCP Pandora FMS Console and Server DB connection Pandora FMS Console Server -> Pandora FMS Database Server Pandora FMS Server -> Pandora FMS Database Server
3306 TCP Metaconsole Communication between Metaconsole and DB Nodes Metaconsole server -> DB Nodes Server Node Server -> Metaconsole BBDD Server
4444 TCP Pandora FMS Server Connection with Selenium GRID Pandora FMS Server -> Selenium Server
9995 UDP Pandora FMS Server Receiving Netflow probes nfcapd Server -> Pandora FMS Server
10514 TCP Pandora FMS Console and Server Log storage management with Logstash Logstash Server -> Pandora FMS Server
41121 TCP Pandora FMS Agents Tentacle Communication Software Agent Server Agent -> Pandora FMS Server
It is recommended to facilitate communication from Pandora FMS server and console to the whole network. For standard monitoring you should need minimum:
80 TCP Pandora FMS Server Web monitoring for WUX server Pandora FMS Server -> Server to monitor
161 UDP Pandora FMS Console and Server Monitoring via SNMP Polling Pandora FMS Server -> Server to monitor
443 TCP Pandora FMS Server Web monitoring for WUX server Pandora FMS Server -> Server to monitor
ICMP ICMP Console and Pandora FMS Server Web monitoring for WUX server Pandora FMS Server -> Server to monitor

1.6 Package Dependencies

Pandora FMS has a strong dependency on the GNU/Linux Operating System, but it also needs additional packages which, in many cases, are not installed by default. During the installation process, there is a detailed list of package dependencies for Debian, Ubuntu and OpenSUSE.

1.7 Issues prior to Installation

1.7.1 MySQL

You will need to have MySQL Server installed BEFORE configuring Pandora FMS, since the next step after installing Pandora FMS packages, is to configure access to the databases. To do that, it must be operational. If you are installing the MySQL Server at the same time as Pandora FMS, remember that you need to set up the root user for MySQL. This can be easily done in two steps:

1. Start MySQL Server daemon:

/etc/init.d/mysql start

2. Configure the root password for MySQL root user:

mysqladmin password <password>

In <password>, type in the password for MySQL root user (which is different from the system's 'root' user). The system will ask for this password throughout the entire Pandora FMS installation process.

1.7.2 Pandora FMS Installation Order

You are required to follow this sequence in order to install Pandora FMS properly:

  1. Install console
  2. Install server

The reason for this is that MySQL database is configured during the initial configuration phase of the console installation. To ensure the correct working of the server, it is recommended to conduct the whole console installation process first.

It is also possible to host Pandora FMS Server and console in different machines, because the server can be configured to use a remote MySQL database by means of the server configuration file.

Regarding the agent: You may install it before or after installing the server and console, because the agent works independently and it may be installed on any machine.

1.7.3 Installing the Enterprise Version

The correct order for an Enterprise installation is as follows:

  • Install the open-source console.
  • Install the Enterprise Console.
  • When accessing the console, a box will appear requiring you to enter your Enterprise license code.

Validation of the license is only done in the console. Not in the server.

Details on how to correctly enter the license can be found in the following section: License Application v5.X window opens.

1.7.3.1 Special Requirements for the Enterprise Version

The Enterprise installation of the web console has no additional dependencies. The installation of the Enterprise server is done by means of an installer in binary format that contains all the necessary dependencies.

1.8 Installation using ISO or "Software appliance"

Download the CD image from the Download section of our website and burn the ISO image onto a DVD, or run the system from that file if you are using a virtualized system (XenServer, VMware, VirtualBox, etc). There are CD images for both 32- and 64-bit installations.

The following screen will be displayed at the beginning of the boot process. If you do not press any key, the process will automatically load the Live CD, or you can press any key, select the "Install Pandora FMS" option and press "enter" to start the installation.

Install 1.png

The graphic installer will lead you step by step throughout the whole installation process. This installer is a standard installation process used by CentOS, and it is available in different languages. It is a very easy process but special attention must be paid when entering the superuser password (root), and when asked about the hard drive partitioning:

Install 2.png]
Select the preferred language


Install 3.png

Select and configure all the necessary options to install, “Date & Time”, “Keyboard” and “Installation Destination”. Remember to activate the network interface, or else it will need to activated manually after installation.

Install 4.png Install 5.png
Activate the network interface and optionally change the hostname


When clicking the installation destination button, the partition process will start.

Install 6.png
Select the disk where the installation will be performed and click on done. Install 7.png

Select the partitioning, unless you have advanced knowledge use the option "Click here to create them automatically".


Install 8.png
Verify the created partitions and click on Done.
Install 9.png
Accept Changes.
Install 10.png
Click on Begin Installation.
Install 11.png
Here you can assign the root password and optionally create a user.

Now just wait until the process is finished and the system restarts automatically.

1.9 Installing the ISO image using a USB Stick

To install the Pandora FMS appliance from a USB flash drive, follow these steps:

  • Download the Pandora FMS ISO image from the download section.
  • Download the program rufus to prepare your USB for the installation (https://rufus.akeo.ie/)
  • Insert the flash drive.
  • Start the program rufus.

Usb installation 1.PNG

  • Select the Pandora FMS ISO image.

Usb installation 2.PNG

  • Press START to start the creation of the Pandora FMS installation USB.

Usb installation 3.PNG

Usb installation 4.PNG

  • Your Pandora FMS installation USB device is ready

Usb installation 5.PNG


  • Connect the USB to the machine where you want to install Pandora FMS.
  • When starting the system, configure the BIOS to start first from USB.

The following screen should be displayed:

Usb installation 6.PNG

Select "Installing from USB stick" and continue the installation as described in the previous chapter.

1.10 Package installation for CentOS 8

To install Pandora FMS by packages in CentOS 8 it will be necessary first to define the following variables:

PANDORA_CONSOLE=/var/www/html/pandora_console
CONSOLE_PATH=/var/www/html/pandora_console
PANDORA_SERVER_CONF=/etc/pandora/pandora_server.conf
PANDORA_SERVER_BIN=/usr/bin/pandora_server
PANDORA_HA_BIN=/usr/bin/pandora_ha
PANDORA_TABLES_MIN=160
DBHOST=127.0.0.1
DBNAME=pandora
DBUSER=pandora
DBPASS=pandora
DBPORT=3306

Once the variables are defined and to install the necessary packages, we will first configure dnf, to configure it it will be necessary to execute the following commands.

dnf install -y \
   epel-release \
   tar \
   dnf-utils \
   http://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf module reset php
dnf module install -y php:remi-7.3
yum config-manager --set-enabled PowerTools


It will also be necessary to install a database percona.


dnf install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
dnf module disable -y mysql
rm -rf /etc/my.cnf
dnf install -y Percona-Server-server-57


Once with dnf and percona installed we can start to install all the necessary dependencies for the console:


dnf install -y \
   php \
   postfix \
   php-mcrypt \php-cli \
   php-gd \
   php-curl \
   php-session \
   php-mysqlnd \
   php-ldap \
   php-zip \
   php-zlib \
   php-fileinfo \
   php-gettext \
   php-snmp \
   php-mbstring \
   php-pecl-zip \
   php-xmlrpc \
   libxslt \
   wget \
   php-xml \
   httpd \
   mod_php \
   atk \
   avahi-libs \
   cairo \
   cups-libs \
   fribidi \
   gd \
   gdk-pixbuf2 \
   ghostscript \
   graphite2 \
   graphviz \
   gtk2 \
   harfbuzz \
   hicolor-icon-theme \
   hwdata \
   jasper-libs \
   lcms2 \
   libICE \
   libSM \
   libXaw \
   libXcomposite \
   libXcursor \
   libXdamage \
   libXext \
   libXfixes \
   libXft \
   libXi \
   libXinerama \
   libXmu \
   libXrandr \
   libXrender \
   libXt \
   libXxf86vm \
   libcroco \
   libdrm \
   libfontenc \
   libglvnd \
   libglvnd-egl \
   libglvnd-glx \
   libpciaccess \
   librsvg2 \
   libthai \
   libtool-ltdl \
   libwayland-client \
   libwayland-server \
   libxshmfence \
   mesa-libEGL \
   mesa-libGL \
   mesa-libgbm \
   mesa-libglapi \
   pango \
   pixman \
   xorg-x11-fonts-75dpi \
   xorg-x11-fonts-misc \
   poppler-data \
   php-yaml


With the console dependencies already installed it's time to install the server dependencies:


dnf install -y http://www6.atomicorp.com/channels/atomic/centos/7/x86_64/RPMS/wmi-1.3.14-4.el7.art.x86_64.rpm
dnf install -y \
   vim \
   fping \
   perl-IO-Compress \
   nmap \
   sudo \
   perl-Time-HiRes \
   perl-Math-Complex \
   libnsl \
   net-snmp-utils


In the Community version some extra dependencies will be needed:

dnf install -y  GeoIP \
GeoIP-GeoLite-data \
dwz \
efi-srpm-macros \
ghc-srpm-macros \
go-srpm-macros \
ocaml-srpm-macros \
openblas-srpm-macros \
perl \
perl-Algorithm-Diff \
perl-Archive-Tar \
perl-Archive-Zip \
perl-Attribute-Handlers \
perl-B-Debug \
perl-CPAN \
perl-CPAN-Meta \
perl-CPAN-Meta-Requirements \
perl-CPAN-Meta-YAML \
perl-Compress-Bzip2 \
perl-Config-Perl-V \
perl-DBD-MySQL \
perl-DBI \
perl-DB_File \
perl-Data-Dump \
perl-Data-OptList \
perl-Data-Section \
perl-Devel-PPPort \
perl-Devel-Peek \
perl-Devel-SelfStubber \
perl-Devel-Size \
perl-Digest-HMAC \
perl-Digest-SHA \
perl-Encode-Locale \
perl-Encode-devel \
perl-Env \
perl-ExtUtils-CBuilder \
perl-ExtUtils-Command \
perl-ExtUtils-Embed \
perl-ExtUtils-Install \
perl-ExtUtils-MM-Utils \
perl-ExtUtils-MakeMaker \
perl-ExtUtils-Manifest \
perl-ExtUtils-Miniperl \
perl-ExtUtils-ParseXS \
perl-File-Fetch \
perl-File-HomeDir \
perl-File-Listing \
perl-File-Which \
perl-Filter \
perl-Filter-Simple \
perl-Geo-IP \
perl-HTML-Parser \
perl-HTML-Tagset \
perl-HTML-Tree \
perl-HTTP-Cookies \
perl-HTTP-Date \
perl-HTTP-Message \
perl-HTTP-Negotiate \
perl-IO-HTML \
perl-IO-Socket-INET6 \
perl-IO-Zlib \
perl-IO-stringy \
perl-IPC-Cmd \
perl-IPC-SysV \
perl-IPC-System-Simple \
perl-JSON \
perl-JSON-PP \
perl-LWP-MediaTypes \
perl-Locale-Codes \
perl-Locale-Maketext \
perl-Locale-Maketext-Simple \
perl-MRO-Compat \
perl-Math-BigInt \
perl-Math-BigInt-FastCalc \
perl-Math-BigRat \
perl-Memoize \
perl-Module-Build \
perl-Module-CoreList \
perl-Module-CoreList-tools \
perl-Module-Load \
perl-Module-Load-Conditional \
perl-Module-Loaded \
perl-Module-Metadata \
perl-NTLM \
perl-Net-HTTP \
perl-Net-Ping \
perl-NetAddr-IP \
perl-Package-Generator \
perl-Params-Check \
perl-Params-Util \
perl-Perl-OSType \
perl-PerlIO-via-QuotedPrint \
perl-Pod-Checker \
perl-Pod-Html \
perl-Pod-Parser \
perl-SelfLoader \
perl-Socket6 \
perl-Software-License \
perl-Sub-Exporter \
perl-Sub-Install \
perl-Sys-Syslog \
perl-Test \
perl-Test-Harness \
perl-Test-Simple \
perl-Text-Balanced \
perl-Text-Diff \
perl-Text-Glob \
perl-Text-Template \
perl-Thread-Queue \
perl-Time-Piece \
perl-TimeDate \
perl-Try-Tiny \
perl-Unicode-Collate \
perl-WWW-RobotRules \
perl-XML-NamespaceSupport \
perl-XML-Parser \
perl-XML-SAX \
perl-XML-SAX-Base \
perl-XML-Simple \
perl-XML-Twig \
perl-autodie \
perl-bignum \
perl-devel \
perl-encoding \
perl-experimental \
perl-inc-latest \
perl-libnetcfg \
perl-libwww-perl \
perl-local-lib \
perl-open \
perl-perlfaq \
perl-srpm-macros \
perl-utils \
perl-version \
python-srpm-macros \
python3-pyparsing \
python3-rpm-macros \
qt5-srpm-macros \
redhat-rpm-config \
rust-srpm-macros \
systemtap-sdt-devel \
perl-TermReadKey \
perl \
perl-DBD-MySQL \
perl-DBI

After this, and only in the Community version, you will need to install the following package:

dnf install -y https://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29/RPM%20CentOS%2C%20RHEL/perl-Net-Telnet-3.04-1.el8.noarch.rpm

After these steps, we will disable SELINUX and the firewall.

setenforce 0
sed -i -e "s/^SELINUX=.*/SELINUX=disabled/g" /etc/sysconfig/selinux
systemctl disable firewalld --now

Then we can start configuring the database:

systemctl start mysqld
mysql -uroot -p$(grep "temporary password" /var/log/mysqld.log | rev | cut -d' ' -f1 | rev)
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('Pandor4!');
UNINSTALL PLUGIN validate_password;
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('pandora');
quit
echo "create database $DBNAME" | mysql -uroot -ppandora -P$DBPORT -h$DBHOST
echo "GRANT ALL PRIVILEGES ON $DBNAME.* TO \"$DBUSER\"@'%' identified by \"$DBPASS\"" | mysql -uroot -ppandora -P$DBPORT -h$DBHOST

We will also generate the file my.cnf.


POOL_SIZE=$(grep -i total /proc/meminfo | head -1 | awk '{print $(NF-1)*0.4/1024}' | sed s/\\..*$/M/g)
cat > /etc/my.cnf << EO_CONFIG_F
[mysqld]
datadir=/var/lib/mysql
socket=/var/lib/mysql/mysql.sock
user=mysql
character-set-server=utf8
skip-character-set-client-handshake
# Disabling symbolic-links is recommended to prevent assorted security risks
symbolic-links=0
# Mysql optimizations for Pandora FMS
# Please check the documentation in http://pandorafms.com for better results
max_allowed_packet = 64M
innodb_buffer_pool_size = $POOL_SIZE
innodb_lock_wait_timeout = 90
innodb_file_per_table
innodb_flush_log_at_trx_commit = 0
innodb_flush_method = O_DIRECT
innodb_log_file_size = 64M
innodb_log_buffer_size = 16M
innodb_io_capacity = 100
thread_cache_size = 8
thread_stack    = 256K
max_connections = 100
key_buffer_size=4M
read_buffer_size=128K
read_rnd_buffer_size=128K
sort_buffer_size=128K
join_buffer_size=4M
query_cache_type = 1
query_cache_size = 64M
query_cache_min_res_unit = 2k
query_cache_limit = 256K
sql_mode=""
[mysqld_safe]
log-error=/var/log/mysqld.log
pid-file=/var/run/mysqld/mysqld.pid
EO_CONFIG_F


Once the changes have been saved, it will be necessary to restart the mysqld service.

systemctl restart mysqld 

And we will enable the services mysql, apache and php.

systemctl enable mysqld --now
systemctl enable httpd --now
systemctl enable php-fpm --now

With all the environment ready, it's time to install Pandora FMS. The first thing will be to create a directory to store all the data.

mkdir $HOME/pandora && cd $HOME/pandora

Template warning.png

It will be necessary to download the packages of the console, enterprise console and enterprise server from Sourceforge or the links provided by the support team.

 


With the packages already prepared, we can start the installation:

yum install -y $HOME/pandora/pandorafms*.rpm

Pandora server installation (only for the Enterprise version):

tar xvfz $HOME/pandora/pandorafms_server* && cd pandora_server && ./pandora_server_installer --install --ha; cd -

Once the process is finished, we will populate the database:

mysql -u$DBUSER -p$DBPASS -P$DBPORT -h$DBHOST $DBNAME < $PANDORA_CONSOLE/pandoradb.sql
mysql -u$DBUSER -p$DBPASS -P$DBPORT -h$DBHOST $DBNAME < $PANDORA_CONSOLE/pandoradb_data.sql

Then we will have to configure the console.

cat > $CONSOLE_PATH/include/config.php << EO_CONFIG_F
<?php
\$config["dbtype"] = "mysql";
\$config["dbname"]="$DBNAME";
\$config["dbuser"]="$DBUSER";
\$config["dbpass"]="$DBPASS";
\$config["dbhost"]="$DBHOST";
\$config["homedir"]="/var/www/html/pandora_console";
\$config["homeurl"]="/pandora_console";	
error_reporting(0); 
\$ownDir = dirname(__FILE__) . '/';
include (\$ownDir . "config_process.php");
EO_CONFIG_F
cat > /etc/httpd/conf.d/pandora.conf << EO_CONFIG_F
<Directory "/var/www/html">
   Options Indexes FollowSymLinks
   AllowOverride All
   Require all granted
</Directory>
EO_CONFIG_F
sed -i -e "s/php_flag engine off//g" $PANDORA_CONSOLE/images/.htaccess
sed -i -e "s/php_flag engine off//g" $PANDORA_CONSOLE/attachment/.htaccess 
chmod 600 $CONSOLE_PATH/include/config.php	
chown apache. $CONSOLE_PATH/include/config.php
mv $CONSOLE_PATH/install.php $CONSOLE_PATH/install.done


Then we will prepare the file php.ini.

sed -i -e "s/^max_input_time.*/max_input_time = -1/g" /etc/php.ini
sed -i -e "s/^max_execution_time.*/max_execution_time = 0/g" /etc/php.ini
sed -i -e "s/^upload_max_filesize.*/upload_max_filesize = 800M/g" /etc/php.ini
sed -i -e "s/^memory_limit.*/memory_limit = 500M/g" /etc/php.ini
cat > /var/www/html/index.html << EOF_INDEX
<meta HTTP-EQUIV="REFRESH" content="0; url=/pandora_console/">
EOF_INDEX
systemctl restart php-fpm
systemctl restart httpd

The server configuration file will be prepared.

sed -i -e "s/^dbhost.*/dbhost $DBHOST/g" $PANDORA_SERVER_CONF
sed -i -e "s/^dbname.*/dbname $DBNAME/g" $PANDORA_SERVER_CONF
sed -i -e "s/^dbuser.*/dbuser $DBUSER/g" $PANDORA_SERVER_CONF
sed -i -e "s|^dbpass.*|dbpass $DBPASS|g" $PANDORA_SERVER_CONF
sed -i -e "s/^dbport.*/dbport $DBPORT/g" $PANDORA_SERVER_CONF

We will also enable the service ha.

systemctl enable pandora_ha --now
service tentacle_serverd start


In the Community version we will need to execute the following commands to enable the server:

systemctl enable pandora_server --now
systemctl start pandora_server
service tentacle_serverd start


Install Phantom.


wget https://downloads.sourceforge.net/project/pandora/Tools%20and%20dependencies%20%28All%20versions%29/DEB%20Debian%2C%20Ubuntu/phantomjs ; chmod +x phantomjs; mv phantomjs /usr/bin/

We will enable the cron of the console:

echo "* * * * * root wget -q -O - --no-check-certificate http://127.0.0.1/pandora_console/enterprise/cron.php >> /var/www/html/pandora_console/log/cron.log" >> /etc/crontab

Then you may go to the server ip and should enter the Pandora Console up and running


It is recommended to install the agent to automonitor the server.

1.11 Installation under Docker

1.11.1 Run the latest stable version

To run the latest stable version, type in:

   curl -sSL http://pandorafms.org/getpandora  | sh

Once Pandora FMS is running, point your browser to http://localhost/pandora_console and log-in as user admin (the default password is pandora).

Template warning.png

This command requires Docker Engine to be installed and running.

 


1.11.2 Advanced installation

Pandora FMS runs as a container under Docker environments. It can be launched as follows:

   docker run -d --name pandorafms pandorafms/pandorafms:7

Info.png

Docker images are updated on a daily basis

 


Info.png

The latest stable version is 7.

 


1.12 Installing the VMWare Virtual Machine

Alongside the Centos ISO, you can find a virtual machine which contains an already installed Pandora FMS ISO in Sourceforge. This image is tested with VMWare ESX, VMWare Workstation, VirtualBox and Hyper-V. To run it under Hyper-V, you are required to export the VMDX and VDH files from the 'MVDC.exe' executable. They are available after installing the Microsoft Virtual Machine Converter.

To install it, execute the '.ovf' file for 'Virtualbox' and 'VMWare Workstation'. And for ESX and Hyper-V, import the image under 'Import VM' and select the virtual image there.

The credentials for this machine are the following:

User: root

Password: pandora

Console User: admin

Password: pandora

MySQL user: root

Password: pandora

Template warning.png

Due to security reasons, please change the passwords used during the installation as soon as possible.

 


1.13 Installation under SUSE (OpenSUSE or SLES)

1.13.1 Automatized Installation by the Official Repository

To be able to choose this method -the fastest and most convenient-, access internet from the server where Pandora FMS is going to be installed. All steps must be executed as root (or under sudo).

Step 1: Create a repository :

#SLES 12 SP3
zypper ar -f http://firefly.artica.es/suse PandoraFMS_Official_Repo
zypper ar -f http://download.opensuse.org/repositories/server:/php:/applications/SLE_12_SP3/
zypper ar -f http://download.opensuse.org/repositories/devel:/languages:/perl/SLE_12_SP3/ Perl
wget --no-check-certificate https://dev.mysql.com/get/mysql80-community-release-sles12-1.noarch.rpm
rpm -i mysql80-community-release-sles12-1.noarch.rpm
#openSUSE (15.0)
zypper ar -f http://firefly.artica.es/suse PandoraFMS_Official_Repo
zypper ar -f http://download.opensuse.org/repositories/server:/php:/applications/openSUSE_Leap_15.0/ Php5
zypper ar -f http://download.opensuse.org/repositories/devel:/languages:/perl/openSUSE_Leap_15.0/Perl

wget --no-check-certificate https://dev.mysql.com/get/mysql80-community-release-sl15-1.noarch.rpm
rpm -ivh mysql80-community-release-sl15-1.noarch.rpm


Step 2: Update the repository's information:

zypper refresh

Step 3: Install Pandora FMS and some of its dependencies :

zypper install pandorafms_console pandorafms_server apache2-mod_php5

Template warning.png

From Pandora FMS version 729 onwards, PHP7 is needed for the console to work.

 


1.13.2 Manual RPM Installation

1.13.2.1 Previous Dependencies Installation

For this documentation, Suse Zypper system, that allows you to resolve dependencies and download packages directly from the repositories on the internet, will be used. If you do not have Zypper, install it, it is much more convenient and fast. If it is not possible, dependencies can be downloaded in. rpm format from the internet, but the process is considerably longer and more cumbersome.

The following package dependencies, included in the SUSE system, must be installed:

apache2 apache2-mod_php5 php5 php5-gd php5-gettext php5-json php5-mbstring php5-ldap php5-mysql \
php5-pear php5-snmp php5-zip nmap perl-DBD-mysql perl-DBI perl-Date-Calc perl-HTML-Parser \
perl-HTML-Encoding perl-HTML-Tree perl-IO-Socket-inet6 perl-Socket6 perl-Mail-Sendmail perl-NetAddr-IP \ 
perl-TimeDate perl-XML-Simple perl-XML-Twig perl-libwww-perl mysql-client mysql-max mysql  \
net-snmp xorg-x11-fonts-core php5-pear-db php5-curl php5-xmlrpc perl-SNMP graphviz graphviz-gd \
perl-Encode-Locale perl-JSON


Info.png

Unlike SLES, OpenSUSE does not have a 'mysql-max' package. You may install MySQL standard package instead without experiencing any issues.

 


Template warning.png

For versions of Pandora FMS 729 or higher, it is necessary to install the dependencies of PHP7 for correct console use

 


In order to install all dependencies execute:

zypper install ..

Followed by the whole package list, specified in the paragraph above, this is going to display a screen like the one below:

Getting repositories data...
Reading packets installed...
perl-DBI already installed.
perl-HTML-Parser already installed.
perl-TimeDate already installed.
perl-XML-Simple already installed.
perl-libwww-perl already installed.
xorg-x11-fonts-core already installed.
Resolving dependencies...

The following NEW packages will be installed:
  apache2 apache2-mod_php5 apache2-prefork apache2-utils libapr1 libapr-util1 libdnet1 
liblua5_1 libmm14 libmysqlclient15 mysql mysql-client mysql-Max net-snmp nmap 
perl-Bit-Vector perl-Carp-Clan perl-Data-ShowTable perl-Date-Calc perl-Date-Manip 
perl-DBD-mysql perl-HTML-Encoding perl-HTML-Tree perl-IO-Socket-inet6 
perl-Mail-Sendmail perl-NetAddr-IP perl-SNMP php5 php5-ctype php5-dom php5-gd 
php5-gettext php5-hash php5-iconv php5-json php5-ldap php5-mbstring php5-mysql 
php5-openssl php5-pdo php5-pear php5-snmp php5-sqlite php5-tokenizer php5-xmlreader 
php5-xmlwriter php5-zip php5-zlib t1lib perl-JSON

Total Size: 19.1 M. After the operation, additional 55.9 M will be used.
 Continue? [Yes / no]:

Click 'yes' to download Zypper and install the packages.

When finished, you will be required to install some extra packages. OpenSuse does not contain all the dependencies needed by Pandora FMS. Additional RPMs to meet these dependencies: from the Pandora FMS Sourceforge website. The additional RPMs are the following:

perl-time-format php-pear-xml_rpc wmic smstools perl-HTML-Tree perl-XML-Twig


Info.png

Extra packages like 'Perl-HTML-Tree' and 'Perl-XML-Twig' require manual installation.

 


Info.png

In Centos7 wmic it is not an explicit requirement for pandorafms_server but is still needed by the WMIServer. You can find the binary file at the SourceForge web site.

 



If you intend to use the Recon Server, install these additional packages:

perl-net-traceroute perl-net-traceroute-pureperl xprobe2

These RPM files can be found on the official distribution site of Pandora FMS Software in a specific dependency directory for OpenSUSE.

Info.png

Please make sure to download the appropriate packages for OpenSUSE.

 


Put them in a directory to install them, e.g.: '/tmp/extra' and execute the following command:

rpm -i *.rpm

1.13.2.2 Server Installation

Just execute:

rpm -i pandorafms_server-5.1SP2-1.noarch.rpm

1.13.2.3 Console Installation

Execute the RPM installation tool for packages in order to install the package which contains the Pandora FMS Console:

rpm -i pandorafms_console-5.1SP2-1.noarch.rpm

1.13.3 Uninstalling Pandora FMS

To uninstall any of Pandora FMS components, use any of the following commands:

rpm -e pandorafms_agent
rpm -e pandorafms_console
rpm -e pandorafms_server

The Pandora FMS database will not be uninstalled if any of the Pandora FMS packages are - but all files from any other package (including the configuration files) will be deleted, however the database must be deleted manually.

1.14 Installation in Red Hat Enterprise Linux / Fedora / CentOS

The installation process is nearly the same as the one from SUSE. Keep in mind that RHEL, CentOS or Fedora RPM packages are not the same as the ones in SUSE - since SUSE RPMs use a different package version, with a different compression algorithm which makes them incompatible.

First of all, activate certain official Redhat/Centos/Fedora repositories to perform dependency installation. The repositories to be activated are EXTRAS, UPDATES and the additional installation of the EPEL repository.

Edit /etc/yum.repos.d/CentOS-Base.repo and enable EXTRAS, and UPDATES repos. Usually it should be something similar to this:


[updates]
name=CentOS-$releasever - Updates
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates
gpgcheck=0

[extras]
name=CentOS-$releasever - Extras
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=extras
gpgcheck=0

Add the EPEL repository:

[EPEL]
Name = EPEL
baseurl = http://dl.fedoraproject.org/pub/epel/$releasever/$basearch/
enabled = 1
gpgcheck = 0

Please refresh your repository information with this command:

yum makecache

1.14.1 Installation using official Pandora FMS Repository

YUM and access to the Internet is required. First, create a reference to the Pandora FMS official repository for CentOS 7. This also applies for the usage under RHEL7.

vi /etc/yum.repos.d/pandorafms.repo

Add these contents:

[artica_pandorafms]
name=CentOS7 - PandoraFMS official repo
baseurl=http://firefly.artica.es/centos7
gpgcheck=0
enabled=1


Refresh your repository information:

yum makecache

And install Pandora FMS, along with the mysql server (it is an optional dependency, but MySQL server is needed if you do not have one already installed or accessible in another server).

yum install pandorafms_console pandorafms_server mariadb-server

Download all the necessary packages and leave the system ready for configuration and use.

Info.png

Mariadb-server replaces the mysql-server package, but it depends on the used distro (CentOS is not the same as RHEL, one or the other must be used, being the differences almost unnoticeable when using Pandora FMS).

 


1.14.2 Manual Installation through RPM Files

Most dependencies should be resolved using YUM or another automatic tool. All dependencies are marked as required packages in the RPM definition. If you have already configured the required repositories in the previous step, this operation will be almost automatic.

In the case of CentOS it will be necessary to install the following dependencies:

yum install php php-gd graphviz php-mysql php-pear-DB php-zip php-mbstring php-ldap php-snmp php-ldap php-common make perl-CPAN perl-HTML-Tree perl-DBI perl-DBD-mysql perl-libwww-perl perl-XML-Simple perl-XML-Twig perl-XML-SAX perl-NetAddr-IP net-snmp perl-SNMP net-tools perl-IO-Socket-INET6 perl-Socket6 nmap sudo xprobe2 perl-Encode-Locale php-xmlrpc libxslt php-xml

It is possible that if you use Fedora or Redhat the names of some packages are slightly different, so use these in addition to the previous ones:

yum install net-snmp-perl perl-JSON perl-NetAddr-IP perl-Socket6 \
perl-Time-HiRes perl-XML-Twig perl-IO-Socket-INET6

Some dependencies (like 'wmic' or 'xprobe2') are not contained in the official RHEL repositories. They are provided on our Sourceforge download page in the "Tools and Dependecies" section [1].

In the meantime, for Red Hat Enterprise Linux 6 just install these ones, since several of the packages required for the console and server are included in the php and perl and serial dependencies:

yum install php php-common graphviz

yum install perl-HTML-Tree perl-DBD-mysql perl-XML-Simple perl-XML-SAX \
perl-NetAddr-IP net-snmp perl-SNMP net-tools perl-IO-Socket-INET6 perl-Socket6 nmap wmic xprobe2

Template warning.png

If you are using a version prior to RHEL6, some dependencies could have another name. In the case of perl-SNMP, in CentOS5, RHEL5, etc, the dependency to obtain would be net-snmp-perl.

 


Template warning.png

For versions of Pandora FMS 729 or higher, it is necessary to install the PHP7 dependencies for a correct console use

 


In order to install the RPM, just use the 'rpm -i' or the yum command directly:

rpm -i pandorafms_server-x.x-x.noarch.rpm

or

yum install pandorafms_server-x.x-x.noarch.rpm

If you encounter any problems when you try to access the Pandora FMS Console installation web page, check whether SELinux is active: In this case, it is mandatory to deactivate it. Please follow the FAQ procedures in such case.


Template warning.png

RHEL and CentOS 5.x use PHP 5.1 by default. This version is not compatible with Pandora FMS. You are required to use PHP version 5.2 or higher. Tested in php55w. For versions of Pandora FMS 729 or higher, its required to use PHP version 7.2

 


To do so, it is recommended to use the following repository for CentOS6/RHEL6, which contains PHP 5.6:

[remi]
name=Les RPM de remi pour Enterprise Linux 6 - $basearch
#baseurl=http://rpms.famillecollet.com/enterprise/6/remi/$basearch/
 mirrorlist=http://rpms.famillecollet.com/enterprise/6/remi/mirror
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-remi


[remi-php56]
name=Les RPM de remi de PHP 5.6 pour Enterprise Linux 6 - $basearch
#baseurl=http://rpms.famillecollet.com/enterprise/6/php56/$basearch/
 mirrorlist=http://rpms.famillecollet.com/enterprise/6/php56/mirror
# WARNING: If you enable this repository, you must also enable "remi"
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-remi


GPG key for remi repository can be found here: http://rpms.remirepo.net/RPM-GPG-KEY-remi

1.14.3 Uninstalling Pandora FMS in CentOS/RHEL

Just execute the command

yum remove pandorafms_console pandorafms_server

If MySQL is installed but it is no longer needed, it can also be deleted with the same command:

yum remove mysql-server

1.15 Installation in Debian and Ubuntu

Installing Pandora FMS version 10.04 or higher is recommended. In Debian Stable version (Squeeze), there are problems with some libraries and applications that Pandora FMS needs for some components. Debian LWP library does not implement certain methods for SSL, and this is necessary for Enteprise modules of WEB monitoring. It can be fixed by installing a newer version of LWP using CPAN (manual method).

When installing it, add the official repositories of each version. For example, to install the libencode-locale-perl and snmp-mibs-downloader packages in a Debian Squeeze, add the following repositories to the file named /etc/apt/sources.list


deb http://ftp.us.debian.org/debian/ squeeze main non-free
deb http://ftp.at.debian.org/debian-cd/ squeeze-backports main

Alternatively, for Debian Wheezy:

deb http://ftp.debian.org/debian/dists/Debian9.6/ wheezy-backports main
deb http://ftp.us.debian.org/debian/ wheezy main non-free

Once they have been added, execute 'apt-get update' to apply the changes.

Due to the way in which Debian/Ubuntu manages the packages, it is more than recommended to install Pandora FMS in a system that has access to the online package repositories (or a replica in the local network). A dependency on Debian can involve dozens of sub-dependencies, so preparing an accurate list of packages needed for offline installation can be a very complex task.

1.15.1 Installation with Artica Private Repository

There is also a much quicker and easier method: just add the Artica Private Repository. It contains any and all the Ubuntu and Debian packages you might require.

In order to do so, edit the file '/etc/apt/sources.list' and add the following line:

For Debian Squeeze:

deb http://firefly.artica.es/debian/squeeze /

For Debian Wheezy:

deb http://firefly.artica.es/debian/wheezy /

Execute as root (sudo)

apt-get update

Installation of Pandora FMS by apt-get:

[email protected]:~# apt-get install pandorafms-console pandorafms-server pandorafms-agent-unix
Reading package lists... Done
Building dependency tree       
Reading state information... Done
The following extra packages will be installed:
  apache2-mpm-prefork apache2-utils apache2.2-common dbconfig-common graphviz libapache2-mod-php5 libcgraph5 libcurl3 libgd2-xpm libgvpr1
  libio-socket-inet6-perl libnetaddr-ip-perl libonig2 libqdbm14 libsnmp-perl libsocket6-perl libssh2-1 libtime-format-perl
  libxml-namespacesupport-perl libxml-sax-expat-perl libxml-sax-perl libxml-simple-perl nmap php-db php-gettext php-pear php5 php5-cli php5-common
  php5-curl php5-gd php5-ldap php5-mysql php5-snmp php5-suhosin php5-xmlrpc smistrip snmp snmp-mibs-downloader snmpd xprobe
Suggested packages:
  apache2-doc apache2-suexec apache2-suexec-custom graphviz-doc libgd-tools php5-dev
The following packages will be REMOVED:
  libgd2-noxpm
The following NEW packages will be installed:
  apache2-mpm-prefork apache2-utils apache2.2-common dbconfig-common graphviz libapache2-mod-php5 libcgraph5 libcurl3 libgd2-xpm libgvpr1
  libio-socket-inet6-perl libnetaddr-ip-perl libonig2 libqdbm14 libsnmp-perl libsocket6-perl libssh2-1 libtime-format-perl
  libxml-namespacesupport-perl libxml-sax-expat-perl libxml-sax-perl libxml-simple-perl nmap pandorafms-agent-unix pandorafms-console
  pandorafms-server php-db php-gettext php-pear php5 php5-cli php5-common php5-curl php5-gd php5-ldap php5-mysql php5-snmp php5-suhosin php5-xmlrpc
  smistrip snmp snmp-mibs-downloader snmpd xprobe
0 upgraded, 44 newly installed, 1 to remove and 0 not upgraded.
Need to get 40.9 MB of archives.
After this operation, 90.8 MB of additional disk space will be used.
Do you want to continue [Y/n]? y
WARNING: The following packages cannot be authenticated!
  pandorafms-agent-unix pandorafms-console pandorafms-server
Install these packages without verification [y/N]? y

Template warning.png

For versions of Pandora FMS 729 or higher, it is necessary to install the dependencies of PHP7 for a correct use of the console

 


1.15.2 Manual Installation by DEB Packages

Under Debian or Ubuntu, the dependencies are the following:

Server:

snmp snmpd libtime-format-perl libxml-simple-perl libdbi-perl libnetaddr-ip-perl
libhtml-parser-perl wmi-client xprobe2 nmap traceroute 
libio-socket-inet6-perl libhtml-tree-perl libsnmp-perl snmp-mibs-downloader
libio-socket-multicast-perl libsnmp-perl libjson-perl libencode-locale-perl


Info.png

If the 'wmi-client' package is not available in the repositories, download it from the Pandora FMS Sourceforge website.

 


Info.png

If you are installing Pandora FMS in a Debian Squeeze, add the "Non-Free" repository to access the snmp-mibs-downloader package.

 


Console:

php5 libapache2-mod-php5 apache2 mysql-server php5-gd php5-mysql php-pear php5-snmp php-db php-gettext 
graphviz mysql-client php5-curl php5-xmlrpc php5-ldap

Template warning.png

For versions of Pandora FMS 729 or higher, it is necessary to install the dependencies of PHP7 for a correct use of the console

 


In order to install the Server package or the console, implement all of the required dependencies. This is done by installing all the previously mentioned packages by using the command apt-get along with root privileges:

apt-get install  snmp snmpd libtime-format-perl libxml-simple-perl libxml-twig-perl libdbi-perl 
libnetaddr-ip-perl libhtml-parser-perl wmi-client xprobe2 nmap libmail-sendmail-perl traceroute 
libio-socket-inet6-perl libhtml-tree-perl libsnmp-perl snmp-mibs-downloader libio-socket-multicast-perl
libsnmp-perl libjson-perl php5 libapache2-mod-php5 apache2 mysql-server php5-gd php5-mysql php-pear 
php5-snmp php-db php-gettext graphviz mysql-client php5-curl php5-xmlrpc php5-ldap dbconfig-common


This command will install all the dependencies required to install the Pandora FMS Server and its console into a Debian or Ubuntu system.

Installation with the DEB packages is very easy.

If there is no internet connection, install the dependencies. Then install the Pandora FMS packages, in this example all Pandora FMS components are installed together.

dpkg -i pandorafms-console_xxx.deb pandorafms-server_xxxx.deb

Once the command has been executed, you might see that some dependencies are missing. If so, you can try to solve it automatically by using the following command:

apt-get -f install

This will attempt to download all the necessary missing packages from the automated installation of Pandora FMS on the system. Once the necessary packages have been installed, continue with the installation of all Pandora FMS components.

Template warning.png

In some Ubuntu versions you must move the /var/www/pandora_console/ directory to the public directory of the web server by default /var/www/html/pandora_console

 


In order to complete the installation of the Pandora FMS Console, access the console URL and follow the steps suggested by the installation wizard. If the console is installed on a server with the IP '10.20.34.54', enter the following URL:

http://10.20.34.54/pandora_console

1.15.3 Uninstalling Pandora FMS

dpkg -r pandorafms-console-enterprise
dpkg -r pandorafms-console

1.16 Installation in FreeBSD

To install Pandora FMS server, FreeBSD 10.x or later is recommended. If you want to install it to FreeBSD 9.x or earlier with the following instructions, the package management system of FreeBSD should be updated to pkgng.

1.16.1 Previous Dependencies Installation

In FreeBSD, the dependencies are the following:

Server:

p5-DBI p5-Mail-Sendmail p5-NetAddr-IP p5-XML-Simple p5-Time-Format p5-HTML-Parser
p5-Net-Traceroute-PurePerl p5-IO-Socket-INET6 p5-DBD-mysql p5-XML-Twig p5-JSON
net-snmp nmap xprobe coreutils net-snmp wmi-client

In order to install the Pandora FMS Server, implement all the dependencies before doing so. It is recommended to do so by using pkg command.

You may install all the necessary dependencies in the following way:

e.g.) p5-DBI installation.

pkg install p5-DBI

Console:

apache24, php5, php5-snmp, php5-session, php5-gettext, php5-mbstring, php5-ldap,
php5-mysql, php5-gd, php5-zip, php5-zlib, php5-json, php5-curl, php5-filter, pear,
pear-DB, pear-XML_RPC, graphviz

In order to install the Pandora FMS Console, implement all of the previously mentioned dependencies. You may use the packages to do so.

Template warning.png

From Pandora FMS version 729 onwards, PHP7 is needed for the console to work.

 


1.16.2 Console Installation

There are no Pandora FMS Console package files for FreeBSD. The Pandora FMS console must be installed by using the installer.

Installation via the installer is described in the section named 'Manual Installation from Sources in Linux/Unix' below.

Under FreeBSD with apache 2.4, the Pandora FMS console directory is:

/usr/local/www/apache24/data/pandora_console

1.16.3 Server Installation

There are no Pandora FMS Server package files for FreeBSD. You are required to install the Pandora FMS Server by using the installer.

Installation via the installer is described in the section named 'Manual Installation from Sources in Linux / UNIX' below.

The file locations and startup script structures are different from Linux. The FreeBSD-specific procedures are shown below.

After installation, add the following lines to the '/etc/rc.conf' file:

pandora_server_enable="YES"
tentacle_server_enable="YES"

These settings are required to enable Pandora FMS, Pandora FMS Servers and Tentacle. Otherwise, they are not going to be launched.

On FreeBSD, most of the Pandora FMS server's files are going to be installed in the directory named '/usr/local'.

pandora_server, tentacle_server:

/usr/local/bin/pandora_server
/usr/local/bin/tentacle_server

Startup script:

/usr/local/etc/rc.d/pandora_server
/usr/local/etc/rc.d/tentacle_server

Configuration file:

/usr/local/etc/pandora/pandora_server.conf

util:

/usr/local/share/pandora_server/util/*

Man pages:

/usr/local/man/man1/*

Other:

The 'data_in' and log directories are the same as the ones under Linux.

1.17 Installation in NetBSD

From versions 5.0 and above, Pandora FMS supports the use of NetBSD.

1.17.1 Previous Dependencies Installation

In NetBSD, the dependencies are as follows:

Server:

mysql55-server databases/p5-DBI mail/p5-Mail-Sendmail net/p5-NetAddr-IP textproc/p5-XML-Simple 
time/p5-Time-Format www/p5-HTML-Parser net/nmap net/p5-IO-Socket-INET6
database/p5-DBD-mysql textproc/p5-XML-Twig  sysutils/coreutils converters/p5-JSON net/net-snmp

In order to install the Pandora FMS Server, implement all of the dependencies (using 'pkgsrc', recommended) before doing so.

You may install all dependencies like this:

e.g.) p5-DBI installation.

cd /usr/pkgsrc/databases/p5-DBI
make
make install

Next, install 'Net::Traceroute::PurePerl' and 'LWP::Simple' using CPAN.

perl -MCPAN -e 'install Net::Traceroute::PurePerl'
perl -MCPAN -e 'install LWP::Simple'

'xprobe' is also required to be installed by compiling the source package.

You may download it from :

http://sourceforge.net/projects/xprobe/files/latest/download

If you are unable to compile it without some errors showing up, modify the following files and try again:

  • Add ' include <cstdlib> ' to 'libs-external/USI++/src/ip.cc'.
  • Add ' include <cstdlib> ' to 'libs-external/USI++/src/misc.cc'.
  • Add ' include <cstring> ' to 'libs-external/USI++/usi++/tcp.h'.

Console:

www/apache22, lang/php54, net/php-snmp, www/ap-php, devel/php-gettext,
converters/php-mbstring, databases/php-ldap, databases/php-mysql, raphics/php-gd,
archivers/php-zip, archivers/php-zlib, textproc/php-json, www/php-curl, lang/pear, 
databases/pear-DB, graphics/graphviz, 

In order to install Pandora FMS Console, implement all of the dependencies before doing so. You may use 'pkgsrc' for that.

Template warning.png

From version 729 of Pandora FMS it is necessary to update to PHP7 for the proper functioning of the tool

 


In addition, install the 'XML_RPC' using the 'pear' command as shown below.

pear install XML_RPC

1.17.2 Console Installation

There are no Pandora FMS Console package files for NetBSD. Install the Pandora FMS console by using the installer.

How to install it by means of the installer is described in the section named 'Manual Installation from Sources in Linux/Unix' below.

On NetBSD with apache 2.2, the Pandora FMS Console directory is the one mentioned below.

/usr/pkg/share/httpd/htdocs/pandora_console

1.17.3 Server Installation

There are no Pandora FMS Server package files for NetBSD. Install the Pandora FMS server by using the installer.

Installation via the installer is described in the section named 'Manual Installation from Sources in Linux/Unix' below.

File locations and startup script structures are different from the ones under Linux. NetBSD specific procedures are shown below.

After installation, add the following lines to '/etc/rc.conf':

pandora_server="YES"
tentacle_server="YES"

To enable the Pandora FMS Servers, Pandora FMS and Tentacle, these settings are required. Otherwise, they will not be launched.

On NetBSD, most of the Pandora FMS Server files are installed under '/usr/local'.

pandora_server, tentacle_server:

/usr/local/bin/pandora_server
/usr/local/bin/tentacle_server

Startup script:

/etc/rc.d/pandora_server
/etc/rc.d/tentacle_server

Configuration file:

/usr/local/etc/pandora/pandora_server.conf

util:

/usr/local/share/pandora_server/util/*

Man pages:

/usr/share/man/man1/*

Other: The 'data_in' and log directories are the same as the ones under Linux.

1.18 Manual Installation from Sources under Linux / UNIX / MAC OS

It will be necessary to download the files in "tarball" format (. tar. gz,. tgz or. tar. bz2) and unzip them. To do it, locate the latest version of Pandora FMS and download the files from here: https://sourceforge.net/projects/pandora/files/.


1.18.1 Console Installation

Once you have opened the console zip file, follow these steps:

1. Acquire root privileges by entering:

su -

2. Copy to '/tmp' and execute:

tar xvzf pandorafms_console-X.Y.tar.gz 
cd pandora_console
./pandora_console_install --install

1.18.2 Server Installation

Once you have opened the server zip file named 'pandorafms_server-3.0.0.tar.gz' or similar, follow the steps described below:

1. Acquire root privileges:

su - 

2. Copy it to '/tmp' and execute:

tar xvzf pandorafms_server-X.Y.tar.gz 
cd pandora_server
./pandora_server_installer --install

If you experience any dependency-related problems, fix them before attempting any installation. It might be possible to force the installation and ignore the problems with the dependencies, but Pandora FMS will not work properly in that case.

1.18.3 Server Manual Installation (from source code)

Alternatively to the general installation script, you can "compile" the Pandora FMS code through the Perl interpreter of your system. This process simply installs the minimum libraries and executables, but does not alter the boot script system, maintenance scripts, configuration or anything else that strictly concerns the application and its libraries. This process is recommended when the server code must be updated, but without overwriting its configuration.

To do it properly, unzip your server code to /tmp, as described in the previous step.

1. Acquire root privileges:

su - 

2. Copy it to '/tmp' and once there, execute:

tar xvzf pandorafms_server-X.Y.tar.gz 
cd pandora_server
perl Makefile.PL
make
make install

If any dependency is missing or there is another problem, the system will warn you. If you see a message similar to:

Warning: prerequisiete Mail::Sendmail 0 not found
Warning: prerequisiete Net::Traceroute::PurePerl 0 not found

It means that there are some Perl packages that Pandora FMS needs and that the system does not have them installed. Check the previous paragraphs to know how to install the necessary dependencies to be able to install Pandora FMS. However, you can temporarily ignore these warnings (that is why they are warnings and not errors) and force the installation. But you will surely have problems at one time or another since you are missing a component needed to function. However, if you know that the component that is not installed will not be used (e. g. traceroute is used exclusively for Pandora FMS Recon Server), you can continue without any problem.

After this process, these files are automatically copied:

/usr/local/bin/pandora_server
/usr/local/bin/pandora_exec

And several. pm files (Perl libraries) that Pandora FMS needs. Those. pm libraries are copied to different directories, depending on the version of your distribution and distribution. For example in Ubuntu 9.04 they are copied to:

/usr/local/share/perl/5.10.0/PandoraFMS/

In SUSE/SLES 11 they are copied to:

/usr/lib/perl5/site_perl/5.10.0/PandoraFMS/

1.19 Installing the Enterprise Version

To install the Enterprise version of Pandora FMS, install the packages "Open" of the Console and Server, and then add the packages "Enterprise" of each one. In the case of the Console use one package or another, depending on the installed distribution.

1.19.1 Enterprise Console Installation

For Red Hat Enterprise Linux / CentOS / Fedora:

rpm -i pandorafms_console_enterprise-X.X.noarch.rpm

For SUSE:

rpm -i pandorafms_console_enterprise-X.X.noarch.rpm

For Debian / Ubuntu:

dpkg -i pandorafms_console_enterprise_xxx.deb

To install the Enterprise Console by using the source code:

Once you have opened the console and arrived at the location of the compressed file named 'pandorafms_console-X.X.tar.gz' or similar, follow the steps mentioned bellow:

1. Acquire root privileges by entering:

su -

2. Copy it to '/tmp' and then execute:

tar xvzf pandorafms_console-X.Xtar.gz 

Later, copy it to the directory in which your Pandora FMS open-source console is installed. It must be either '/var/www/pandora_console' for Debian or Ubuntu, or '/srv/www/htdocs/pandora_console/' for SUSE, RH, Fedora, etc. (or any other directory, depending on your distribution).

Debian:

cp -R enterprise /var/www/pandora_console

SUSE:

cp -R enterprise /srv/www/htdocs/pandora_console

3. Just change the permissions in case the files are intended to get used by the web server user, e.g.:

Debian:

chown -R www-data /var/www/pandora_console/enterprise

SUSE:

chown -R wwwrun /srv/www/htdocs/pandora_console/enterprise

It is recommended to conduct the License Activation at this point.

1.19.2 Enterprise Server Installation

First, make sure the Open version of the server is installed. Then proceed to install the enterprise version in order to install the Enterprise Server.

Once you have the zip file with the server, named pandorafms_server_enterprise-X. X. tar. gz or similar, follow the steps mentioned below:

Template warning.png

We are working on a pilot version that will include upgrades in the Enterprise server. From 738 update on, it is advised to use Pandora FMS Enterprise server version E7. Version E6 should only be used in case of compatibility issues.

 



1. Acquire root privileges:

su - 

2. Copy it to '/tmp' and execute:

tar xvzf pandorafms_server_enterprise-X.X.tar.gz 
cd pandora_server/
# ./pandora_server_installer --install

If the Pandora FMS Server Binary is not contained in the default directory '/usr/bin', indicate the directory as follows:

# PREFIX=/usr/local ./pandora_server_installer --install

After installing, restart the server (/etc/init.d/pandora_server restart). Then, the Enterprise Servers will be shown as enabled.

Template warning.png

Do not restart the server until the Pandora FMS Enterprise license key installation is completed, otherwise the server will not start and your monitoring service will be interrupted.

 


Pandora server view.png

1.19.2.1 Installing on a different path

To install the Pandora FMS Server on a different path, specify it with the --destdir option:

./pandora_server_installer --install --destdir <path>

After the installation, configure the Pandora FMS server manually to run at startup and configure the database maintenance script, pandora_db, to run periodically. For example, on Linux (replace <destdir> with the actual path passed to --destdir):

ln -s <destdir>/etc/init.d/pandora_server /etc/init.d/
echo "\"<destdir>/usr/share/pandora_server/util/pandora_db\" \
\"<destdir>/etc/pandora/pandora_server.conf\" >/dev/null 2>&1" > /etc/cron.hourly/pandora_db

1.19.2.2 Running as a non-privileged user

To make the Pandora FMS server run as a non-privileged user, install it as the user you want it to run as with the --no-root option:

./pandora_server_installer --install --no-root

1.19.2.3 Installing with a non-privileged user

--no-root can be combined with --destdir to install the Pandora FMS server with an unprivileged user, as long as this user has write permissions on the path passed to --destdir. For example:

./pandora_server_installer --install --no-root --destdir /opt/pandora

1.19.2.4 Phantomjs / PDF reports special install

Phantomjs is a special component that is used to dynamically generate PDF graphs. It is required from version NG/724 onwards and replaces the previous system of PDF graphs. It will be necessary to install it in all the consoles and servers where PDF reports can be generated in an interactive way, by means of programmed execution or where it executes alerts that include embedded graphics.

If you are using an ISO image of the NG/724 version or later, there is no need to install anything because the system already has the library installed.

If not, follow these steps to install Phantomjs:

  1. In case the installation is going to be performed in a Linux system, the dependencies required by the program are: fontconfig freetype freetype-devel fontconfig-devel libstdc++. On windows these are not necessary.
  2. Download phantomjs. The tests performed during the development of this feature were based on phantomjs 2.1.1. You can get this version from the following links:
    1. Linux [2].
    2. Windows: [3].
    3. Official page: http://phantomjs.org/download.html.
  3. If you add phantomjs to the system path, no further configuration is necessary. Otherwise it will be necessary to configure the path to the phantomjs binary file in the Pandora FMS Console. To achieve this, go to Settings > General > phantomjs bin path. The user providing the web pages (Apache by default) should be able to run this file in the selected location.
yum install -y fontconfig freetype freetype-devel fontconfig-devel libstdc++
mkdir -p /opt/phantomjs/bin && cd /opt/phantomjs/bin
wget "https://netcologne.dl.sourceforge.net/project/pandora/Tools%20and%20dependencies%20%28All%20versions%29/DEB%20Debian%2C%20Ubuntu/phantomjs" 
chmod +x phantomjs
ln -s /opt/phantomjs/bin/phantomjs /usr/bin/

1.20 Server and Console Installation in Windows

From Pandora FMS versions 5.1 and above, there is a Windows installer which allows you to install: Nginx, PHP, MySQL, Pandora FMS and some dependencies necessary for the server and console operation under Windows.



Template warning.png

Pandora FMS Console & server setup in Windows is not recommended for production systems, due to inferior performance compared to Linux. It is being worked on to make it more stable and faster in future versions .

 




Template warning.png

From Pandora FMS version 729 onwards, PHP7 is needed for the console to work.

 


Some features of the Pandora FMS server rely on a Linux-based operating system and do not work on Windows:

It is delivered as an installer in executable format (. exe) and for its basic installation you only have to accept all the options listed below.

Select the language:

Pandora agent 3.0 RC3 install windows 01 eng.png

Follow the installer steps:

Pandora server install windows 011.png

Accept the license terms:

Pandora server install windows 021.png

Select the components to install:

Pandora server install windows 031.png

Template warning.png

If you have a previous version of the Console and the Server already installed and you want an update, check only the 'Update installed version' option.

 


Info.png

Nginx is a web server that replaces Apache, which was used in previous versions. This new server uses PHP with FastCGI, improving the Console performance.

 


This installer is mainly prepared for an installation on a computer which does not have Nginx or MySQL already installed. In case you have any other web server, such as IIS: it can be enabled, although you must disable it in order to work through Nginx.

If you have a MySQL Server installed and running on the computer before installing the remaining components of Pandora FMS, replace the MySQL root password by "pandora". This change is necessary in order for the database to be created which has to be able to assign permissions to the Pandora FMS Database correctly. Once you have installed Pandora FMS on your computer, please feel free to replace the password.

After selecting the components to install, specify the installation path:


Pandora server install windows 041.png

The components are going to be installed. The only component which requires a user validation is Nginx. It will ask for the Pandora FMS server's name or IP address:

Pandora server install windows 051.png


As explained above, other components are installed besides MySQL and Nginx. In case they are already installed, you may see a message like this:

Pandora server install windows 06.png

Please remember that Microsoft Visual C++ is required for the modules to work properly.

Pandora server install windows 06 21.png

Nginx requires Microsoft Visual C++ 2012, while if you are running a Windows 2008 Professional R2 system, you will need to install Microsot Visual C++ 2008. Installing Microsoft Visual C++ 2010 SP1 Redistributable Package might be required as well for Nmap and the ICMP Enterprise Server to work properly.


Microsoft Visual C++ 2008

https://www.microsoft.com/en-us/download/details.aspx?id=29


Microsoft Visual C++ 2010 SP1 Redistributable Package

https://www.microsoft.com/en-us/download/details.aspx?id=8328


Visual C++ 2012 (Update 4)

https://www.microsoft.com/en-US/download/details.aspx?id=30679

Visual C++ 2015

https://www.microsoft.com/es-es/download/details.aspx?id=48145

Please wait until the files are copied and all the setup-related settings are carried out.

Pandora server install windows 071.png

Until the installation is complete as shown below.

Pandora server install windows 081.png

Once completed, the browser on the login screen will open automatically. In case Enterprise Version is installed, you will be asked for the license code which will be provided from Artica for implementation. Except for the Enterprise Version, the server is installed as a service and starts automatically during the installation process. If the installation of the Enterprise Version has been completed with no valid license code, the server will not boot.

In order to quickly start the process, click on 'Start' and 'Programs'.

Pandora server install windows 091.png

Once the service is running properly, a ready-to-use console with all the servers will appear as shown on the picture below.


Pandora server install windows 101.png


1.20.1 WMI module operation in some Windows versions

For security reasons, some Windows versions have limited users who can remotely query WMI. If these modules are not carried out, the solution is to run the service Satellite Server as an Administrator user.

The process to follow is:

Open the services:

Instalacion windows7e.png

Right click on the service and go to Properties

Instalacion windows8e.png

On the Log in window, select an account with Administrator permissions and apply changes:

Instalacion windows9e.png

And after these changes, restart the service.

1.20.2 Directories to consider in Windows

There are a set of directories you need to set correctly in Pandora FMS Setup, which are:

- Remote Config directory

- Attachment store

Path windows.png

- Server logs directory

Path windows2.png

- Graphviz binary directory

Path windows3.png


Template warning.png

It has been observed that it is necessary to install Microsoft Visual C++ 2008 in Windows 2008 Professional R2 for Apache to operate properly.

 


Microsoft Visual C++ 2008
http://www.microsoft.com/es-es/download/details.aspx?id=29

2 Initial Configuration after Installation

Post-installation order is:

  1. Create the database through the Pandora FMS web console installation wizard.
  2. Modify the server configuration including access credentials to the databases generated by the previous step.
  3. Boot the server.
  4. Start local agent (if needed).
  5. Access Pandora FMS console for the first time to start using Pandora FMS.

2.1 Tuning the settings in CentOS7

CentOS 7 is a good Linux distribution but it has small details that are included here briefly, which will make it easier to install Pandora FMS:

CentOS 7 does not install ifconfig, to install it :

 yum install net-tools

CentOS has a very aggressive firewall, and you need to disable it (later you can secure the server if needed):

 systemctl disable firewalld
 systemctl stop firewalld
CentOS 7 also has SELinux enabled by default, to disable it:
 setenforce 0
 sed -i 's/enforcing/disabled/g' /etc/selinux/config /etc/selinux/config

Program both the WEB server and the database server for booting:

 systemctl start httpd.service
 systemctl enable httpd.service
 systemctl enable mariadb.service

Template warning.png

We recommend to enable AllowOverride option in Apache server to enable .htaccess security directives included in Pandora FMS console from version 744 onwards.

 


Remove the private tmp from the systemd in Apache:

sed -i 's/PrivateTmp=true/PrivateTmp=false/g' /etc/systemd/system/multi-user.target.wants/httpd.service

2.2 Initial Console Configuration

It is assumed all components (Database, Console, Server and Agent) will be executed on the same machine. If you have not done it already, start the MySQL server and create an Admin password (root).

/etc/init.d/mysql start

Or, depending on the Linux version:

service mariadb start

Now create the password, for example "pandora123" for your MySQL root user:

mysqladmin password pandora123

Then start the Apache Server on your server:

/etc/init.d/apache2 start

Or:

service httpd start

Now it should be possible to access through the browser to the IP address of your Pandora FMS server and complete the database creation process.

If your server's IP is, for exmaple, '192.168.5.54', please type in the following line into the address bar of your browser:

http://192.168.5.54/pandora_console/install.php

From now on, follow the following steps in order to create the Pandora FMS DB.

Pandora install 1.png

Click on 'Next'.

Pandora install 2.png

This screen is intended to verify that all software dependencies have been properly installed.

Note: If you are required to install some dependencies, restart the web server in order for it to recognize them.

Pandora install 3.png

At this point, it configures the access data to your MySQL server. You are required to enter the root password that you have created in the previous step (which was 'pandora 1234' in the example).

Note: Please avoid blank spaces in the database name.

Pandora install 4.png

Enter the password for database access here:

Paso5new.png

Installation complete:

Paso6.png


2.2.1 License Application

The Pandora FMS Enterprise version bears a different license key associated to each installation. To use the Enterprise Features and the console's remote updates, enter the license code provided by Ártica in the console configuration section.

For more information about how to activate the license, go to

license activation.

2.3 Server initial and basic configuration

Pandora FMS has configured your database and created a MySQL user to obtain access to it. It has created a random password for the 'pandora' user that should be the one used to modify the defined password in the Pandora FMS Server.

For this last step, edit the file named '/etc/pandora/pandora_server.conf' from your Pandora FMS installation and look for the following line:

dbpass pandora

Then replace 'pandora' for the password created by the wizard. Once this is done and the file is saved, you will able to start the Pandora FMS server by entering the following command:

/etc/init.d/pandora_server start

The server should return start values like the ones below.

Pandora FMS Server X.Y Build XXXX Copyright (c) 2004-2009 ArticaST
This program is OpenSource, licensed under the terms of GPL License version 2.
You can download latest versions and documentation at http://www.pandorafms.org 
 [*] Backgrounding Pandora FMS Server process.
 Pandora FMS Server is now running with PID 2085.

Info.png

The tentacle_server is configured to start along with the system boot. If you intend to work with the Pandora FMS Server without rebooting the machine, it is recommended to manually restart this service.

 


To boot the tentacle_server manually, type in the command:

/etc/init.d/tentacle_serverd start

3 Pandora FMS Agent Installation

3.1 Agent Requirements

The agent can run on any computer with the minimum required operating system, either of the following:

Component Operating System
Pandora Agent 4.0 or above
  • RedHat Enterprise (RHEL) 6.x
  • CentOS 6.x
  • SLES 11 SP1 or above
  • OpenSUSE 11.x or above
  • Debian 5.x or above.
  • Ubuntu 11 or above.
  • HPUX B.11.11 or above, with Perl 5.8.
  • AIX 4.3.3 or above, with Perl 5.8.
  • BSD Systems (NetBSD, OpenBSD, FreeBSD), with Perl 5.8.
  • MacOSX 10.6 or higher.
  • Solaris 8 or above, with Perl 5.8.
  • Windows NT4 (see special notes for this section).
  • Windows XP
  • Windows 2000
  • Windows 2003
  • Windows 2008
  • Windows 7
  • Windows 8
  • Windows 2012
Pandora Android Agent 2.0 or above
  • Android 2.2 or above
Pandora Embedded Agent 4.0 or above
  • Embedded devices, requires compiling



Info.png

There is a special agent for Windows NT, which is basically the Unix agent compiled for Windows, although performance is much lower than that of a native Windows agent and native API access features are not present.

 


In UNIX environments, the following must also be installed:

  • Perl 5.8 or above
  • Optionally the package unzip installed correctly and accessible in the path of the user that will run the agent (only if you want to use the file collections).
  • It will be necessary to install the following dependency:
perl-YAML-Tiny-1.73-2

3.2 Installing the agent from tarball

This agent version is ready for installation on any Unix/Linux/MAC OS system.

The agent does not require compilation nor preparation, once the agent is downloaded in. tar. gz format.

1. Acquire root privilges

su -

2. Copy it to /tmp and insidee /tmp execute:

tar xvzf pandorafms_X.Y_unix.tar.gz 
cd unix
./pandora_agent_installer --install

3. Start the agent manually:

/etc/init.d/pandora_agent_daemon start

3.2.1 Custom installation

The agent can be installed in a directory defined by the user in an "integral" way, this means that all the files of the agent will be put in that directory: logs, configuration files, binaries, man pages, etc.

To use that method, simply run it as the following example:

./pandora_agent_installer --install /opt/pandora

The only file that Pandora FMS will create outside this user-defined directory is the agent launcher in /etc/init. d/pandora_agent_daemon (or equivalent in other Unix systems), and the link in the directory of the system's boot level, for example /etc/rc. d/rc2. d/S90pandora_agent_daemon.

Moreover, the installation can be configured so that instead of running the agent with root user, it can run with another user. For example, for the agent to run with the Pandora FMS user, it would be:

./pandora_agent_installer --install /home/pandora pandora

When a custom user is specified, the agent must be installed in a custom location where the user has writing permissions (/home/pandora in the previous example).



Template warning.png

The user pandora is deactivated by default, you must enable it by entering a valid shell in /etc/passwd if you want to use it to run the agent with that user.

 


Template warning.png

For users with MAC OS X 10.11 or higher (The Captain or newer): Apple has added a new security layer on OS X. Some root privileges have disappeared. When installing the Pandora FMS Agent, it will appear as a restricted process. Only restricted processes that are signed by Apple can modify these files. However, you can disable this security system by booting into recovery mode and deactivating it on a terminal by doing: csrutil disable.

 


3.2.2 Agent installation in CentOS/RedHat

To install the software agent in CentOS/RedHat you should have downloaded the CentOS/Rehdat RPM package from our website.

To install it, simply run this command:

rpm -i pandorafms_agent-7.0NG-1.noarch.rpm

In case you have activated the CentOS repository, you can install the agent like this:

yum install pandorafms_agent

If using CentOS 8, it will be necessary to install the PowerTools repository. In can be installed with the following command:

yum install ./pandorafms_agent.noarch.rpm --enablerepo=PowerTools

3.2.3 Agent installation in Ubuntu/Debian

To install the software agent in Debian you should have downloaded from our website a deb package with this or similar name.

pandorafms_agent_unix-7.0NG-1.noarch.deb

To install it, simply run this command:

dpkg -i pandorafms_agent_unix-7.0NG-1.noarch.deb

If you have the Debian repository turned on, you can install the agent like this:

apt-get install pandorafms_agent_unix

3.2.4 Agent installation in SUSE

To install the software agent on SUSE you should have downloaded a similar RPM package from our website (maybe some version number or other details may change), but it should look like this one:

pandorafms_agent_unix-7.0NG-1.noarch.rpm

To install it, simply run this command:

rpm -i pandorafms_agent_unix-7.0NG-1.noarch.rpm

If you have the SUSE repository enabled, you can install the agent like this:

zypper install pandorafms_agent_unix

3.2.5 Agent installation in NetBSD and FreeBSD

Pandora FMS agent file does not exist for FreeBSD and NetBSD. You must install the Pandora FMS agent using the installer.

To install using the installer, read the following section carefully: "Manual installation from sources on Linux/Unix".

The file location and startup script structure are different from Linux.

The particulars of FreeBSD will be discussed later on.

After installation, add the following line to /etc/rc. conf.

pandora_agent_enable="YES"

To enable the Pandora FMS agent, these settings are needed, otherwise the process cannot be started.

In FreeBSD, most Pandora FMS agent files are installed in /usr/local.

Agent:

/usr/local/bin/pandora_agent

Boot Script :

/usr/local/etc/rc.d/pandora_agent

Configuration file:

/usr/local/etc/pandora/pandora_agent.conf

Plugins:

/usr/local/share/pandora_agent/plugins/*

Man pages:

/usr/local/man/man1/*

Other:

The data_in and log directories are the same as those of Linux.

3.2.6 Agent installation in Windows

The agent is delivered as an installer in executable format (. exe). The basic installation performs all the necessary steps and it is only necessary to accept all the options.

To install the Pandora FMS agent in Windows, you only need to download and run it. The installer will guide you through the necessary steps in the language you select. The following example shows the installation for Windows XP, remember that Pandora FMS works on any modern Microsoft platform (2000 or higher). It also has 32 and 64 bit versions.




Select language:

Pandora agent 3.0 RC3 install windows 01.png

Follow the steps:

Pandora agent 3.0 RC3 install windows 021.png

Acept Terms and Conditions and click on Next:

Pandora agent 3.0 RC3 install windows 031.png

Select the path where the Pandora FMS agent will be installed (by default it is installed in c: /program files/pandora_agent), but you can change it by clicking on Browse..., and then clicking on Next:

Pandora agent 3.0 RC3 install windows 041.png

Wait for the files to be copied.

Pandora agent 3.0 RC3 install windows 061.png

Configure the data for the agent as the IP address (or name) of the Pandora FMS server that will receive the agent data. In order to be able to change other parameters, such as the agent name (by default it takes the hostname value of the machine) or the path of the temporary files, you will have to manually edit the agent configuration.


Pandora agent 3.0 RC3 install windows 071.png

Pandora agent 3.0 RC3 install windows 072.png

Decide whether you want to start Pandora FMS agent service at the moment, otherwise you will have to do it manually, or it will start when Windows restarts again.

Pandora agent 3.0 RC3 install windows 081.png

The installation is finished. You can change the agent parameters in the file pandora_agent. conf or through the direct link in the PandoraFMS menu.

3.2.6.1 Unattended Windows Agent Installation

Starting with the agent's VERSION 5.1, the installer supports unattended mode. To perform the installation, simply run the following:

"Pandora FMS Windows Agent v7.0NG.VERSION-BUILD_ARCH.exe" /S

In case you want to install the agent in a different path than the default one:

"Pandora FMS Windows Agent v7.0NG.VERSION-BUILD_ARCH.exe" /S /D=C:\Agent_Pandora

You can also pass certain parameters so that they are written in the configuration file of the agent to be created. Thanks to these options, the deployment of Pandora FMS agents is much more customizable. The options per command line that are supported are the following:

  • --ip: Corresponds to the token server_ip.
  • --group: Corresponds to the tokengroup.
  • --alias: Corresponds to the tokenagent_alias.

For example, if you want to create an agent that belongs to the groupApplications, with the name Mifunne and that points to the server with the IP 192.168.0.59, the command would be:

"Pandora FMS Windows Agent v7.0NG.VERSION-BUILD_ARCH.exe" /S  --ip 192.168.0.59 --group Applications --alias Mifunne

3.2.6.2 Unattended Uninstallation

The uninstaller that is an executable named uninstall. exe in the Pandora FMS installation directory also enables the unattended uninstaller, to do it, run the uninstaller with the option /S .

For example, assuming that Pandora FMS is installed in the default path:

c:\program files\pandora_agent

You should execute:

“c:\program files\pandora_agent\uninst.exe” /S

3.2.6.3 Using PandoraAgent.exe from the command line

If you run pandoraagent.exe --help, it will show you something similar to this:

Pandora agent for Windows. Version 3.0(Build 091125)
Usage: PandoraAgent.exe [OPTION]

Available options are:
        --install:  Install the Pandora Agent service.
        --uninstall: Uninstall the Pandora Agent service.
        --test-ssh: Test the SSH Pandora Agent configuration.
        --test-ftp: Test the FTP Pandora Agent configuration.
        --process: Run the Pandora Agent as a user process instead of a service.


To install the service (if it is not installed), simply run the following inside the directory where the executable is located (usually c:/program files or equivalent).

pandoraagent.exe --install

This will prompt the service on the machine, based on the path where the. exe is located.

If you want to uninstall it, the process is the same but using:

pandoraagent.exe --uninstall

If you want to test an ftp or ssh connection from the command line, you can use the previous options.

3.2.6.4 Pandora FMS Windows Agent as a process

It possible, for debugging, testing and other unusual circumstances, execute the agent in "Process"mode. This is done by running it from the command line:

pandoraagent.exe --process

There are some limitations in the execution of the process mode, since Pandora FMS is meant to run as a service and under the user SYSTEM. If you run it with another user without privileges, there will be functionalities that will not work properly.

Go back to Pandora FMS documentation index