====== Console Settings ======
{{indexmenu_n>12}}
In this section you can modify and adjust operating parameters of the **Pandora FMS** Console, which will affect its general operation.
In the **Management** → **Setup** → **Setup ** section you will find all the configuration options, which are described below.
===== Setup =====
==== General Setup ====
Important fields:
* **Remote configuration directory**: Field that identifies the directory where the remote configuration of the default agents is saved located in:
/var/spool/pandora/data_in
* **Chromium path**: The path or PATH where Chromium is installed must be entered. **Chromium** is a special component that is used to dynamically generate graphics in PDF.
* **Automatic login (hash) password**: Defines a static symmetric password, used to create a hash and enable automatic validation by URL. It is used to integrate Pandora FMS into another WEB application, passing a username as a parameter, and using a hash generated by the username and this password, allowing automatic validation in Pandora FMS, without entering a password. To see an example of this integration see the file ''/extras/sample_login.php'' of the Pandora FMS Console.
* **Time source**: List where you can choose the source of the date and time to use. It can be the local system ("System") or the database ("Database"). The first is typically used when the database is on a different system with a different time zone than the Console.
* **Attachment directory**: Pandora FMS Console file directory. Used to host collections, issue attachments and other series of files. **You must have write permissions** for the web server, it is located by default at:
/var/www/pandora_console/attachment
* **Enforce https**: Force the redirection to https. If you enable it **you will necessarily have to activate the use of Pandora FMS with https on your WEB server**.
If you have enabled this field and have not configured your Apache to use HTTPS, you will not be able to access the WEB console and will have to disable this option again by accessing the database directly through MySQL and inserting the following query:
update tconfig set `value` = 0 WHERE `token` = 'https';
* **Automatically check for updates**: Enable/disable automatic checking for updates in the Warp Update. This causes the console to contact the Pandora FMS update provider every time you log in, sending anonymous information about the use of Pandora FMS (number of agents).
* **API password **: Authentication method to access the [[:en:documentation:pandorafms:technical_reference:02_annex_externalapi|Pandora FMS API]].
* **IP list with API access**: List of IP addresses that will have access to the Pandora FMS webservice API (by default ''127.0.0.1'', local access only). The asterisk can be used as a wildcard, so placing ''*'' gives access to all IP addresses or, for example, ''125.56.24.*'' grants access to the entire subnet ''125.56. 24'' .
* **Enable GIS features**: Enable/Disable the [[:en:documentation:pandorafms:monitoring:20_gis|GIS features]] for the Pandora FMS console.
* **Enable NetFlow**: Enable or disable [[:en:documentation:pandorafms:monitoring:18_netflow|NetFlow]].
* **General network path** (Version 770 or later): Directory where the ''netflow'' and ''sflow'' directories will be stored for the corresponding data.
* **Server timezone setup**: Defines the time zone in which the Console is located. Unlike the codes/abbreviations of all countries (ISO 3166), the list of time zones has complicated regulations (IANA Time Zone Database), which is why a first list with continents/countries is included and selecting an option from it will update the list. second list where you can choose exactly a country/city. The **Timezone setup** text box will not change until you press the **Update** button.
* **Public URL**: A public URL can be stored. It is useful to complete this field when you have a reverse proxy or, for example, with the **mod_proxy** mode of the Apache web server.
* **Inventory changes blacklist** (Version 768 or later): Inventory modules included within the blacklist will not generate events when they change.
* **Server log directory**: Directory where the server log files are stored.
* **Event storm protection**: If this option is enabled, no events or alerts will be generated, but data will still be received.
* **Command line snapshot**: String or string type modules that return more than one line will display their content in the form of an image.
* **Change remote config encoding**: Activating this parameter converts the character encoding (encoding) of the writing of the modules in the remote configuration files from UTF-8 by default to the encoding configured in the files themselves. setting.
* **Referrer security**: When active, it is checked for security that the user comes from a Pandora FMS URL and that the link is **not** external and therefore is no longer suspicious. By default it is disabled. The extreme security sites that are verified are:
* DB manager extension.
* User configuration.
* Recon script configuration.
* **Allows create planned downtimes in the past**: Activate or deactivate the possibility of creating planned downtimes in the past. The purpose of this is to modify information for [[:en:documentation:pandorafms:monitoring:07_services|SLA reports]].
* **Limit for bulk operations**: Limit of elements that can be modified by bulk operations at one time.
* **Include manually disabled agents**: Allows you to enable or disable the display of manually disabled agents in certain Console views.
* **Set alias as name by default in agent creation**: When this parameter is activated, the selection box in the agent creation menu collects the alias entered in the form and also saves it as the agent name and is activated by default .
* **Unique IP**: Enabling this parameter will automatically activate the Unique IP button when creating and editing agents to detect whether the IP addresses assigned to an agent are available or in use by the same agent or another agent.
* **Module custom ID readonly **: Activating this parameter blocks the editing of the custom id of an agent's module from the Console but allows editing from the CLI and the API. This is useful for automatic third-party integrations without the user being able to modify this value.
* **Enable console log**: Due to the large amount of debug data generated by this log, it is recommended to disable it, as configured by default. If activated, the file ''/var/log/php-fpm/error.log'' is used to log Console events.
If you are using EL8 (Enterprise Linux 8), apart from enabling **Enable console log**, you must modify the file
/etc/php-fpm.d/www.conf
and comment with a semicolon the following parameter:
;php_admin_value[error_log] = /var/log/php-fpm/www-error.log
This way the data will be saved in ''…/pandora_console/log/console.log'' .
* **Enable audit log**: When activated, the file ''…/pandora_console/log/audit.log'' is used for auditing.
* **Enable console report** (NG Version 764 or later): Allows you to enable the Web Console in mode dedicated to generating reports, see the section "[[:en:documentation:pandorafms:management_and_operation:12_console_setup#dedicated_console_for_reports|Dedicated console for reports]]" for more information.
* **Check connection interval** (NG Version 770 or later): Time interval (in seconds) to check the connection to the database server. Default ''180'', minimum value ''60''.
* **Keep In process status for new events with extra ID**: (NG version 771 or later): If there is any "In process" event with a specific extra ID and a "New" event with that extra ID is received, will be created as "In Process".
* **Enable Feedback**: Active by default, allows direct access to the [[:en:documentation:pandorafms:installation:03_interface|header]] of the Web Console to notify of an error and include the installation data.
* **Number of modules in queue**: Sets the maximum number of queued modules (500 by default) and if this value is exceeded, a warning icon will be displayed for each item in the server administration.
* **Keep in process status for new events with extra ID**: If any **In process** event with a specific extra ID is triggered and a new event with that Extra ID is received, it will be created as **In process instead**. New events also inherit the **Extra ID** from the event.
=== NCM Configuration ===
* **FTP server IP**: IP address of the FTP server in the [[:en:documentation:pandorafms:monitoring:16_ncm#network_equipment_templates|Network equipment templates]].
=== Dedicated console for reports ===
NG 764 version or later.
The critical mission of the dedicated Reporting Console, based on the data extracted from the PFMS databases (main and historical), is to prepare, convert into useful information, generate, save and send reports for hundreds of agents and software agents. To do this, it has preconfigured special aspects for both the software and the hardware:
* The memory (RAM, virtual or real) for PHP must be able to use, if necessary, **the maximum amount that the computer has**. If not, you will receive timely notice of such insufficiency. [[:en:documentation:pandorafms:installation:01_installing|See installation]] for configuration details.
* Enable Dedicated Console mode for reports in the **Enable console report** option of the [[#general_setup|General configuration]].
* To use the dedicated Console for reports you must add the following parameter to the respective ''config.php'' file:
$config["reporting_console_node"] = true;
* Only admin users will be able to log in to the Dedicated Reporting Console.
* Menu options are limited to essential operation, especially for PFMS software upgrade. **You will need to configure everything else through another Web Console connected to the same databases**. See the section for [[#ks1_1_3|email sending configuration]].
=== Email Settings ===
Below there is a configuration example using the Gmail® SMTP server:
{{ :wiki:wiki223.png }}
If you use a Gmail® account, Google® may block authentication attempts by certain applications. For correct operation, it will therefore be necessary to enable access to unsafe applications. You may find more information about how to do this on the official Google® support pages.
For security, use a Gmail® email account created specifically and solely to send notification messages from Pandora FMS server. Never use an email account for personal use for this.
If necessary, modify the token ''mta_auth'' in file ''/etc/pandora/pandora_server.conf''. This token, by default, is set as a comment, **so it must be activated by editing this line and setting the required authentication type**, see [[:en:documentation:pandorafms:installation:04_configuration#mta_auth|this link]] for more details.
Once the email configuration has been saved, by clicking on the **Email test** option you may check if your configuration is correct by sending an email automatically generated by Pandora FMS to a desired email address. Only if the selected settings are correct, you will be able to see the email in your inbox.
Make sure that your Pandora FMS server is capable of resolving, through its DNS server, the mail server in charge of your email domain.
''nslookup -type=mx my.domain''
Also in this case, make sure that your email server accepts emails redirected from Pandora FMS server.
For more information you may check [[:en:documentation:pandorafms:installation:04_configuration#mta_address|Pandora FMS server configuration]].
==== Password policy ====
To activate the password policy, you must have an administrator profile (**Pandora administrator**) or be **[[:en:documentation:pandorafms:introduction:03_glossary#superadmin|superadmin]]** .
It is configured in **Management** → **Setup** → **Setup** → **Password policy**:
Important fields:
* **Enable password policy**: Deactivated by default.
* **Min. password size**: By default four characters.
* **Password expiration**: By default zero ''0'' days (no expiration).
* **Block user if login fails**: Minutes that the user remains blocked if the maximum number of failed attempts is consumed, by default 5 minutes.
* **Number of failed login attempts**: By default 5 attempts.
* **Compare previous password**: Number of previous passwords that cannot be chosen for the password change, default 3.
* **The password must include numbers**: The password must include numbers, disabled by default.
* **The password must include symbols**: The password must include symbols, disabled by default.
* **Force password change on first login**: Force password change on first login after user creation, disabled by default.
* **Apply password policy to admin users**: Applies the password policy also to administrator users, activated by default.
* **Enable password history**: Enables/disables the activation of password history, disabled by default.
* **Exclusion list for passwords**: Allows you to add a list of passwords explicitly excluded from use in Pandora FMS.
==== Enterprise ====
* **Metaconsole link status**: Indicates the connection status if the Command Center (Metaconsole) is active. See the [[:en:documentation:pandorafms:command_center:03_installation|Command Center -Metaconsole- Installation and Configuration]] section for more information.
* **Forward SNMP traps to agent (if exist)**: Configuration that allows associating SNMP traps and agents. By activating this option, when a trap is received with the same IP address as an agent, a module is created in that same agent with the name ''SNMPTrap'' and type ''async_string''. The value of the module will be that of the last OID received, that is, it is updated with the arrival of new traps. If **Yes and change status** is selected, in addition to updating the value upon receiving the trap, the module changes to ''CRITICAL'' state. To return to ''NORMAL'' state you must validate or delete all traps associated with that agent from the SNMP console. In the case of **Yes without changing status** only the value of the module is changed.
* **Use Enterprise ACL System**: This will activate the ACL system which is more flexible than the standard ACL system. See [[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration#acl_enterprise_system|New ACL system (Enterprise)]]
* **Collection size**: This is the maximum size, in bytes, for collections. See section [[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy#file_collections|Collections]].
* **Activate log collector ** [[:en:documentation:pandorafms:management_and_operation:12_console_setup#log_collector|Activate logging]].
* **Enable update manager: **Activate the [[:en:documentation:pandorafms:installation:02_anexo_upgrade|Warp Update Manager]] option.
* **Legacy HA database management** (Version 770 or later): Disabled by default; allows you to activate the [[:en:documentation:pandorafms:complex_environments_and_optimization:06_ha|HA system]] controlled by ''pandora_ha''.
* **Critical threshold for occupied addresses**: A threshold must be set for the supernet map of the extension [[:en:documentation:pandorafms:monitoring:11_ipam#ipam_supernet|IPAM]] for the critical range of occupied addresses.
* **Warning threshold for occupied addresses**: A threshold must be set for the supernet map of the extension [[:en:documentation:pandorafms:monitoring:11_ipam|IPAM]] for the busy address warning range.
==== Historical database ====
This functionality allows data to be saved with a configured age in a database other than the main one to speed up the exploitation of the latter.
From the menu choose **Management** → **Setup** → **Setup** → **Historical database** and press the **Enable historical database** button to access the connection settings (**Configure connection target**). After filling in the fields and connecting to the historical database, fill in the custom parameters (**Customize settings**):
* **Advanced options**: Enable advanced options.
* **String data days old to keep in active database**: Age of the string data to keep in the active database. String data will be available in the active database at the time and days you specify here. The oldest information will be sent to the history database. Data will be purged from the active database after 0 days (default).
* **Data days old to keep in active database**: From how many days the data will be transferred to the historical database. Default value: fifteen ''15'' days.
* **Transference block size (Step)**: Mechanism for transferring data (similar to a data buffer) to the historical database. The smaller the number of records, the less impact the performance of the main database will have. Default value one thousand five hundred ''1500'' records, recommended value one thousand. See the next point to set the time period.
* **Delay between transferences (seconds)**: Waiting time -in seconds- between data transfers between the main and historical databases. Default value one ''1'', recommended value: two ''2''.
* **Maximum historical data age (days)**: Maximum number of days to retain numerical data. Default value: one hundred eighty ''180''.
* **Maximum historical string data age (days)**: Maximum number of days to retain text string data. Default value: one hundred eighty ''180''.
* **Automatic partition of big tables**: To automatically create monthly partitions in IDB files of specific databases ( ''tagente_datos'' and ''tagente_datos_string'' ).
* **Enable historical events**
* **Events days old to keep in active database**: Number of days to keep events in the historical database. Default value: ninety ''90'' days. Note that from the main database the events are deleted (purged) after seven days.
* **Maximum historical events age (days)**: Number of days to finally delete events from the historical database. Default value: one hundred and eighty days ''180''.
* **Enable historical traps**: Activating the **Enable historical traps** option allows you to store the [[:en:documentation:pandorafms:monitoring:08_snmp_traps_monitoring|SNMP traps]] in the historical database:
* **Days old to keep in active database**: Number of days old to keep in the active database. Default value: 6 days.
* **Maximum historical traps age (days)**: Number of days old to maintain in the historical database. Default value: 180 days.
==== Log collector ====
Menu **Management** → **Setup** → **Setup** → **Log collector** (OpenSearch). It must be configured as explained in "[[:en:documentation:pandorafms:monitoring:09_log_monitoring|Monitoring and log collection]]".
==== Authentication ====
The following fields are common to all options:
* **Control of timeout session**: By default activated, it checks if there has been no activity in the time period set in **Session time (mins)** to close the session.
* **Session time (mins)**:
* The default value is ''90'' minutes and when you set this value to ''0'' for a user, Pandora FMS will use the value saved in the General Settings, authentication section.
=== Local Pandora FMS ===
Default authentication indicates that it will be carried out using the internal Pandora FMS database. For security, superadmin type users are always authenticated in this way, the rest of the authentication types have the local option as a backup (fallback).
=== Active Directory ===
* **Automatically create remote users**: Enables or disables automatic creation of remote users. This option makes it possible for Pandora FMS to create users automatically once they log in. If you enable this feature, the following fields will be available:
* **Save Password**: If activated, it allows you to save AD passwords in the local Pandora FMS database.
* **Advanced Configuration AD**: If this option is enabled, the Advanced Permissions AD configuration will be used.
* **Advanced Permissions AD**: Lists the advanced permissions that have been added in **Add new permissions**.
* **Automatically create profile**: When the automatic creation of remote users is active, this field makes it possible to assign a type of profile to these users that are created automatically. The default profiles are: ''Chief Operator'', ''Group Coordinator'', ''Operator (Read)'', ''Operator (Write)'' and ''Pandora Administrator''. The different profiles available can be consulted in the **Profiles** → **Profile management** section.
* **Automatically create profile group**: When activating the automatic creation of remote users, this field makes it possible to assign a group to these automatically created users. The different groups available can be consulted in the **Profiles** → **Manage agent groups** section.
* **Automatically create profile tags**: When the automatic creation of remote users is active, this field makes it possible to assign a profile to a group with the desired tags. The different available groups can be consulted in the **Profiles** section → **Module tags**.
* **Autocreate blacklist**: Allows you to write a list of users, separated by commas, that will not be created automatically.
* **Active Directory server**: Define here the path where our Active Directory server is located.
* **Active Directory port**: To define the port number of the Active Directory server (''389'' by default).
* **Start TLS**: Defines whether or not the Transport Layer Security (TLS) protocol will be used in communications between the client and the server.
* **Enable secondary active directory**: Allows you to activate the connection to a secondary **Active Directory** server. It has the same fields as the primary server but also supports configuring a search expiration time (**AD search timeout**) with a default value of 5 seconds.
* **Double authentication**: Users can choose whether to enable two-step authentication on their accounts. To learn more about how to enable two-step authentication on an account, you can read this [[:en:documentation:pandorafms:management_and_operation:12_console_setup#double_authentication|section]]. This functionality requires that the server and mobile devices have a synchronized and as accurate date and time as possible.
* In the event that there is a user password change, MS Windows® allows you to use an old password by default for 60 minutes in Active Directory. Being a Windows configuration, this behavior is totally foreign to Pandora FMS. If you wish to modify, you can consult the documentation at [[https://docs.microsoft.com/en-us/troubleshoot/windows-server/windows-security/new-setting-modifies-ntlm-network-authentication|Microsoft]] .
* **Domain**: Define the domain that the Active Directory will use.
* At this time a user's primary groups are not supported with advanced group settings in AD Authentication.
* If you are using **Advanced Configuration AD**, be sure to set the full path in the domain field (**Domain**).
* If the Active Directory installation is with LDAP, you must define here the LDAP path in which the server is located, generally:
ldap:addc.mydomain
=== LDAP ===
* In order to use this mode, it is necessary to have the openLDAP dependencies installed.
* Depending on the operating system used, the commands are used: ''yum install openldap*'' or ''apt install ldap-utils''
Important fields:
* **Fallback to local authentication**: If this option is enabled, a [[:en:documentation:pandorafms:management_and_operation:12_console_setup#local_pandora_fms|local authentication]] will be done if LDAP fails. Administrator users will always have fallback enabled, so as not to lose access to Pandora FMS in case of failure of the remote authentication system.
* **Automatically create remote users**: Enables or disables automatic creation of remote users. This option makes it possible for Pandora FMS to create users automatically once they have logged in using LDAP.
* **LDAP function**: When searching in LDAP, you can choose whether to use the native PHP function or use the local **ldapsearch** command. It is recommended to use the local command for those environments that have an LDAP with many elements.
**Advanced LDAP Config**
* If the option is activated, a list appears with all saved advanced permissions. You can add new permissions by selecting the profile, groups and tags, next to the attributes filter. If the user meets any of those attributes (for example, a specific organizational unit or group) then the user will be created.
* If this option is not activated, the simple system for creating user profiles is used (**Automatically create profile**, **Automatically create profile group**, **Automatically create profile tags**, **Automatically assigned no hierarchy** ).
Attributes must have the following format **Attribute_Name = Attribute_Value**
* **Enable secondary LDAP**: If you enable a secondary LDAP server as a backup, respective fields of the primary LDAP server will appear.
* **Double authentication**: Users will be able to choose whether to enable [[:en:documentation:pandorafms:management_and_operation:12_console_setup#double_authentication|two-step authentication on their accounts]]. This functionality requires that the server and mobile devices have a synchronized and as accurate date and time as possible.
=== Double authentication ===
Users will be able to choose whether to enable two-step authentication on their accounts.
To use this functionality, the administrator must activate double authentication in the authentication section of the global configuration of the Pandora FMS console. It will also be necessary to have the code generating application on a mobile device you own. To know where and how to download it:
[[https://support.google.com/accounts/answer/1066447|https://support.google.com/accounts/answer/1066447]]
This functionality requires that the server and mobile devices have a synchronized and as accurate date and time as possible.
**Force 2FA for all users is enabled**
Enabling this option will force all users to use two-step authentication.
To disable this functionality without using the graphical interface, [[:en:documentation:pandorafms:technical_reference:03_anexo_cli#disable_double_auth|an administrator can use the PFMS CLI]].
=== SAML ===
For SAML configuration, you can consult [[:en:documentation:pandorafms:technical_annexes:12_saml|this section]].
==== Performance ====
The **performance** of Pandora FMS is affected by various factors that must be refined in the following sections. Go to menu **Management** → **Setup** → **Setup** → **Performance**.
=== Database maintenance status ===
* **Pandora_db running in active database**: If ''pandora_db'' exceeds 12 hours without running, it will mark a critical state.
* **Pandora_db running in historical database** Only appears if there is a historical database configured; Likewise, if ''pandora_db'' exceeds 12 hours without running on the historical database, it will mark a critical state.
=== Database maintenance options ===
Menu **Management** → **Setup** → **Setup** → **Performance**.
* **Max. days before events are deleted**: Maximum number of days before events are deleted.
* **Max. days before traps are deleted**: Maximum number of days before deleting the [[:en:documentation:pandorafms:monitoring:08_snmp_traps_monitoring|SNMP traps]].
* **Max. days before audited events are deleted**: Maximum number of days before auditing events are deleted.
* **Max. days before string data is deleted**: Maximum number of days before data strings are deleted.
* **Max. days before GIS data is deleted**: Maximum number of days before GIS data is deleted.
* **Max. days before purge**: Maximum number of days before purging data. This also specifies the maximum number of days to maintain historical inventory data.
* **Max. days before data is compacted**: Maximum number of days before [[:en:documentation:pandorafms:complex_environments_and_optimization:09_pandorafms_engineering|compactardata]].
* **Max. days before unknown modules are deleted**: Maximum number of days before unknown modules are deleted [[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy|except if they are in a policy]].
* **Max. days before delete not initialized modules**: Maximum number of days before deleting uninitialized modules.
* **Max. days before autodisabled agents are deleted**: Number of days (default ''30'') from which **auto** disabled agents will be deleted.
* **Retention period of past special days**: Number of days from which special days that have already passed will be deleted.
* **Max. macro data fields **: Number of macros that can be used for [[:en:documentation:pandorafms:management_and_operation:01_alerts|alertas]].
* **Max. days before delete old messages**: Number of days from which received messages will be deleted.
* **Max. days before inventory data is deleted**: Number of days from which the data from [[:en:documentation:pandorafms:management_and_operation:04_inventory|inventario]] will be deleted.
* **Max. days before disabled agents are deleted**: Number of days from which disabled agents will be deleted (default ''0'', never).
=== Historical database maintenance options ===
These parameters will only appear if there is a history database configured in Pandora FMS.
* **Max. days before purge**: Maximum number of days before purging data.
* **Max. days before compact data**: Maximum number of days before compacting data.
* **Compact interpolation in hours (1 Fine-20 bad)**: It is the length of the compaction interval in hours, a value close to one is recommended. For example, a module with a 5-minute interval generates 288 values per day. If this interval is set to 2, the data will be grouped into 2 hour intervals and averaged, resulting in 12 values per day instead of 288. The higher this value, the lower the resolution.
* **Max. days before delete events**: Maximum number of days before deleting events.
* **Max. days before delete string dat**: Maximum number of days before deleting string data.
=== Others ===
* **Item limit for real-time reports**: Field where the maximum number of data that the graph will represent in real time is defined.
* **Limit of events per query**: To set a maximum limit on the number of events returned in a query.
* **Compact interpolation in hours (1 = fine / 20 = bad)**: It is the length of the compaction interval in hours.
* **Default hours for event view**: Field where the hours field of the default filter in the event view is defined. This field also affects the display, counting and graphing of events in the tactical view.
* **Use real-time statistics**: Enable or disable the use of real-time statistics.
* **Batch statistics period (secs)**: If real-time statistics are disabled, the refresh time for the statistics will be defined here.
* **Use agent access graph**: The agent access graph, renders the number of contacts per hour on a graph with a daily scale (24 hours). This is used to know the contact frequency of each agent. It may take a long time to process, so if you have low resources it is recommended to disable it.
* **Max. recommended number of files in attachment directory**: Maximum number of files that are stored in the ''attachment'' directory.
* **Delete not initialized modules**: Enables or disables deletion of uninitialized modules.
* **Big Operation Step to purge old data: **Number of blocks into which the ''pandora_manage.pl'' script divides a time interval. A higher value implies larger blocks of time, which means performing more but lighter operations. In overloaded systems and very large databases it may be advisable to increase this value even if purging the data takes more time.
* **Small Operation Step to purge old data**: Number of rows that ''pandora_manage.pl'' processes in a single SQL query. This means that for each block of time defined by the **Big Operation Step to purge old data** parameter, at most 1000 records will be purged with each query (using the default value). A larger value means larger queries, which means performing fewer automatic operations that heavier. In overloaded systems it may be advisable to reduce this value, although purging the data will take longer. The default and recommended value is 1000.
* **Graph container - Max. Items**: Field where the number of maximum items in the graph container view is defined.
* **Events response max. execution**: Field where the maximum number of events that can perform the massive Event Responses operation is defined.
* **Row limit in csv log**: Row limit for the log in CSV format.
* **SNMP walk binary** and **SNMP walk binary (fallback)**: When SNMP bulk walk is not able to request V1 SNMP, this option will be used instead (default ''snmpwalk'', slower ).
* **WMI binary**: Executable file to use in WMI queries, by default ''pandorawmic''.
* **Rows limit for SQL report item PDF**: Limit by default to a maximum of five thousand lines to avoid overloading the hardware capacities where the PFMS server is running. //If zero is set, it is set without any limit, use with caution//. In the case of the Command Center (Metaconsole) the sum of the value configured in each node will be displayed.
=== Default values for SNMP interface ===
To complete the SNMP configuration from the [[#others|previous section]], you can either set the default values to be used for the different modules in the [[:en:documentation:pandorafms:monitoring:03_remote_monitoring#pandora_fms_snmp_wizard|SNMP interface wizard]].
{{ :wiki:setup_performance_5.png }}
==== Visual styles ====
In this section you can configure all **visual elements** of Pandora FMS.
Go to menu **Management** → **Setup** → **Setup** → **Visual styles**.
=== Behaviour configuration ===
* **Block size for pagination**: Field where item pagination size (events, alerts, etc.) is chosen.
* **Paginated module view**: Activate pagination in the module list.
* **Display data of proc modules in other format**: **proc** type data represents binary states of a module. In the database they are collected as a number, but they could also be represented descriptively with an identifier for each of the two states. Activating this option uses this second form of representation.
* **Display text when proc modules are in OK status**: When the **Display data of proc modules in other format** option is activated, this text appears instead of the number when the module has an OK status.
* **Display text when proc modules are in critical status**: When the **Display data of proc modules in other format** option is enabled, this text appears instead of the number when the module is in a failed status.
* **Click to display lateral menus**: This parameter will configure whether the side menu is displayed when you click (main mouse button) on it or when you hover the mouse over it.
* **Service label font size**: Default font size for services.
* **Space between items in Service maps**: Distance (in pixels) between two service map items. To avoid overlapping, this value must be higher than 80 pixels.
* **Tabs menu**: By default it shows icons and context menu for the main view of the agents in the Web Console. The other two options (icons only or context menu only) combine both options if there is not enough screen space.
=== GIS configuration ===
* **GIS Labels**: Activate the labels with the agent name in the [[:en:documentation:pandorafms:monitoring:20_gis|GIS maps]]. It is advisable to disable this option when you have many agents on a map, this way it is more readable.
* **Default icon in GIS**: Default icon for agents on GIS maps.
=== Style configuration ===
Style settings for graphic elements:
{{ :wiki:visualconf1.png }}
Important notes:
* **Style template**: To [[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration#custom_themes|add new themes]] you must add a CSS file in the ''include/styles'' directory.
* **Status icon set**: In the case of users with color blindness, these can be replaced by other conceptual icons that allow the statuses to be differentiated in another way.
* **Custom favicon**: It must be in ''.ico'' format and its dimensions in 16 by 16 pixels for it to work correctly. You can add icons to choose from in the ''images/custom_favicon'' folder.
* **Custom documentation logo** and **Custom support logo**: Icon for the link to the documentation and support on the login screen. If left blank no icon will be seen. The path to upload more icons is ''enterprise/images/custom_general_logos/''.
* **Product name** and **Copyright notice**: By default, the product name is Pandora FMS, however the user is given the option to rebrand and change it to another text string and thus have a personalized version.
* **Background opacity % (login)**: Allows you to specify an opacity percentage (default 30%) on the login screen.
* **Disable helps**: Hide all Pandora FMS helps. This configuration option affects both the modal windows and the wizard and other links to the Pandora FMS documentation.
* **Fixed header**: The header is always shown, that is, it is not hidden when scrolling (vertical scrolling of the window).
* **Automatically hide sub-menu**: Activating this option minimizes the side menu.
* **Random background (login)**: If you do not have a wallpaper configured for the login screen (see **Custom background logo**), activating this option will randomly have one of several graphic files stored in:
…/pandora_console/images/backgrounds/random_backgrounds
The following alternative rebranding configuration tokens are stored as a comment (commented) in **config.php** to preserve the configuration in case of database failure.
----------Rebranding--------------------
Uncomment these lines and add your customs text and paths.
$config["custom_logo_login_alt"] ="login_logo.png";
$config["custom_splash_login_alt"] = "splash_image_default.png";
$config["custom_title1_login_alt"] = "WELCOME TO Pandora FMS";
$config["custom_title2_login_alt"] = "NEXT GENERATION";
$config["rb_product_name_alt"] = "Pandora FMS";
$config["custom_docs_url_alt"] = "http://pandorafms.com/manual/";
$config["custom_support_url_alt"] = "https://support.pandorafms.com";
=== Chart settings ===
Graphics settings:
{{ :wiki:pandora_console_15_02.png }}
Important notes:
* **Value to interface graphics**: Name of the units for interface graphics.
* **Data precision**: Number of decimal places to display in reports and visual consoles. It must be between 0 and 5.
* **Data precision in graphs**: Number of decimal places to display in the graphs. It must be between 0 and 5.
* **Number of elements in custom graph**: To limit the number of legends in combined graphs. Also consider decreasing the width of the legends, making them condensed and as short as possible. The combined graphs that respond to this token are of type:
* Line.
* Area.
* Vertical bars.
* Horizontal bars.
* Stacked or stacked.
* **Chart fit to content**: There are graphs whose values are percentages and the top of the graph exceeds the maximum value one hundred, you can configure the graphs so that they stop adding a proportional upper margin by activating this option.
* **Percentile**: Shows a line with the percentile indicated in the graphs. The default value is 95.
* **Graph TIP view**: This parameter indicates whether TIP graphs will be displayed.
* **None** (None): The TIP option of the graphics setup will be disabled (default option).
* **All** (All): The TIP option in the graph menu will be activated.
* **On Boolean graphs**: The TIP option will only be activated in the true and false type graphs menu.
=== Font and text settings ===
Letter and text font settings:
* **Graphs font size**: Field where you choose the font size used by Pandora FMS for the graphics.
* **Agent size text**: When the agent name is too long, in some sections of Pandora FMS the text is truncated showing only the first characters (default values: 18 characters when the font is small and 50 characters when it is normal size).
* **Module size text**: When the name of the modules is too long, in some sections of Pandora FMS the text is truncated, showing only the first characters (default values: 25 characters when the font is small and 50 characters when It is normal size).
* **Description size text**: When the description is too long, in some sections of Pandora FMS the text is truncated showing only the first characters (default value: 60 characters).
* **Item title size text**: When the title is too long, in some sections of Pandora FMS the text is truncated, showing only the first characters (default value: 45 characters).
* **Show unit along with value in reports**: Show units in addition to the module value in reports.
* **Truncate agent text at end** and **Truncate module text at end**: When activated, they cut the name of the agents and modules at the end and place three ellipses (the default behavior is to cut in half) for the **Operation → Monitoring → Views** section.
=== Visual console configuration ===
Visual console configuration:
* **Legacy Visual Console View**: If this token is activated, the visual consoles view will be kept in the original form. When disabled, it allows you to configure the token below.
* **Default cache expiration**: This section indicates how often the cache of the state of the elements is cleared and, therefore, how often each element's state is calculated individually.
* **Default interval for Visual Console to refresh**: This interval will only affect the visual console pages, establishing how often they will be automatically refreshed.
* **Type of view of visual consoles**: Drop-down to indicate whether you want the favorite visual consoles to be displayed in the menu.
* **Number of favorite visual consoles to show in the menu**: To avoid overlapping and help the performance of the Web Console, this token limits the number of favorite consoles to show in the side menu.
* **Default line width for the Visual Console**: Width of the line in the visual consoles. This option can be changed within the visual console itself individually for each line, but the default value is detailed here.
* **Mobile view not allow visual console orientation**: In the mobile console it prevents the screen from being rotated according to the motion sensor.
* **Display item frame on alert triggered**: Allows you to hide an orange box when you have an alert triggered in the **Static image**, **Simple value**, **Icon** and **Group elements ** of the [[:en:documentation:pandorafms:management_and_operation:05_data_presentation_visual_maps|Visual consoles]]. Enabled by default.
* **Visual console default text margin (em)**: By default 1 em, it allows to enlarge or reduce the text label margin in the Visual Consoles elements that use it (**Static image**, etc.).
=== Reports configuration ===
Configuration of [[:en:documentation:pandorafms:management_and_operation:08_data_presentation_reports|reports]]:
* **Show report info with description**: Description of custom report information. Applies to all reports and templates by default.
* **Front page for custom reports**: Front page for custom reports. Applies to all reports and templates by default.
* **PDF font size (px)**: Text font size, in pixels, for PDF files.
* **HTML font size for SLA (em)**: Font size for SLA reports (HTML only). It is in a relative measurement called **em** which is equivalent to the number of times the size of the chosen font in pixels.
* **Graph image height for HTML reports**: Height in pixels of module graphs or custom graphs in reports (HTML only).
* **Interval description**: Shows the description of the time interval in abbreviated form or not. A long description (**Long**) is, for example, "10 hours, 20 minutes, 33 seconds"; a short one (**Short**) is "10h 20m 33s".
=== Services configuration ===
**Number of favorite services to show in the menu**: Maximum number of favorite visual consoles that can be shown in the visual console submenu.
=== Other configuration ===
Other settings:
* **Network map max width**: Maximum width, in pixels, of the network map (adjust for each screen size).
* **Show only the name of the group**: The name of the group will be shown instead of its icon.
* **Show empty groups in group view**: Allows you to display empty groups in the group view.
* **Date format string**: Field where the [[https://www.php.net/manual/en/datetime.format.php|date and time format is defined as denoted by the PHP language]]; to add the timezone you must place ''T''.
* **Decimal separator**: Decimal separator to use in reports.
* **Timestamp, time comparison, or compact mode**: Defines what date and time is used, the system timestamp (**Timestamp in rollover**), a comparison with the database (**Rollover comparison **) or in a compact way (**Compact mode**). This is useful when the database is on a different system than where the Web console is located.
* **Custom value post processing**: Custom conversion values for post processing. Update a table in the database to have custom conversions from one unit to another. If you accidentally add an incorrect numeric value, select it from the **Delete custom values** list and delete it using the **Delete** button below and add the custom conversion value again.
* **Interval values**: Here you can customize the time values (seconds, minutes, etc.) that the **Interval** field will take in Pandora FMS forms.
* **Module units**: This option allows you to define the unit of the data that the modules will collect.
* **CSV divider**: Character or set of characters with which the data will be separated when exporting to CSV.
* **CSV decimal separator**: Symbol to use in the decimal separator when exporting to CSV.
* **Data multiplier to use in graphs/data**: Value by which the displayed data will be multiplied to represent them in the graphs. This is useful in the case where the unit of value is **bytes**; for other conversions use **Custom value post processing**.
==== NetFlow ====
For more information, see the topic "[[:en:documentation:pandorafms:monitoring:18_netflow|Network monitoring with NetFlow]]". Notable fields:
* **Data storage path**: Directory where NetFlow data is stored.
* **Daemon binary path**: Directory where the **nfcapd** program is stored.
* **Nfdump binary path**: Directory where the **nfdump** program is stored.
* **Nfexpire binary path**: Directory where the **nfexpire** program is stored.
* **Name resolution for the IP address**: Activate this parameter to resolve the address IP to obtain their hostnames. This process can take a long time to complete.
==== eHorus ====
By enabling the integration with eHorus you will have access to the configuration:
* **eHorus configuration at user level**: Allows you to configure the connection with eHorus at the user level. Disabled by default, if enabled the following fields **User** and **Password** will no longer be available in the configuration.
* **Test**: Press to perform a connectivity test
You can find more information about the integration with eHorus [[:en:documentation:pandorafms:management_and_operation:13_remotemanagement|in this section]]
==== Pandora ITSM ====
Allows you to enable the [[en:documentation:pandorafms:management_and_operation:14_incidence_management|connection and communication between Pandora FMS and Pandora ITSM]]. The activate button can be configured to be used for all users (default option enabled) or for each user to configure their own connection.
It is made up of three sections:
* **Pandora ITSM API settings**: The main section to configure allows the connection and transfer of data and information through the PITSM API.
* **Alert default values**: Configure default values for alerts.
* **Event custom response default values**: Configures the default response values for events.
=== Pandora ITSM API settings ===
Both the incoming connection for Pandora ITSM and the incoming connection for Pandora FMS must be configured to guarantee bidirectional communication.
* **URL to Pandora ITSM setup**: Web address or IP address to connect to the Pandora ITSM API, for example:
http://172.16.0.2/integria/api/v1
* **URL connect to API Pandora FMS**: URL to connect to the Pandora FMS API, by default it takes the one established in the **Public URL** token and if not the one in ''config.php'' is established.
* **Test** buttons: Each one will test the connection from Pandora FMS to Pandora ITSM and vice versa.
* If the connection tests are successful, Pandora ITSM will take the PFMS agents and convert them into inventory objects and PITSM incident management will be available from PFMS.
=== Alert default values ===
In this section called **Default values for alerts**, the default parameters will be established to register incidents in Pandora ITSM from the **alerts** generated in Pandora FMS. All fields refer to Pandora ITSM and the connection must have been configured first according to the **Pandora ITSM API settings** section.
=== Event custom response default values ===
In this section called **Default values for events**, the default parameters will be established to register incidents in Pandora ITSM from the **events** generated in Pandora FMS. All fields refer to Pandora ITSM and the connection must have been configured first according to the **Pandora ITSM API settings** section.
==== Module Library ====
This option allows you to save the credentials to access the [[https://pandorafms.com/library/|Pandora FMS Library]] directly from the Console.
==== Notifications ====
In Pandora FMS there is a **notification** and monitoring system for the status of the console and the system in general. You can enable notifications by following the instructions in the [[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration|Console Management]] section.
==== QuickShell ====
From version 774 onwards, Pandora FMS QuickShell feature was upgraded and for its proper functioning, it will be necessary to have the **pandora_gotty** binary installed in ''/usr/bin/''. This feature is installed by default in version 774 of Pandora FMS and the only additional configuration will be to allow the connection to the installed firewall and add port number ''8080''.
If you are upgrading to PFMS version 774, see the migration process to ''pandora_gotty'': "[[:en:documentation:pandorafms:management_and_operation:12_console_setup#update_to_the_version_774|Upgrade to version 774]]".
=== QuickShell Settings ===
In menu **Management → Setup → QuickShell → GoTTY general parameters,** in the **Address** field, enter the IP address or URL of PFMS Web Console and the port number to use (remember to allow connection in the corresponding firewall). Save the values by clicking on **Update** (saving forces QuickShell to be run).
Connection can be enabled through SSH (**Enable SSH method**) and/or Telnet (**Enable telnet method**), when configuring the desired values, save with the **Update** button (when saving, it forces QuickShell to be run). The connection can then be tested and verified with the corresponding **Test** buttons.
=== Optional QuickShell configuration with safe methods ===
If you have SSL certificates, it is advisable to encrypt conection transmission to strengthen computer security.
Before proceeding to encrypt communications (**Use SSL** corresponding to SSH and/or Telnet) the following configurations must first be made:
* You must have [[:en:documentation:pandorafms:technical_annexes:15_security_architecture#implementacion_general_de_security|SSL certificates]] in Pandora FMS Web Console
* These certificates must have reading permissions for the Apache web server.
* Add the following TLS/SSL options to the file ''/etc/pandora_gotty/pandora_gotty.conf'' (replace the path and file name for each parameter with the values to use):
Pandora Gotty config file
(…)
[bool] Enable TLS/SSL
enable_tls = true
[string] Default TLS certificate file path
tls_crt_file = "/path/.cert.crt"
[string] Default TLS key file path
tls_key_file = "/path/key.key"
[bool] Enable client certificate authentication
enable_tls_client_auth = false
[string] Certificate file of CA for client certificates
tls_ca_crt_file = "/path/ca_cert.ca.crt"
(…)
Again in the menu **Management → Setup → QuickShell → GoTTY general parameters** in the **Address** field, enter the IP address or URL that matches the added values, check **Use SSL** for SSH and/or or Telnet and save by clicking **Update** (saving forces QuickShell to run). The connection can then be tested and verified with the corresponding **Test** buttons.
{{ :wiki:pfms-management-setup-setup-quickshell.png }}
=== Update to version 774 ===
* The WebSocket service on the PFMS server to be updated must be stopped and then disabled.
* Stop the old **gotty** process. The following command identifies it and stops it:
kill $(ps aux | grep gotty | awk '{print $2}')
* To verify that it stopped running:
ps aux | grep -v grep | grep gotty
* Download and install the **pandora_gotty** package:
* For Ubuntu server:
[[https://firefly.pandorafms.com/ubuntu/pandora_gotty_1.1.0.deb|https://firefly.pandorafms.com/ubuntu/pandora_gotty_1.1.0.deb]]
* For EL 7 / EL 8:
[[https://firefly.pandorafms.com/centos8/pandora_gotty-1.1-1.el8.x86_64.rpm|https://firefly.pandorafms.com/centos8/pandora_gotty-1.1-1.el8.x86_64.rpm]]
* Configure Quickshell in [[:en:documentation:pandorafms:management_and_operation:12_console_setup#quickshell_configuration|PFMS web console]]. When performing the update, the connection must be enabled through SSH (option **Enable SSH method**) and/or Telnet (option **Enable telnet method**), when configuring the desired values, save with the **Update button ** (saving forces QuickShell to run). The connection can then be tested and verified with the corresponding **Test** buttons.
==== External tools ====
In the **external tools** section you can configure the alarm sounds for them, in addition to the default paths of their executable files. You can also define your own custom commands using macros to interact with Pandora FMS agents.
==== Welcome tips ====
Menu **Management** → **Setup** → **Setup** → **Welcome tips**.
Tips are short messages, whether or not accompanied by a web link to further details of the tip displayed when you log in to the PFMS Web Console. You can set the language for each of them and to edit them, it has a filter that allows you to search by keyword in the title of each tip. Each user will be able to establish their own user configuration with the **Show usage tips at startup** token.
Through the [[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration|classification of Profiles established read in PFMS]] you can configure the welcome tips in the drop-down list in **Profile,** depending on the profile allowed to each user, they may or may not view them.
* Add one or more related images as long as their size is 464 by 260 pixels.
* Each tip may or may not be enabled to be viewed.
==== Demo data ====
Menu **Management → Setup → Setup → Demo data**.
This option allows to generate a minimum of 30 agents with demonstrative data and with default values assigned. It is possible that it may increase the parameter value ''plugin_timeout'' in the server configuration so that all agent data are updated.
By checking on **Advanced options** the following parameters may be adjusted:
* **Agents interval**: Five minutes, default value.
* **Generate historical data for all agents**: By being enabled, history data will be generated for the agents to be created, with the amount of days specified in field **Days of historical data to insert in the agent data** (15 days by default).
* **Create services**: It allows to create [[:en:documentation:pandorafms:monitoring:07_services|services]].
* **Create network maps**: It allows to create [[:es:documentation:pandorafms:management_and_operation:06_data_presentation_network_maps|network maps]].
* **Create GIS maps**: It allows to create [[:en:documentation:pandorafms:monitoring:20_gis|geolocation maps]]
* **Create custom graphs**: Itallows to create [[:en:documentation:pandorafms:management_and_operation:07_data_presentation_visualization|custom graphs]].
* **Create reports**: It allows to create [[:en:documentation:pandorafms:management_and_operation:08_data_presentation_reports|reports]].
* **Create visual consoles**: It allows to create [[:en:documentation:pandorafms:management_and_operation:05_data_presentation_visual_maps|visual consoles]]
* **Create dashboards**: It allows to create [[:en:documentation:pandorafms:management_and_operation:09_dashboard|dashboards]].
* **Traps target IP**: IP address for [[:en:documentation:pandorafms:monitoring:08_snmp_traps_monitoring|SNMP traps]] (''127.0.0.1'' by default). //All demonstration SNMP traps are generated with version 1//.
* **Traps community**: Community for **SNMP traps** (''public'' by default).
* **Tentacle target IP**: IP address for data forwarding through the [[:en:documentation:pandorafms:technical_reference:09_tentacle|Tentacle protocol]] (''127.0.0.1'' by default).
* **Tentacle port**: Port number for the Tentacle protocol (''41121'' by default).
* **Tentacle extra options**: [[:en:documentation:pandorafms:technical_reference:09_tentacle#ejemplos_de_uso_de_tentacle|Tentacle protocol parameters]].
A server plugin must be enabled in the environment for generated agent data to be updated periodically.
By clicking on **Create demo data** all chosen options will be entered, while the demo environment is generated you may see a progress bas the creation status of each type of element once completed. According to the number of agents selected, it may take more or less time.
Later you may delete all those data with the button **Delete all demo data**.
==== GIS map connection ====
All documentation on GIS maps can be found in the section [[:en:documentation:pandorafms:monitoring:20_gis|Pandora FMS GIS]].
==== License ====
Once you have installed Pandora FMS you can perform [[:en:documentation:pandorafms:installation:01_installing|the application of a license]]. Then in this section you can find out its status, request a validation (**Validate** button) in the case of reinstalling a Pandora FMS instance or request a new license (**Request new license** button). . In the **Show agent usage detail** button you can see the total number of agents (with the option to filter by enabled agents) as well as the subtotals classified into three large categories.
If the **Satellite** server option is active, a license encryption key can be configured (**License encryption key**) that will guarantee the secure transmission of said token to the Satellite server. This same key will need to be [[:en:documentation:pandorafms:complex_environments_and_optimization:05_satellite|configured on the Satellite server]].
The server is installed with a trial license valid for a maximum of 100 agents and one month of use. If you wish to expand this license, contact your trusted sales representative or fill out the following [[https://pandorafms.com/es/contactar/|contact form]].
==== Translate string ====
Go to the side menu and click **Setup** → **Translate string**. You can make your custom translations (**Customize translation** column) even with macro variables; This extension is fully described in the section [[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration|Translate string]].
===== Admin tools =====
==== System audit log ====
Menu **Management** → **Admin tools** → **System Audit Log**
Pandora FMS keeps a record or log of all important changes and actions produced in the Pandora FMS Console. You can get more information in the section [[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration#auditory_log|Audit log]].
==== Links ====
From **Management** → **Admin tools** → **Links** you can access the web links management page of the Pandora FMS console.
Both to create a new web link and to update an existing one, the process is practically the same. Once you have edited and/or added all the necessary web links you will always have them at hand in the left side menu.
==== Diagnostic info ====
Access through **Management** → **Admin tools** → **Diagnostic info** the visual tool that shows the current status of the Pandora FMS server and console. If you want to obtain this information via the command line, see [[:en:documentation:pandorafms:complex_environments_and_optimization:08_optimization#diagnostic_info|Pandora FMS Optimization and Troubleshooting]]. There is the option to export all the information in PDF.
==== IPAM ====
With the IPAM extension you can manage the IP addresses of the networks. You can get more information in the section [[:en:documentation:pandorafms:monitoring:11_ipam|IPAM: IP Address Management]].
==== Site news ====
From **Management** → **Admin tools** → **Site news** it is possible to add the news that appears on the home page when a user enters the console.
To create a news item press **Add**, write the subject or title in **Subject**, select the group that will receive the announcement and the deadline to be shown. If you select **Modal window** the news will be displayed in a pop-up that the user must read and close.
==== File Manager ====
Useful tool to upload content to Pandora FMS, menu **Manage** → **Admin tools** → **File Manager** . The entire contents of the ''images'' folder within the Pandora FMS installation will be displayed.
* Download the files you want by clicking on the name of each one of them.
* Navigate through the directories, these are identified with the icon {{:wiki:icon_directory.png}}. You can also create subdirectories in them.
* Upload files by clicking on the icon {{:wiki:icon_upload_file.png?21x21}}, these image files will be identified with the icon {{:wiki:icon_image.png?23x23|File}}(only formats are allowed GIF, PNG and JPG).
* You can also delete some files that have the icon {{:wiki:icon_trash.png?nolink&32x32}}, since the rest are system files used by the PFMS Console.
* **A directory can only be deleted if it is empty.**
* **If you want to customize the [[:en:documentation:pandorafms:management_and_operation:05_data_presentation_visual_maps#static_image|images in the Visual Consoles]]**, four different images are needed, one for each state, using a special nomenclature for these images: < image_name>_.png where the state can be:
* < image_name >**_bad.png**
* < image_name >**_ok.png**
* < image_name >**_warning.png**
* < image_name >**.png** (no state)
Keep in mind that if the compressed file you upload contains a structure of directories and subdirectories with the files in each of them, said structure will also be created in ''/var/www/html/pandora_console/images/'' .
==== DB Schema Check ====
This check can only be performed on MySQL Databases.
This is an extension that allows you to check the structural differences between the established Pandora FMS database, and a pattern scheme to compare possible errors. See the section "[[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration#db_schema_check|Console management and administration]]".
==== DB Interface ====
This is an extension that allows you to run commands on the database and see the result. It is an advanced tool that should only be used by people who know SQL and the Pandora FMS database schema in sufficient detail.
==== DB Backup Manager ====
Allows you to manage scheduled database backups using a Console task ("[[:en:documentation:pandorafms:monitoring:17_discovery_2|Console Task]]").
* In the **Filter** section you can choose from the drop-down list in **Path backups** the location of the available backups. Press the **Filter** button to update the backup list.
* You can download the backups to your local machine using the corresponding {{:wiki:icon_download.png?21x21}}button.
* You can delete backups using the corresponding {{:wiki:icon_trash.png?21x21}}button.
* To restore a backup press the corresponding {{:wiki:icon_restore.png?21x21}}button.
==== OpenSearch Interface ====
To activate the **[[en:documentation:pandorafms:technical_annexes:38_opensearch_installation|OpenSearch]]** interface the token **Activate Log Collector** must be enabled in **Management → Setup → Setup → Setup → Log collector**.
==== Acoustic console setup ====
Allows you to configure the default sounds for the different [[:en:documentation:pandorafms:management_and_operation:01_alerts|event alarms]].
==== API checker ====
The **API checker** allows you to call and check the Pandora FMS external API. See the [[:en:documentation:pandorafms:technical_reference:02_annex_externalapi#api_checker|External API section]].
==== Extension manager ====
=== Extension manager view ===
Extensions are a way to develop new functionality for the Pandora FMS console, as well as plugins. See the topic [[:en:documentation:pandorafms:technical_reference:07_anexo_console_extensions_development|Developing console extensions]] for more information.
From the menu **Admin tools** → **Extension manager** → **Extension manager view** you can disable by clicking on the icon {{:wiki:icon_lightbulb.png}}corresponding to each extension.
You can also delete an extension with the corresponding {{:wiki:icon_trash.png}}button. Managing extensions **of visible type** adds or removes elements in the left side menu.
=== Extension uploader ===
From the menu **Management** → **Admin tools** → **Extension manager** → **Extension uploader view** you can upload an [[:en:documentation:pandorafms:management_and_operation:12_console_setup#extension_manager|extension]]. The file must be compressed in ''.zip'' format. If the extension [[:en:documentation:pandorafms:technical_reference:07_anexo_console_extensions_development#administration|uses the]] ''gpolicies'' component, check the **Upload Enterprise extension** option. Once you have chosen the file, click the **Upload** button.
=== System logfiles ===
In the menu **Management** → **Admin tools** → **Extension manager** → **System logfiles** it can be viewed, limited to the size of the token **Log size limit in system logs viewer extension** ([[:en:documentation:pandorafms:management_and_operation:12_console_setup#general_setup|General setup]]), the content of the following files:
/var/www/html/pandora_console/log/console.log
/var/log/pandora/pandora_server.log
/var/log/pandora/pandora_server.error
=== CSV import group ===
See the section [[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration|Import groups from CSV]] in “Console management and administration” .
===== Resources =====
==== Operating systems ====
In this section you may edit or create new types of Operating System (OS), **Management** → **Resources** → **Operating systems**. These groups are important for automatic agent provisioning.
Starting with version 774, PFMS has the scheduled obsolescence feature enabled, which works with [[:en:documentation:pandorafms:management_and_operation:04_inventory|inventory]] to obtain reports with filters for monitored devices.
{{ :wiki:pfms-management-resources-operating_systems-list_of_version_expiration_dates.png }}
If you have a new operating system, you can add it to the default list when installing PFMS. To do this, click on the **Create OS** button, enter the corresponding name and choose an icon from the list. If you have a new icon in JPG, JPEG, PNG or SVG format, use the **Upload icon** button, store it in PFMS and then search and select it by name. The process is finished with the **Create** button.
{{ :wiki:pfms-management-resources-operating_systems-upload_icon.png }}
===== Tools =====
==== Export data ====
The menu **Management → Tools → Export data** allows you to choose an agent (which can be filtered by group) by its name and then select one more modules from it. By default, the time period is the last 24 hours and the available export formats are:
* **Data Table**: A special PHP language format that displays the agent name, module name, data value and date and time of data collection.
* **Average per hour/day**: If the data is numeric and can be averaged, it will be displayed on the screen in a similar way to the Data table option.
* **CSV**: File in comma delimited fields format.
* **MS Excel**: Spreadsheet file, format for Microsoft Excel.
==== File repository manager ====
The file repository manager allows you to add the resources you need to be downloaded by the devices to be monitored when appropriate. It can be accessed from **Management → Admin tools → Extension manager → File repository** or from **Management → Tools → Tools → File repository** and then click on the **Management view** icon.
Select the group(s) that will download this resource and browse your local disk to //upload// this file. If you need to make this resource public, check the **Public link** box. Click the **Add** button and wait for the //upload// process to complete.
* To share the public link of each file click on the icon {{:wiki:icon_world.png?nolink&21x21}}, copy and paste the web link.
* If another operator of the same PFMS Console is on another computer, you will be able to download it by clicking on the button {{:wiki:icon_download.png?nolink&21x21}}.
* If the file is no longer needed, delete it with the button {{:wiki:icon_trash.png?nolink&32x32}}.
[[:en:documentation:start|Return to Pandora FMS documentation index]]