Online Installation tool

If you have access to the Internet it is recommended to make use of this tool for online installation.

Pandora FMS Monolith Environment (server/console/database)

This installation method is particularly useful when the environment is hosted by cloud providers, although it is not exclusive to these types of environments.

The term "Cloud provider" (or just "Cloud") is used to describe virtual machine hosting, either exclusively or shared, in specialized providers with hardware, hypervisors and customer support web systems for configuration and administration.

For any of them you can install Pandora FMS Community version. Red Hat (RHEL) 8.x is recommended as operating system although it also officially supports Rocky Linux 8.x, AlmaLinux 8.x and Ubuntu server 22.04.

The minimum hardware requirements for this installation are: 1 core, 2 gigabytes of RAM and 20 gigabytes of free disk space, preferably Solid State Drive (SSD).

These requirements are the minimum installation requirements, to properly size the monitoring environment we recommend going to the minimum hardware requirements section.

Requirements for the Use of the Online Installation Tool

To use the online installation tool, just access the command line of your Cloud provider, and by means of the root user, run:

In you use RHEL 8.x and Rocky Linux 8.x:

curl -sSL https://pfms.me/deploy-pandora-el8 | bash

In you use Ubuntu server 22.04:

curl -SsL https://pfms.me/deploy-pandora-ubuntu | bash

There is a similar online installation tool for Pandora FMS Enterprise version that you may request if you are a user of this version through the support portal or through this link get a free trial (demo). In addition, for Satellite server installation, there is an online installation tool too.

By means of this execution, the whole stack necessary for Pandora FMS will be installed, rendering an instance fully funtional to start monitoring.

image.png

You may get more information in our video tutorial «Cloud installers (agents, server)».

Custom installation using the online installation tool

Although the previous execution performs a full environment installation, it is possible to define different modifications through the environment variables to customize the installation.

These modifiers are:

for the use of this environment variables, just define them before running the installation script, for example, in a RHEL 8 installation with defined variables run the block:

env TZ='Europe/Madrid' \
 DBHOST='127.0.0.1' \
 DBNAME='pandora' \
 DBUSER='pandora' \
 DBPASS='pandora' \
 DBPORT='3306' \
 DBROOTPASS='pandora' \
 MYVER=57 \
 PHPVER=7 \
 SKIP_PRECHECK=0 \
 SKIP_DATABASE_INSTALL=0 \
 SKIP_KERNEL_OPTIMIZATIONS=0 \
 PANDORA_SERVER_PACKAGE="https://firefly.pandorafms.com/pandorafms/latest/RHEL_CentOS/pandorafms_server-7.0NG.noarch.rpm" \
 PANDORA_CONSOLE_PACKAGE="https://firefly.pandorafms.com/pandorafms/latest/RHEL_CentOS/pandorafms_console-7.0NG.noarch.rpm" \
 PANDORA_AGENT_PACKAGE="https://firefly.pandorafms.com/pandorafms/latest/RHEL_CentOS/pandorafms_agent_linux-7.0NG.noarch.rpm" \
 PANDORA_BETA=0 \
 sh -c "$(curl -fsSL https://pfms.me/deploy-pandora-el8)"


First Steps

Once installed, the system should boot up and, after a few seconds, display the terminal to log in. The first step should be to know the IP address that the system has assigned, to be able to connect to the server from outside. To do this, type the following command in the terminal:

ifconfig

You may also use the command ip address show .

f_step_2.png

In the case of this screenshot, the IP address of the system is 192.168.70.158.

Once you know Pandora FMS system IP address, you may access it from outside the virtual machine, which is always the most convenient. It can be done via SSH or HTTP. Use the root password (superuser) that you established in the installation configuration (DBROOTPASS).

Open a web browser (Google Chrome® and Mozilla Firefox® are recommended) and type in the following address in the address bar, consisting of the IP address (x.x.x.x.x) you obtained from the server:

http://x.x.x.x/pandora_console

In the previous example, it would be

http://192.168.70.158/pandora_console

If everything is correct, access the welcome screen of Pandora FMS Console, similar to this one:

pandora_login.png

Use the default credentials: user admin and password pandora/Pandor4! .

Once here, you have a full Pandora FMS installation ready to be used.

Enterprise License Activation

This section is only for Enterprise version users. If you wish to request a demoplease contact us.

If you have a Metaconsole license, you may skip this step, since this type of license automatically activates each associated node.

It is important not to start the daemon pandora_server with the Enterprise version installed if the Console Enterprise version has not been previously activated, as that may be the cause for errors.

You may also get more information in the video tutorial "How to renew Pandora FMS License" or "offline". Once you have accessed Pandora FMS through the browser, you will be asked to enter a valid license. Click on Request new license and proceed to the next step. In this step you should fill in the contact information and the Auth key that the commercial department sent you.

Proceed to the next step by clicking on Online validation:

pfms_activate_license.png

Once finished, a license will be ready to be validated.

Finish all steps, the console is ready for use.

Starting the Enterprise Server

This section is for Enterprise version users only. If you wish to evaluate a demo, please contact us.

After activating the license, the Enterprise server must be started. You may connect to Pandora FMS server through a command terminal (local or remote) or through the QuickShell feature if you access the Agent that monitors the server itself.

sudo /etc/init.d/pandora_server start

From version NG 754 onwards, you have additional options for manual start and stop of High Availability Environments (HA).

To verify its correct operation, access Pandora FMS through the browser, go to the left side menu, click on Management → Servers → Manage servers. You should see something like the following:

servers-manage_servers_pandora_fms_servers.png