first steps (iso/centos)

61
2022/05/27 21:37 1/61 First Steps (ISO/Centos) Pandora FMS Documentation - https://pandorafms.com/manual/ First Steps (ISO/Centos) Go back to Quick Guides index Introduction The purpose of this guide is to quickly introduce Pandora FMS to someone unfamiliar with Pandora FMS, but who has medium to high knowledge of systems and networks. The purpose is not delving into all Pandora FMS features, but rather discussing the most important ones. That way, a user that reads the complete Quick Guide should be able to perform basic administration and operation tasks quickly. Considering that Pandora FMS official training takes 40 hours, and the official documentation has more than 1200 pages, this is meant to be just a small bridge to a larger documentation package for Pandora FMS, so that the first contact is not too complicated. Since the release of version 7 NG in 2017 the operating system used in the ISO image is CentOS 7. However at present due to the very good speed on the Internet (100 mbps or more) it is recommended to make an online installation (cloud) and, once completed, go to the monitoring starting point. Installation We recommend using the Pandora FMS Appliance CD because it is the quickest and easiest method for intermediate users. For further information about For more information on Metaconsole installation methods, please refer to the following chapter: Pandora FMS Installation chapter . The installation CD is based on GNU/Linux CentOS 7, and contains all the required elements and dependencies to make Pandora FMS work. You should have a machine with the minimum hardware

Upload: others

Post on 28-May-2022

1 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: First Steps (ISO/Centos)

2022/05/27 21:37 1/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

First Steps (ISO/Centos)

Go back to Quick Guides index

Introduction

The purpose of this guide is to quickly introduce Pandora FMS to someone unfamiliar with PandoraFMS, but who has medium to high knowledge of systems and networks. The purpose is not delvinginto all Pandora FMS features, but rather discussing the most important ones. That way, a userthat reads the complete Quick Guide should be able to perform basic administration and operationtasks quickly.

Considering that Pandora FMS official training takes 40 hours, and the official documentation hasmore than 1200 pages, this is meant to be just a small bridge to a larger documentation package forPandora FMS, so that the first contact is not too complicated.

Since the release of version 7 NG in 2017 the operatingsystem used in the ISO image is CentOS 7. However atpresent due to the very good speed on the Internet (100mbps or more) it is recommended to make an onlineinstallation (cloud) and, once completed, go to themonitoring starting point.

Installation

We recommend using the Pandora FMS Appliance CD because it is the quickest and easiest methodfor intermediate users. For further information about For more information on Metaconsole installationmethods, please refer to the following chapter: Pandora FMS Installation chapter .

The installation CD is based on GNU/Linux CentOS 7, and contains all the required elements anddependencies to make Pandora FMS work. You should have a machine with the minimum hardware

Page 2: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

requirements to make Pandora FMS run properly, including a minimum of 4 GB of RAM and 20 GB ofdisk-space (storing data).

The more systems you want to monitor, the more resources(CPU, memory, disk speed) you will have to assign to thePandora FMS server.

Installing the Appliance CD

Download the CD image (32-bit or 64-bit) from the download section of our website and burn the ISOimage onto a DVD, or run the system from that file if you are using a virtualized system (XenServer,VMware®, Oracle VirtualBox®, Microsoft Hyper-V®, etc).

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

The graphic installer will lead you step by step throughout the whole installation process. This installeris a standard installation process used by CentOS, and it is available in different languages.

Page 3: First Steps (ISO/Centos)

2022/05/27 21:37 3/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

It is a very easy process but special attention must be paid when:

Entering the superuser password (root).When asked about the hard drive partitioning:

Page 4: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Select and configure all the necessary options to install, Date & Time, Keyboard and InstallationDestination.

Remember to activate the network interface, or else it will need to activated manually afterinstallation.

Page 5: First Steps (ISO/Centos)

2022/05/27 21:37 5/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Activate the network interface and optionally change the hostname

Page 6: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

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

Page 7: First Steps (ISO/Centos)

2022/05/27 21:37 7/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Select the disk where the installation will be performed and click on Done.

Page 8: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Select the partitioning, unless you have advanced knowledge use the option 'Click here to createthem automatically'. Click Done.

Page 9: First Steps (ISO/Centos)

2022/05/27 21:37 9/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Verify the created partitions and click on Done.

Page 10: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Accept Changes.

Click on Begin installation.

Page 11: First Steps (ISO/Centos)

2022/05/27 21:37 11/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Here you can assign the root password and optionally create a user.

Page 12: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

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

After removing the ISO image of the machine's startup so that the installer does not appear again, therecently installed CentOS system will be started and you will be able to use Pandora FMS with all thenecessary dependencies for its correct operation.

First steps

Once installed, the system should boot, and after a few seconds, it will show a Terminal where to login:

The first step would be getting the system IP address to be able to connect to the server from outside.To retrieve it, execute the command:

Page 13: First Steps (ISO/Centos)

2022/05/27 21:37 13/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

ifconfig

You can also use the command ip address show

Here is an example. In this particular case, the system's IP address is 192.168.70.158

If the system has booted and taken an IP from our network via DHCP it will be shown on the list. If youwish to set a static IP for this system, do it by using the nmtui command, which shows a graphicinterface to do so.

Page 14: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Once you know the IP address of the Pandora FMS system, you can access it from outside the virtualmachine, which is always more convenient. You can do it via SSH or HTTP. Remember that youalready set the root password (superuser) during the configuration in the installation process.

Open a browser and enter the IP address that you got from your server:

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

In the previous example it would be

http://192.168.70.158/pandora_console

but you must retrieve your system's IP correctly to be able to continue. If everything is correct, youwill see the Pandora FMS console welcome screen, which looks similar to this one:

Page 15: First Steps (ISO/Centos)

2022/05/27 21:37 15/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Use the default credentials: user admin and passwordpandora

Once you reach this point, you have a complete installation of Pandora FMS ready to start using it.

Enterprise license activation

This section is for Enterprise users only. If you would like toevaluate a demo, please contact us.

This process is not necessary if we have a Metaconsole license as this type of license automaticallyactivates each associated node.

It is very important to not boot the pandora_serverdaemon with the Enterprise version installed, without nothaving enable the console Enterprise version, since there willbe failures.

More information can be found in the video tutorial «How to renew Pandora FMS License». Once youaccess your Pandora FMS through the browser, you will be asked to enter a valid license:

Page 16: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Click on Request new license and proceed to the next step. In this step you need to fill out thecontact information and the Auth key that the sales department has forwarded, if it is an Enterpriseversion.

Proceed to the next step by clicking on Online validation

Once done, the license will pop out to validate it.

Once you are done with all the steps, your console is ready to use.

Page 17: First Steps (ISO/Centos)

2022/05/27 21:37 17/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Enterprise server start

This section is for Enterprise users only. If you would like toevaluate a demo, please contact us.

After activating your license, the Enterprise server should start. You can connect to the Pandora FMSserver through a command terminal (local or remote) or through the QuickShell functionality if youaccess the Agent that monitors the server itself.

sudo /etc/init.d/pandora_server start

From version NG 754 onwards, additional options areavailable for manual startup and shutdown of HighAvailability (HA) environments.

To verify that everything works, access your Pandora FMS through the browser and go to Servers →Manage servers. You should see something like this:

Page 18: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Detecting systems in your network

To start using Pandora FMS, detect and monitor the devices that are on your local network. It does notmatter whether they are PCs with Windows, Macintosh, Linux servers or routers/switches because thisis just a very basic monitoring task (checking if they answer to a ping). Once they are detected, youmay improve the monitoring.

Create a Recon Task

Follow the next steps. From the side menu, go to Discovery > Discovery as shown in the image below,and click on “Host&Devices” and “NetScan”.

Create the task as follows: modify the network range that is to be explored. In this screenshot therange is 192.168.70.0/24 which means that all the hosts in the 192.168.70.xx network will beexplored. Use the appropriate IP address range here to define your network. Selecting the group

Page 19: First Steps (ISO/Centos)

2022/05/27 21:37 19/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

“Applications”, which is used to cointain de discovered devices. From now on, the services managedor monitored by Pandora FMS are called “agents”.

The network template “Basic monitoring” has been selected, which only covers latency and networkavailability checks. You may select other type of checks such as SNMP or WMI, to be carrioed outduring the recon task.

Page 20: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Once created, it will show the entry, and click on the magnifying glass icon to see the task details, asshown in the screenshot below:

Page 21: First Steps (ISO/Centos)

2022/05/27 21:37 21/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

By clicking on the magnifying glass icon, you will be shown the current task status, which in this caseis completed. In this screenshot you can see the progress bar is not there, and the system has alreadyfound the network devices to add to the monitoring.

Reviewing detected systems

At this point, we recommend you to wait until the network has been fully detected. When finished,

access the agent detail view to see all detected systems. Menu Click on the Refresh tab . Whenyou're finished, go to Agent Detail view to see all the detected systems. Menu Monitoring > Views >Agent detail, as seen in the image:

Page 22: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Here you may see several systems that have been properly detected by Pandora FMS. Sometimes thename of the system will have been discovered (if possible by DNS), and in other cases the OS willhave been detected. When clicking on the system name (in this case the first one appearing on thescreenshot), you will be forwarded to the Agent Detail view which displays all of the informationgathered about that system.

Page 23: First Steps (ISO/Centos)

2022/05/27 21:37 23/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Add remote check to an already monitored system

Now that the systems are detected, add some monitoring modules. These are the monitoringparameters to be added:

Network traffic on an interface.Network packet loss.Check whether a service answers on the network through a TCP port.

Interface network traffic

To monitor network traffic, SNMP must be configured on the remote device. This usually needs to beactivated and (minimally) configured to allow you to check data. The SNMP device allows you toconfigure which IP can make queries, and with which community. This ends up working as anadditional security measure.

First of all, locate the agent from which you want to obtain the network traffic, in this case it is192.168.70.1. Following the same process (Monitoring → Views → Agent detail) go to the MainView of the agent you want to configure and click on the last tab on the right, which will take you tothe edit view for that agent.

Page 24: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Now go to the Agent edit main view section. Below you may see this agent's Wizard configurationsubmenu. Choose the SNMP Interface wizard:

At this point, provide the SNMP community that you configured on the equipment, and make surethe device supports SNMP queries enabled in the IP shown on the screen. The IP address canbe changed as well as the SNMP community, which is set to public by default. Once filled out, clickon the SNMP Walk button. If everything is OK, it will show the interfaces and the data that can beobtained from them.

With Ctrl+Click (or CMD+Click in Mac) you may select more than one element in both boxes, asshown in the following screenshot. Remember to monitor the outgoing traffic (ifOutOctets), theincoming traffic (ifInOctets), and the interface status (ifOperStatus) on each interface. In thisparticular case, eth1, eth2 and eth3.

Page 25: First Steps (ISO/Centos)

2022/05/27 21:37 25/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Click on the Create modules button and a screen should display information about the modules thathave been created.

Remember that the network traffic modules areincremental type, meaning its value is the differencebetween the information sample taken previously, and thecurrent information. It shows a “rate” (in this case bytes/sec)so it takes some time (between 5 and 10 minutes) before itshows anything.

Click on the “View” tab to go back to the agent view and wait 5 minutes until having traffic data,refreshing or clicking on the “View” tab. After some time, you should have a screen similar to thisone, where you already have data from the traffic modules (incoming and outgoing, separately) and anew agent section, which shows information of the interfaces with direct access to an added graphwith superimposed outgoing and incoming traffic (if you click on the title Interface information(SNMP) ).

If you do not wish to wait or you prefer to “force” network module execution, use the force remotecheck icon (it will not work on local modules, or on modules collected locally by a softwareagent). Depending on the server load, it may take between 2 and 15 seconds to execute the networktest.

The information about the traffic modules will be displayed like this, with graphs for each metric.

Clicking on the graph icon will show a window with this monitor's graph, and clicking on the data

icon will show a table with data.

Page 26: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Network packets loss

Remote plugins are checks defined by the user that use a script or software deployed onto thePandora FMS server, so that it can be used for monitoring, increasing the range of tasks it maycarry out. A remote plugin that is pre-configured is to be added to Pandora FMS.

A serial plugin is used, so go to the Agent edit View, and then to the Module configuration tab.

Select a module type plugin and click on Create, which will lead you to the configuration interface for“remote plugin” type modules.

Page 27: First Steps (ISO/Centos)

2022/05/27 21:37 27/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Choose the plugin Package loss using the drop down menu, and enter the target IP address onwhich you want to implement the checks. Leave the rest of fields as they were. The editing mode issimilar, only the Create button is replaced by the Update button.

Page 28: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Refresh a couple of times until the new module appears on the list:

Page 29: First Steps (ISO/Centos)

2022/05/27 21:37 29/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

This is a very interesting plugin that, when used together with basic connectivity (ping) and latencytime, helps to determine the quality of your network, since the result reveals the package losspercentage, taking samples every 5 minutes.

Monitor a TCP network service

For the following case, a monitor will be added to verify that an SMTP service (mail) is active on amachine. Although it might be a very complex check (simulating sending an email, or sending userand password credentials, etc) it can be simplified by only checking only whether the port is open andif it answers.

Repeat the same initial steps from the previous example, but this time select Network module.

After that, use the drop down controls to find the desired check (Check SMTP Server) and click tocreate the module.

Page 30: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Finally, repeat the steps (go to the Operation View, and refresh until the monitor appears) so that thefinal result will be something similar to the following:

Page 31: First Steps (ISO/Centos)

2022/05/27 21:37 31/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Add an alert when there is some issue

In Pandora FMS, the most basic method of alerting is to assign an alert to a specific module. It ispossible to perform more advanced alert configurations (event alerts, correlation, etc), but they arenot included in this guide. The first alert will consist of simply sending an email when a monitoredmachine (with the Host module alive) is down.

Alerts in Pandora FMS are made up by three elements:

Command.Action.Template.

In this particular case, a predetermined command is used (email sending) an existing action will bemodified (Mail to XXX) and the existing template Critical condition will be used, which will executethe alert when said module goes into critical status.

Server configuration

For the email command to work properly, set up in the pandora_server.conf file a mail serverthat allows to perform relay actions.

In the example, the mail server is placed on the localhost through Postfix . Enter the local mail

Page 32: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

server's IP address or one that exists on the Internet (for which you would have to configure theAuthentication).

To modify the server's configuration file located at /etc/pandora/pandora_server.conf, accessit as root user, so you should have executed sudo su before. You are solely responsible for thispassword.

Edit file with vim. More information can be found in the video tutorial «Editing files with VIM».

Look for the same lines shown on the screenshot above and configure them as the image shows. Ifyou do not have a mail server, you may use a Gmail account for example. You can take a look at aquick guide about how to configure the Pandora FMS server to work with a gmail account followingthis link

Lines beginning with the # character are comments and they are not taken into account by theserver.

Once the changes are finished, press ESC and :wq to exit and save the changes. After savingchanges, restart the Pandora FMS server:

/etc/init.d/pandora_server restart

Page 33: First Steps (ISO/Centos)

2022/05/27 21:37 33/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Alert configuration

As previously mentioned, Pandora FMS alerts are made up by three components: command, actionand template. You can find these options in the Alerts section.

To configure this alert just modify the action. The action to use is Mail to XXX.

Page 34: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

In this case, if you need to change the email address you want to use ([email protected]), you mustmodify in Name Mail to XXX to Mail to [email protected] so that you can identify which actionis executed. Also modify field 1 and enter the desired target email address.

Page 35: First Steps (ISO/Centos)

2022/05/27 21:37 35/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

In field 2, leave the text shown on the screenshot. Here two macros that will replace the agent nameand the module that has generated the alert during execution are used.

Assigning an alert to a module

Navigate to agent edition, where the module is defined and click on the 'alerts' tab:

Page 36: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Now add the module (Host Alive), the template (Critical Condition) and the action (Mail to XXX).Then Add the alert.

Once added, you may see the alert from the Agent View to determine whether it is running or not, byobserving the status color:

Page 37: First Steps (ISO/Centos)

2022/05/27 21:37 37/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

You may wait until the host fails (or force it) to see whether the alert works, or you may “force thealert” to see if the email is actually sent. Click on the Force icon (see image):

Finally, the email with the alert should appear in your inbox. As it is a “forced” alert it says N/A in thedata field. In a real case, it should state the module's real values in the message.

Pandora FMS alerts are extremely flexible. Sometimes they seem to be difficult to use. If you need amore in-depth explanation, there is a specific chapter in the official documentation for alertmanagement: Alerts in Pandora FMS

Monitor a Windows Server with a software agent

Pandora FMS provides two types of monitoring:

Remote (from the Pandora FMS server to different devices).Local (where Pandora FMS is installed as a software agent on each monitored machine and

Page 38: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

retrieves the information you wish to observe and forwards it to the Pandora FMS server).

This section explains a software agent installation on MS Windows® computers and its basicmonitoring:

Agent Installation

First of all, download the MS Windows® agent. You can get it from:

https://sourceforge.net/projects/pandora/files/Pandora%20FMS%207.0NG/759/Windows/

In this link, you may choose between the 32-bit or 64-bit agent.

Once the agent is downloaded,run it by double-clicking on it and the language selection screen willappear::

This is a standard MS Windows® installer that will ask you to follow the steps. Accept the license andgo through the different installer screens. Select the path where you want the Pandora FMS agent tobe installed (it is installed at %ProgramFiles%/pandora_agent by default). You may modify thedestination folder by clicking on “Browse”. Once done, click “Next”:

Page 39: First Steps (ISO/Centos)

2022/05/27 21:37 39/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Wait for the files to be completely copied. Configure the Pandora FMS server IP address (or name)that will receive the agent's data, and the group you want to associate the agent to.

Page 40: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

In the following screen, you can see the option to enable remote configuration. It is important tohave it enabled through 1 if you want to have a copy of the Pandora FMS server agent, and from

there you may add, edit and delete local modules directly from the agent.

Page 41: First Steps (ISO/Centos)

2022/05/27 21:37 41/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Decide if you want to start the the agent service at the end of the Pandora FMS agent installation.Otherwise you will have to do it manually, or it will start when MS Windows® is restarted.

Page 42: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Once this process is finished, the MS Windows® agent should be installed, running and reporting onthe computer.

Checking the information returned by the agent

After installation, and when the MS Windows® agent is launched, it is time to check what this agentreports. To do that, find out the name that the agent will use to report. The agent is created with thehost name by default. You should see the name of the MS Windows® host by executing the hostnamecommand via cmd.exe.

Page 43: First Steps (ISO/Centos)

2022/05/27 21:37 43/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Now that you know the agent's name, the next step is to check if the agent has been created onPandora FMS. To do that, there are several options. The first one is to search in the Agent Details, inthe group where the agent has been created, which in our example is named Workstations.

A quicker and more efficient way to find the agent, is by performing the search directly through thePandora FMS search engine, indicating the name of the agent.

Page 44: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Here the agent will appear, and by clicking on it you may look into the information that it is beingreported.

By default, the MS Windows® agent comes with several pre-configured local modules in charge ofbasic monitoring, such as CPU load, used RAM percentage, disk free space in MB, etc.

If you need to add new modules to this agent, you may check the advanced documentation here:monitoring with software agents.

You may see graphs generated with the module's data history and a table with the module's datahistory from this screen by clicking on the icons marked in the following screenshot:

Page 45: First Steps (ISO/Centos)

2022/05/27 21:37 45/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Creating a Visual Screen with your monitoring details

One of the visualization options that Pandora FMS offers is the possibility of creating Visual Consoles.The Visual Console allows to represent the monitoring information in real time in a totally graphicalway. In this example of Visual Console, an example of a network distributed around the world will becreated and it will show how by clicking on the node that appears over Spain, you may see anothermap of Spain with other elements of the installation there.

The power of the maps is that it allows you to “summarize” the status of a child map in the display ofthe parent map, that is, if any of the elements displayed on the map of Spain goes into critical state,the icon that represents Spain will turn red. This allows you to set up highly customized hierarchieswhen displaying information. Maps can contain group, agent and module status information. Graphicsand data (numeric or text) can also be added, as well as text labels and icons.

Creating Map 1 ('Parent')

In this first map the status of several agents are added distributed on a world map. It can be donemanually, one by one, or using the Wizard. To make their creation easier, the Wizard is used in theexample:

The first step is creating a new map, called World Map.

Page 46: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Once created, click on the elements Wizard:

Page 47: First Steps (ISO/Centos)

2022/05/27 21:37 47/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

In the Wizard, select the type of element, in this example Static Graph, the desired image, if youwant to use an item per agent or per module (in this case per agent), and select the agents to beadded from the list.

Page 48: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Click on the Add button and all the elements created will be shown on the map, as seen in thefollowing screenshot.

Page 49: First Steps (ISO/Centos)

2022/05/27 21:37 49/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Move all the elements as you wish them to be placed on the map, clicking and dragging them to theirnew location.

Page 50: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Creating Map 2 ("Child" Map)

The second map will create an element that indicates the status of one of the main agents, togetherwith all the given modules. A graph of the FreeRAM module of the same agent is also displayed onthis map.

The first step is to create the new map just like you last time:

Page 51: First Steps (ISO/Centos)

2022/05/27 21:37 51/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Once created, add the element that shows the agent status in the Static Graph section:

Create the graph with the attached configuration too, clicking on the icon of graphs, adding the agentand module whose graph you will see.

The main element of the map is already created, now create a new element for each of the modulesthat exist within the agent. To do this, use the Wizard by making its configuration as seen in the

Page 52: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

attached screenshot. Select the agent's Static Graph and the modules you indicate. Label it with themodule's name and assign the item a parent you added previously in the Visual Map, in this case theelement you added before.

After creating all of these elements, they will appear attached to the main element, and you canmove them by dragging them with the mouse to wherever you want.

Link both maps

The previous steps helped you create two maps. The purpose of the next step is ensuring that whenclicking on the element placed over Spain on the World Map, the Spain Map opens up.

Open the World Map, in editing mode, by double-clicking on the 192.168.70.70 element. It willshow the element editor. Click on advanced options and on the Linked Map option, select the SpainMap and update the element.

Page 53: First Steps (ISO/Centos)

2022/05/27 21:37 53/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

When returning to the World Map view, click on a element placed over Spain, which should directlyopen the Spain Map. If there were just one red element on the Spain Map, the icon representing Spainon the parent map would also be red.

Page 54: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

Adjust monitoring

In this section, we will show you how to configure some of the more advanced options of a module(threshold, units, others).

Go to agent module view.

Page 55: First Steps (ISO/Centos)

2022/05/27 21:37 55/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

Select the module you wish to configure:

Page 56: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

After that, open the Avanced Options tab and proceed to configure the fields to reflect theinformation you want to see.

Page 57: First Steps (ISO/Centos)

2022/05/27 21:37 57/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

In the following sections, you will see how to configure the fields called Unit and Interval, and thethresholds named as Warning Status and Critical Status.

Configuring module units

This option allows the user to define the data units obtained from a module. These units will beincluded in graphs and reports, so that it is easier to manage and understand the data shown to theuser.

Page 58: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

In the example, the unit must be %. Go to the “Unit” field and type in the desired unit.

Finally, click on the “Update” button and check whether your unit is properly shown in the module'sview.

Configuring a module interval

By configuring or modifying the module interval, it is defined how often the module should beexecuted. This is applied to remote modules (not local ones), because local modules are configured ina more complex way. The more frequently you monitor a remote system, the heavier theload on the monitored system will be.

Click on the Update button and the module will be configured.

Module threshold configuration

In this section, Warning and Critical thresholds for a module are set up, which define what values amodule must reach to get into CRITICAL, WARNING or NORMAL status.

In this example you want to add thresholds to a CPU module. This module will always be in NORMAL(green) state as long as it is between 0% and 100%. If you want this module to be displayed inCritical or Warning status when the CPU reaches a certain %, configure it by determining thresholdsfor Warning Status and Critical Status. In this example, configure them so that when the CPUreaches 90% of use, the module goes into Warning status and if it exceeds 95%, it goes intoCritical.

After setting the thresholds, click Update to have them properly configured. The next pieces of data

Page 59: First Steps (ISO/Centos)

2022/05/27 21:37 59/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

received will be compared against those thresholds.

Advanced Threshold Parameters

The Inverse interval box is used to define non-contiguous ranges. In this example, the module willswitch to critical status if the value is below 20 or above 80:

In text string type modules, the threshold is defined as a substring. Likewise, it is possible to invert itto make the module go into CRITICAL if it does not have the substring as a parameter:

Other Advanced Parameters

Module configuration is highly flexible, with dozens of possibilities. Explore the Pandora FMS officialdocumentation to learn more about all of those options.

Solving problems. Where to look and who to ask

Configuration files and sources for diagnostic information

The main configuration files that you may need to modify/review are the following:

/etc/pandora/pandora_server.conf: Pandora FMS sever main configuration file. If modifyanything here, reboot the Pandora FMS server./etc/pandora/pandora_agent.conf: Pandora FMS main configuration file in Unix. If youchange anything here, restart the Pandora FMS agent.%ProgramFiles%\pandora_agent\pandora_agent.conf: Pandora FMS main configurationfile in Windows®. If you change anything here, restart the Pandora FMS agent service./etc/my.cnf: Main MySQL configuration file./var/www/html/pandora_console/include/config.php: Pandora FMS consoleconfiguration file. During the installation it is auto-configured, but if you need to change anyenvironment parameters (path, IP, user/password of MySQL, host of MySQL) modify it manually.

Sources of information (logs) where you can find more info, errors, etc:

/var/log/pandora/pandora_server.log: Server log file, which contains very important

Page 60: First Steps (ISO/Centos)

Last update: 2022/05/27 11:36 en:quickguides:general_quick_guide https://pandorafms.com/manual/en/quickguides/general_quick_guide

https://pandorafms.com/manual/ Printed on 2022/05/27 21:37

clues. If you need more details, modify the “verbosity” parameter of the server configurationfile to see more details./var/log/pandora/pandora_server.error: Error log file not captured by the server,which contains error traces not handled by the server./var/log/pandora/pandora_agent.log: Log file of the Unix agent.%PROGRAM_FILES%\pandora_agent\pandora_agent.log: Log file of the Windows® agent./var/www/html/pandora_console/log/console.log: Log file of the Pandora FMSconsole./var/log/httpd/error_log: Error log file of the Apache server (httpd)./var/log/messages: System log file.dmesg: Command that shows Kernel warnings./var/log/pandora/pandora_snmptrap.log: SNMP trap logs. If there are any errors in theSNMP traps console boot, it can show error traces there./var/log/mysqld.log: log de Mysqld./var/log/pandora/web_socket.log: Websocket log./var/www/html/pandora_console/log/cron.log: Cron log.

Permissions of some directories:

/var/spool/pandora/data_in/ It should be pandora:apache with 755 permissions./var/log/pandora/ It should be pandora:root with 755 permissions./var/www/html/pandora_console/include/config.php It should be apache:apachecon permisos 600 permissions.

For versions prior to 747, Pandora Console log path will be/var/www/html/pandora_console/pandora_console.log

If updating from OUM you will need to modify the logrotate file.

Support

Our community forum is open to everybody, create an account and ask away!

Pandora FMS forums.

There is also a FAQ (Frequently Asked Questions) that can help you find a tip or solve a certainproblem:

Pandora FMS FAQ

And of course, you have the official training option. There are several certification levels for PandoraFMS. Read more at:

Pandora FMS official training.

Anyone who is willing to help us with software development,document editing, or any other task that improves Pandora

Page 61: First Steps (ISO/Centos)

2022/05/27 21:37 61/61 First Steps (ISO/Centos)

Pandora FMS Documentation - https://pandorafms.com/manual/

FMS will be more than welcome. Join us!

Go back to Quick Guides index

From:https://pandorafms.com/manual/ - Pandora FMS Documentation

Permanent link:https://pandorafms.com/manual/en/quickguides/general_quick_guide

Last update: 2022/05/27 11:36