1. Home
  2. Knowledge Base
  3. Articles (EN/ES/FR)
  4. How can you create satellite server agents?

How can you create satellite server agents?

There are three ways to create the agents in the Satellite Server: Recon Task, satellite_hosts.txt file or manually creating the .conf of the agents to be monitored.

Creating agents through Recon Task

The creation of agents through Recon Task is the most used by Pandora FMS users. To carry it out, we should access to the Satellite Server configuration file and configure the following parameters:

  • recon_community: You should specify a list of SNMP communities to use in the SNMP discovery separated by commas (in the case of doing a SNMP type recon).
  • recon_enabled: Must be set to 1 to enable Satellite Server recon task.
  • recon_interval: Time interval where the network we want is scanned, in seconds (by default 604800 seconds, 7 days).
  • recon_mode: Way to do the recon task (SNMP,ICMP,WMI), separated by commas.
  • recon_task: List of networks to which we want to do the recon, separated by commas.
  • recon_timing_template: A value that specifies how aggressive nmap should be, from 1 to 5. 1 means slower but more reliable; 5 means faster but less reliable (default 3).

An example of this configuration:

recon_community public
recon_enabled 1
recon_interval 604800
recon_mode icmp,snmp,wmi
recon_task 192.168.0.0/24,192.168.1.0/24
recon_timing_template 3

Once the data is configured, we run the Satellite Server using the command:

[root@SatelliteServer ~]# /etc/init.d/satellite_serverd start

Creation of agents through satellite_hosts.txt file

First of all, to create an agent using the file satellite_hosts.txt, we must go to the Satellite Server configuration file and decomment the line:

host_file /etc/pandora/satellite_hosts.txt

Secondly, we will create the file satellite_hosts.txt with the IP addresses of the hosts we want to create, putting IP address and name of the agent to be created:

192.168.10.5 Server5
192.168.10.6 Server6
192.168.10.7 Server7

Once the data is configured, we run the Satellite Server using the command:

[root@SatelliteServer ~]# etc/init.d/satellite_serverd start

Creation of agents in a manual way

First of all, we are in the Satellite Server configuration file in the agent_conf_dir parameter, which is where the new agents configuration files are created (by default /etc/pandora/conf).

[root@SatelliteServer ~]# cd /etc/pandora/conf

Once located in that directory, we will only have to create a .conf file of the agents that we want to create, taking for example the server agent as an example, and filling manually the following fields:

  • agent_name: We will put the name that we want to give to the agent.
  • agent_alias: We will put the alias that we want to give to the agent.
  • address: Put the IP address of the element that we want to monitor.
  • group: Group to which we want to assign the agent.
  • gis_exec: Positioning script (optional). If it is used, overwrite the location provided by the Satellite Server general_gis_exec parameter.

The following would be to create the modules that we want to monitor in the agent, an example would be

agent_name Example1
agent_alias Is an example
address 127.0.0.1
group Servers
module_begin
module_name Ping
module_ping
module_end
module_begin
module_name Latency
module_latency
module_end

Once the data is configured, we start the Satellite Server using the command:

[root@SatelliteServer ~]# /etc/init.d/satellite_serverd start

If you have more questions or want to investigate more about the satellite server, here is the link to our wiki:

https://pandorafms.com/manual/en/documentation/05_big_environments/05_satellite

Was this article helpful?

Related Articles