Pandora: Documentation en: Installing
Go back to Pandora FMS documentation index
Contents
- 1 Console and Pandora FMS Server Installation
- 1.1 Minimum hardware requirements
- 1.2 Minimum software requirements
- 1.3 Database requisites
- 1.4 Satellite Server Requirements
- 1.5 Port requirements
- 1.6 Package Dependencies
- 1.7 Issues prior to Installation
- 1.8 Installation using ISO or "Software appliance"
- 1.9 Installation under Docker
- 1.10 Installing the VMWare Virtual Machine
- 1.11 Installation under SUSE (OpenSUSE or SLES)
- 1.12 Installation in Red Hat Enterprise Linux / Fedora / CentOS
- 1.13 Installation under Debian and Ubuntu
- 1.14 Installation in FreeBSD
- 1.15 Installation in NetBSD
- 1.16 Manual Installation from Sources under Linux / UNIX / MAC OS
- 1.17 Installing the Enterprise Version
- 1.18 Server and Console Installation in Windows
- 2 Initial Configuration after Installation
- 3 Pandora FMS Agent Installation
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 above recommendations, we recommend installing MySQL on a standalone server and installing Percona XTraDB instead of standard MySQL.
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. |
|
We strongly recommend the use of SSD disks, due to the high impact they have on performance improvement. |
|
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. |
|
1.2 Minimum software requirements
Software | Requirements | ||
---|---|---|---|
Operating System |
|
||
|
Pandora FMS does not give official support in these platforms | ||
Permissions |
- 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. -Windows: Pandora FMS Server service must be executed as administrator permissions.
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/.
-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.. -Windows: Pandora FMS Server Software Agent must be executed as administrator permissions. |
||
Console |
|
||
Browsers |
|
||
Firefox and Chrome are recommended to make use of interactive graphs and network maps. |
There are Pandora FMS server functionalities that are not supported for Windows. To learn more about these functionalities visit the following link.
1.3 Database requisites
BBDD | Detalles |
---|---|
MySQL Standard |
|
Percona XTraDB |
Percona XTraDB installation is recommended for large Pandora FMS environments where more than 4000 agents will be created.
|
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. |
|
1.4 Satellite Server Requirements
Satellite | Details |
---|---|
Hardware |
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. For environments with less than 1000 agents, we recommend a minimum of 1 core at 2GHz and 1 GB of RAM. |
Dependencies |
The main dependencies are:
|
Binaries |
The main dependencies are:
|
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 functionality | 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 | Traps reception | Trap generator device -> Pandora FMS Server |
443 | TCP | Pandora FMS Console (API Communication) | Use of API/CLI functionality | 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 | Conection 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 | Agente Software Agent Server -> Pandora FMS Server |
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: | ||||
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 | Monitorización web para servidor WUX | Pandora FMS Server -> Server to monitor |
ICMP | ICMP | Consola y 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, aren't 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 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:
1. Please start the MySQL Server daemon:
/etc/init.d/mysql start
2. Configure the root password for the MySQL root user:
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.
1.7.2 Pandora FMS Installation Order
You're required to follow this sequence in order to install Pandora FMS properly:
- Install console
- 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 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.
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.
1.7.3 Installing the Enterprise Version
The proper 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 on the server.
We can find details on how to correctly enter the license 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"
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 Appliance CD Installation.
1.9 Installation under Docker
1.9.1 Get the latest stable version
To get the latest stable version:
curl -sSL http://pandorafms.org/getpandora | sh
1.9.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
1.10 Installing the VMWare Virtual Machine
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.
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.
The credentials for this machine are the following:
User: root
Password: pandora
Console User: admin
Password: pandora
MySQL user: root
Password: pandora
1.11 Installation under SUSE (OpenSUSE or SLES)
1.11.1 Automatized Installation by the Official Repository
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).
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
For versions of Pandora FMS 729 or higher, it will be necessary to update to PHP7 so the console works |
|
1.11.2 Manual RPM Installation
1.11.2.1 Previous Dependencies Installation
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.
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
Unlike SLES, OpenSUSE doesn't have a 'mysql-max' package. You may install the MySQL standard package instead without experiencing any problems. |
|
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 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... 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'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: 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
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 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 dependencies directory for OpenSUSE.
Please put them in a directory to install them, e.g.: '/tmp/extra' and execute the following command:
rpm -i *.rpm
1.11.2.2 Server Installation
Just execute:
rpm -i pandorafms_server-5.1SP2-1.noarch.rpm
1.11.2.3 Console Installation
Please 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.11.3 Uninstalling Pandora FMS
You're able to uninstall any of Pandora FMS components by using the following commands:
rpm -e pandorafms_agent rpm -e pandorafms_console rpm -e pandorafms_server
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.
1.12 Installation in Red Hat Enterprise Linux / Fedora / CentOS
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.
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.
Edit /etc/yum.repos.d/CentOS-Base.repo and enable EXTRAS, and UPDATES repos. Usually should be something like 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.12.1 Installation using the Pandora FMS Repository
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.
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 you will need a MySQL server if you don't 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.
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). |
|
1.12.2 Manual Installation by 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
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:
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') aren't contained in the official RHEL repositories. We're providing them on our Sourceforge download page in the "Tools and Dependecies" section [1].
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:
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
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. |
|
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 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 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 FAQ procedures in such a case.
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 |
|
To do so, we recommend using 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.12.3 Uninstalling Pandora in CentOS/RHEL
Just execute the order
yum remove pandorafms_console pandorafms_server
If you have installed MySQL and no longer need it, you can also delete it with the same command:
yum remove mysql-server
1.13 Installation under Debian and Ubuntu
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).
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
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 you need to 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.13.1 Installation with Artica Private Repository
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.
In order to do so, please 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
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.13.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
If the 'wmi-client' package is not available in the repositories, you're required to download it from the Pandora FMS Sourceforge website. |
|
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. |
|
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
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, 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:
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.
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. |
|
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.
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, you're required to continue with the installation of all Pandora FMS components.
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 |
|
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:
http://10.20.34.54/pandora_console
1.13.3 Uninstalling Pandora FMS
dpkg -r pandorafms-console-enterprise dpkg -r pandorafms-console
1.14 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.14.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, you're required to implement all the dependencies before doing so. It's 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, you will have to implement all of the previously mentioned dependencies. You may use the packages to do so.
From version 729 of Pandora FMS it is necessary to update to PHP7 for the proper functioning of the tool |
|
1.14.2 Console Installation
There are no Pandora FMS Console package files for FreeBSD. The Pandora 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.14.3 Server Installation
There are no Pandora FMS Server package files for FreeBSD. You're required to install the Pandora 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. We're going to show the FreeBSD-specific procedures 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, the Pandora Servers and Tentacle. Otherwise, they are not going to be launched.
On FreeBSD, most of the Pandora server's files are gong 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.15 Installation in NetBSD
From versions 5.0 and above, Pandora FMS supports the use of NetBSD.
1.15.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, you are required to 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
Subsequently, you're required to 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're unable to compile it without some errors showing up, please 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 the Pandora FMS Console, you're required to implement all of the dependencies before doing so. You may use 'pkgsrc' for that.
From version 729 of Pandora FMS it is necessary to update to PHP7 for the proper functioning of the tool |
|
In addition, you're required to install the 'XML_RPC' using the 'pear' command as shown below.
pear install XML_RPC
1.15.2 Console Installation
There are no Pandora FMS Console package files for NetBSD. You're required to install the pandora console by using the installer.
How to install it by 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.15.3 Server Installation
There are no Pandora FMS Server package files for NetBSD. Install the Pandora 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 the one under Linux. We're going to show the NetBSD specific procedures below.
After the installation, you're required to add the following lines to the '/etc/rc.conf':
pandora_server="YES" tentacle_server="YES"
To enable the Pandora Servers, Pandora and Tentacle, these settings are required. Otherwise, they are not going to 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.16 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 it. To do this, locate the latest version of Pandora FMS and download the files from here: https://sourceforge.net/projects/pandora/files/.
1.16.1 Console Installation
Once you've opened the console zip file, please 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.16.2 Server Installation
Once you've opened the server zip file named 'pandorafms_server-3.0.0.tar.gz' or similar, please follow the below mentioned steps:
1. We acquire root privileges:
su -
2. We copy it to '/tmp' and execute:
tar xvzf pandorafms_server-X.Y.tar.gz 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.
1.16.3 Server Manual Installation (from source code)
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.
To do this, unzip your server code to /tmp, as described in the previous step.
1. We acquire root privileges:
su -
2. We copy it to '/tmp' and in there, we 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 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.
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're copied to:
/usr/lib/perl5/site_perl/5.10.0/PandoraFMS/
1.17 Installing the Enterprise Version
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.
1.17.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'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:
1. We acquire root privileges by entering:
su -
2. Copy it to '/tmp' and in there execute:
tar xvzf pandorafms_console-X.Xtar.gz
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).
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's user, e.g.:
Debian:
chown -R www-data /var/www/pandora_console/enterprise
SUSE:
chown -R wwwrun /srv/www/htdocs/pandora_console/enterprise
It's recommended to conduct the License Activation at this point.
1.17.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, please follow the below mentioned steps:
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 isn't contained in the default directory '/usr/bin', you'll have to indicate the directory as follows:
# PREFIX=/usr/local ./pandora_server_installer --install
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.
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. |
|
1.17.2.1 Installing to a different path
To install the Pandora FMS Server to a different path, specify it with the --destdir option:
./pandora_server_installer --install --destdir <path>
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):
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.17.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.17.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.18 Server and Console Installation in Windows
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 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 . |
|
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:
- Recon scripts
- IPAM
- UX monitoring
- Transactional monitoring
- Netflow
- Server plug-ins. The default plug-ins are Linux scripts. You could, however, write your own scripts for Windows.
- VMware plug-in
- Remote inventory
- Log monitoring
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.
Please select the language:
Please follow the installer steps:
Please accept the license terms:
Please select the components to install:
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. |
|
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 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.
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.
After selecting the components to install, you're required to specify the installation path:
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:
As denoted above, other components are installed besides MySQL and Nginx. In case they are already installed, you may see a message like this:
Please remember that Microsoft Visual C++ is required for the modules to work properly.
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.
Until the installation is complete as shown below.
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.
In order to quickly start the process, please click on 'Start' and 'Programs'.
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.
1.18.1 Operation WMI modules 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:
Right click on the service and enter in Properties
On the Log On window, select an account with Administrator permissions and apply changes:
And after these changes, restart the service.
1.18.2 Folders 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
- Server logs directory
- Graphviz binary directory
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. |
|
Microsoft Visual C++ 2008
http://www.microsoft.com/es-es/download/details.aspx?id=29
2 Initial Configuration after 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.
2.1 Tuning the settings in CentOS7
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:
CentOS 7 doesn't install ifconfig, to install it :
yum install net-tools
CentOS has a very aggressive firewall, and we 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
We program both the WEB server and the database server for booting:
systemctl start httpd.service systemctl enable httpd.service systemctl enable mariadb.service
We remove the private tmp fromt 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
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).
/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 our Pandora FMS server and complete the database creation process.
If your server's IP is, for exmaple, '192.168.5.54', please put the following line into the address bar of your browser:
http://192.168.5.54/pandora_console/install.php
From now on, you're just required to follow the following steps in order to create the Pandora FMS DB.
Please click on 'Next'.
This screen is intended to verify that all software dependencies have been properly installed.
Note: If you're required to install some dependencies, restart the web server in order for it to recognize them.
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).
Note: Please avoid blank spaces in the database name.
Enter the password for database access here:
Installation complete:
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 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:
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:
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. |
|
2.3 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.
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:
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:
/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.
The Pandora Server is now running with PID 2085.
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. |
|
To boot the tentacle_server manually, you will need to type 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 |
|
Pandora Android Agent 2.0 or above |
|
Pandora Embedded Agent 4.0 or above |
|
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).
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 or preparation, once we have the agent 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 aagent 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 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).
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. |
|
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
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 agents 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.
We will study the peculiarities of FreeBSD later on.
After installation, you should add the following line to /etc/rc. conf.
pandora_agent_enable="YES"
To enable the pandora agent, these settings are needed, otherwise the process cannot be started.
In FreeBSD, most pandora 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 in 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. 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.
Select language:
Follow the steps:
Acept Terms and Conditions and 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..., then click on Next:
Wait for the files to be copied.
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.
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.
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 we 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
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.
- --group: Se corresponde con group.
- --alias: Se corresponde con 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:
"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
that is in the Pandora FMS installation directory also allows the unattended uninstaller, to do this you must run the uninstaller with the option /S
.
For example, assuming that Pandora FMS is installed in the default path:
c:\program files\pandora_agent
We should execute:
“c:\program files\pandora_agent\uninst.exe” /S
3.2.6.3 Using PandoraAgent.exe from the command line
If we run pandoraagent.exe --help, it will show us 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 we want to uninstall it, it's the same process but using:
pandoraagent.exe --uninstall
If you want to test an ftp or ssh connection from the command line you can use the options above.
3.2.6.4 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:
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.