2013-02-12 Sancho Lerena <slerena@artica.es>

* conf/pandora_server.conf: Review of default configuration
        values and some new description / comments.




git-svn-id: https://svn.code.sf.net/p/pandora/code/trunk@7632 c3f86ba8-e40f-0410-aaad-9ba5e7f4b01f

pandora_server/ChangeLog

@@ -1,3 +1,8 @@
+2013-02-12  Sancho Lerena <slerena@artica.es>
+
+	* conf/pandora_server.conf: Review of default configuration
+	values and some new description / comments.
+
 2013-02-07  Sergio Martin <sergio.martin@artica.es>
 
 	* lib/PandoraFMS/Core.pm

pandora_server/conf/pandora_server.conf

@@ -1,9 +1,9 @@
 #############################################################################
 # Pandora FMS Server Parameters
 # Pandora FMS, the Flexible Monitoring System.
-# Version 5.0dev
+# Version 5.0
 # Licensed under GPL license v2,
-# (c) 2003-2011 Artica Soluciones Tecnologicas
+# (c) 2003-2013 Artica Soluciones Tecnologicas
 # http://www.pandorafms.com
 # Please change it for your setup needs
 #############################################################################
@@ -39,14 +39,15 @@ errorlog_file /var/log/pandora/pandora_server.error
 # daemon 1
 
 # dbengine: mysql, postgresql or oracle (mysql by default)
-#dbengine mysql
+
+dbengine mysql
 
 # Database credentials. A VERY important configuration.
 # This must be the same credentials used by your Pandora FMS Console
 # but could be different if your console is not running in the same
 # host than the server. Check your console setup in /include/config.php
 
-# dbname: Database name (pandora by default
+# dbname: Database name (pandora by default)
 
 dbname pandora
 
@@ -68,6 +69,7 @@ dbhost localhost
 #dbport 3306
 
 # By default, parent agent will not update
+
 #update_parent 0
 
 # verbosity: level of detail on errors/messages (0 default, 1 verbose, 2 debug.... 10 noisy)
@@ -81,14 +83,15 @@ verbosity 1
 master 1
 
 # Activate Pandora SNMP console (depending on snmptrapd)
-# only available on Pandora Network server
 
-snmpconsole 1
+snmpconsole 0
 
 # snmptrapd will ignore authenticationFailure traps if set to 1.
+
 snmp_ignore_authfailure 1
 
 # snmptrapd will read the PDU source address instead of the agent-addr field is set to 1.
+
 snmp_pdu_address 0
 
 # Activate (1) Pandora Network Server 
@@ -104,17 +107,21 @@ dataserver 1
 reconserver 1
 
 # pluginserver : 1 or 0. Set to 1 to activate plugin server with this setup
+
 pluginserver 1
 
 # Pandora FMS Plugin exec tool filepath (by default at /usr/bin)
+
 plugin_exec /usr/bin/timeout
 
 # predictionserver : 1 or 0. Set to 1 to activate prediction server with this setup
 # DISABLED BY DEFAULT 
+
 predictionserver 0
 
 # wmiserver : 1 or 0. Set to 1 to activate WMI server with this setup
 # DISABLED BY DEFAULT
+
 wmiserver 0
 
 # Network timeout (in seconds) for timeout in network connections for Network agents
@@ -126,13 +133,16 @@ network_timeout 5
 server_keepalive 45
 
 # Server Threshold: defines number of seconds of main loop (in sec)
+
 server_threshold 5
 
 # Network threads: Do not set too high (~40). Each threads make a network module check.
-network_threads 4
+
+network_threads 3
 
 # icmp_checks x : defines number of pings for each icmp_proc module type. at least one of 
 # that ping should be 1 to report 1
+
 icmp_checks 1
 
 # tcp specific options :
@@ -156,7 +166,7 @@ snmp_proc_deadresponse 1
 
 # plugin_threads: Specify number of plugin server threads for processing plugin calls
 
-plugin_threads 2
+plugin_threads 1
 
 # plugin_timeout: Specify number of seconds calling plugin exec waiting for response
 # after this time, call is aborted and result is "unknown".
@@ -169,35 +179,39 @@ wmi_timeout 10
 
 # wmi_threads: Specify number of WMI server threads for processing WMI remote calls
 
-wmi_threads 2
+wmi_threads 1
 
 # recon_threads. Each thread will scan a different scantask.
 
-recon_threads 2
+recon_threads 1
 
 # dataserver_threads: Number of threads for data server (XML processing threads)
 
-dataserver_threads 2
+dataserver_threads 1
 
 # mta_address: External Mailer (MTA) IP Address to be used by Pandora FMS internal email capabilities
-#mta_address 192.168.50.1
 
 mta_address localhost
 
-# mta_port: MTA port (default 25)
+# mta_port, this is the mail server port (default 25)
+
 #mta_port 25
 
 # mta_user MTA User (if needed for auth, FQD or simple user, depending on your server)
+
 #mta_user myuser@mydomain.com
 
 # mta_pass MTA Pass (if needed for auth)
+
 #mta_pass mypassword
 
-# mta_auth MTA Auth system (if needed, support: LOGIN, PLAIN, CRAM-MD5, DIGEST-MD)
+# mta_auth MTA Auth system (if needed, it supports LOGIN, PLAIN, CRAM-MD5, DIGEST-MD)
+
 #mta_auth LOGIN
 
 # mta_from Email address that sends the mail, by default is pandora@localhost 
 #           probably you need to change it to avoid problems with your antispam
+
 #mta_from Pandora FMS <pandora@mydomain.com>
 
 # xprobe2: Optional package to detect OS types using advanced TCP/IP 
@@ -217,9 +231,11 @@ nmap /usr/bin/nmap
 snmpget /usr/bin/snmpget
 
 # Location of the braa binary needed by the Enterprise SNMP Server (/usr/bin/braa by default) (PANDORA FMS ENTERPRISE ONLY).
+
 braa /usr/bin/braa
 
 # Default group id for new agents created with Pandora FMS Data Server
+
 autocreate_group 2
 
 # Set to 1 if want to autocreate agents with Pandora FMS Data Server, 
@@ -239,6 +255,7 @@ max_log_size 65536
 max_queue_files 500
 
 # Use the XML file last modification time as timestamp.
+
 # use_xml_timestamp 1
 
 # Pandora FMS will autorestart itself each XXX seconds, use this if you experience problems with 
@@ -254,9 +271,11 @@ max_queue_files 500
 # More information about GIS Setup in /usr/share/pandora_server/util/gis.README
 # Flag to activate GIS (positional information for agents and maps) 
 # by default it is desactivated
+
 #activate_gis 0
 
 # Radius of error in meters to consider two gis locations as the same location.
+
 #location_error 50
 
 # Recon reverse geolocation mode [disabled, sql, file]
@@ -271,17 +290,21 @@ max_queue_files 500
 
 # Recon reverse geolocation file. This is the database with the reverse 
 # geolocation information using MaxMind GPL GeoLiteCity.dat format).
+
 #recon_reverse_geolocation_file /usr/local/share/GeoIP/GeoIPCity.dat
 
 # Radius (in meters) of the circle in where the agents will be place randomly 
 # when finded by a recon task. Center of the circle is guessed 
 # by geolocating the IP.
+
 #recon_location_scatter_radius 1000
 
-# Pandora Server self-monitoring (embedded agent) (by default disabled)
+# Pandora Server self-monitoring (embedded agent) (by default enabled)
-#self_monitoring 1
+
+self_monitoring 1
 
 # Update parent from the agent xml
+
 #update_parent 1
 #
 #
@@ -300,70 +323,96 @@ max_queue_files 500
 # openstreetmaps_description 1
 
 # Enable (1) or disable (0) Pandora FMS Event Web Server (PANDORA FMS ENTERPRISE ONLY).
+
 webserver 1
 
 # Number of threads for the Web Server (PANDORA FMS ENTERPRISE ONLY).
+
 web_threads 1
 
 # Enable (1) or disable (0) Pandora FMS Inventory Server (PANDORA FMS ENTERPRISE ONLY).
+
 inventoryserver 1
 
 # Number of threads for the Web Server (PANDORA FMS ENTERPRISE ONLY).
+
 inventory_threads 1
 
 # Enable (1) or disable (0) Pandora FMS Export Server (PANDORA FMS ENTERPRISE ONLY).
-exportserver 1
+
+exportserver 0
 
 # Number of threads for the Export Server (PANDORA FMS ENTERPRISE ONLY).
+
 export_threads 1
 
 # Enable (1) or disable (0) Pandora FMS Event Server (PANDORA FMS ENTERPRISE ONLY).
-eventserver 1
+
+eventserver 0
 
 # Event Server event window in seconds (3600 by default) (PANDORA FMS ENTERPRISE ONLY).
+
 event_window 3600
 
 # Enable (1) or disable (0) Pandora FMS Enterprise ICMP Server (PANDORA FMS ENTERPRISE ONLY).
-icmpserver 1
+# You need nmap 5.20 or higher in order to use this !
+
+icmpserver 0
 
 # Number of threads for the Enterprise ICMP Server (PANDORA FMS ENTERPRISE ONLY).
+
 icmp_threads 2
 
 # Enable (1) or disable (0) Pandora FMS Enterprise SNMP Server (PANDORA FMS ENTERPRISE ONLY).
+# Check braa tool is running and operative.
+
 snmpserver 0
 
 # Number of threads for the Enterprise SNMP Server (PANDORA FMS ENTERPRISE ONLY).
+
 snmp_threads 2
 
 # Block size for block producer/consumer servers, that is, the number of modules
 # per block (15 by default) (PANDORA FMS ENTERPRISE ONLY).
+
 block_size 15
 
-# Enable (1) or disable (0) Pandora FMS Netflow Server (PANDORA FMS ENTERPRISE ONLY).
+# Enable (1) or disable (0) Pandora FMS Netflow Server.
+# You need to install package nfcapd before try to use this feature.
+
 netflowserver 0
 
-# Path to the netflow daemon nfcapd.
+# Path to the netflow daemon nfcapd. Check your local path, depending on OS could be on
-netflow_daemon /usr/local/bin/nfcapd
+# different path.
+
+netflow_daemon /usr/sbin/nfcapd
 
 # Netflow file rotation interval in seconds.
+
 netflow_interval 300
 
 # Base directory where netflow files will be stored.
+
 netflow_basedir /tmp
 
 # If set to 1, process XML data files in a stack instead of a queue. 0 by default.
 # WARNING: Incremental modules will not work properly if dataserver_lifo is set to 1!!!
+
 dataserver_lifo 0
 
 # If set to 1, the policy manager is enabled and the server is listening the policy queue. 
 # 0 by default (PANDORA FMS ENTERPRISE ONLY) 
-policy_manager 1
+
+policy_manager 0
 
 # If set to 1, the event replicate process is enabled. 0 by default. (PANDORA FMS ENTERPRISE ONLY) 
 # WARNING: This process doesn't do anything if is not properly configured from the console setup 
-event_replication 1
+
+event_replication 0
 
 # If set to 1, new events validate older event for the same module. This will
-# affect the performance of the server.
+# affect the performance of the server. This was the "normal behaviour" on previous (4.x) versions.
+# disable only if you really know what you are doing !!.
+
 event_auto_validation 1