====== Operation ======
{{indexmenu_n>6}}
===== Centralised management =====
==== Agent management ====
**Agent management**{{:wiki:gm_agent_icon_command_center.png?nolink&21x21}}
In the case of having two nodes or more, probably, and for several reasons, it will be necessary for an agent to be in a specific node. Agent management allows relocating them from one node to another.
Group and/or name filters are used to locate and select agents that need to be moved to another node. The **Discard history data** option allows you to delete history data to save storage space in the database. Click **Move** to save the changes.
**Provisioning management**{{:wiki:write_paper_icon_command_center.png?nolink&21x21}}
The **Command Center** (Metaconsole) is able to sort and assign the arrival of new software agents assigned to its charge. The following criteria are used:
* **Round robin**: It is used to distribute, in an equitable way and in a rational order, all the new Pandora FMS software agents that arrive to the Command Center. Agent distribution will be done in a circular way, assigning the corresponding server to each new agent.
* **Less loaded**: New agents will be dynamically assigned to the least loaded servers.
* **Custom**: In custom classification, you may define classification rules, based on certain parameters retrieved from the information reported by the agent (agent name and IP address).
**Agent autoconfiguration**{{:wiki:book_edit_icon_command_center.png?nolink&21x21}}
It allows adding and/or editing new automatic configuration rules for agents, such as group membership, alerts, etc. See section "[[:en:documentation:pandorafms:installation:05_configuration_agents#ks7|Automatic agent configuration]]" to find out how it works together with each node.
**Group management**{{:wiki:group_icon_command_center.png?nolink&21x21}}
It allows editing or deleting agent groups in all nodes.
Editing or deleting groups may cause problems with synchronization.
**Tree group**{{:wiki:gm_massive_operations_icon_command_center.png?nolink&21x21}}
Like **Group management**, this option allows you to edit or delete agent groups in all nodes with the difference that the graphical interface is in the form of a tree.
Editing or deleting groups may cause problems with synchronization.
**Collections**{{:wiki:collection_icon_command_center.png?nolink&21x21}}
[[:en:documentation:pandorafms:technical_annexes:28_pfms_file_collections|File collections]] are containers of remote and local files constantly synchronizez. They are generally used in agents or to massively deploy scripts or plugins that will later be run by software agents.
==== Module management ====
**Component groups**{{:wiki:module_group_icon_command_center.png?nolink&21x21}}
It allows to create, edit and delete [[:en:documentation:pandorafms:management_and_operation:03_templates_and_components#ks7|component groups]] in nodes.
**Local components**{{:wiki:database_mc_icon_command_center.png?nolink&21x21}}
It allows to create, edit and delete [[:en:documentation:pandorafms:management_and_operation:03_templates_and_components#ks3|local components]] centrally.
**Network components**{{:wiki:network_mc_icon_command_center.png?nolink&21x21}}
It allows adding, modifying or deleting [[:en:documentation:pandorafms:management_and_operation:03_templates_and_components#ks2|network components]] on nodes.
**Plugin management**{{:wiki:plugin_mc_icon_command_center.png?nolink&21x21}}
In [[:en:documentation:pandorafms:technical_reference:11_pfms_plugis|plugin]] management, it is possible to create, edit and delete these resources for nodes in a centralized way.
**Inventory modules**{{:wiki:op_inventory_icon_command_center.png?nolink&21x21}}
Use the centralized option of [[:en:documentation:pandorafms:management_and_operation:04_inventory#ks2_1|inventory modules]] to create, modify or delete this component on the nodes.
**Plugin registration**{{:wiki:label-settings_icon_command_center.png?nolink&21x21}}
It allows adding server plugins. See the [[:en:documentation:pandorafms:management_and_operation:12_console_setup#ks1_12|component library]] of Pandora FMS or the [[:en:documentation:pandorafms:technical_reference:05_anexo_server_plugins_development|creation of such components]].
==== Alert management ====
**Templates**{{:wiki:alerts_template_icon_command_center.png?nolink&21x21}}
It allows creating, copying and deleting [[:en:documentation:pandorafms:management_and_operation:01_alerts#ks4|alert templates]]. By expanding the **Show options** option you may filter alert templates by type (**Type**) or template name (**Search**).
**Actions**{{:wiki:alerts_action_icon_command_center.png?nolink&21x21}}
To create, copy, edit and delete [[:en:documentation:pandorafms:management_and_operation:01_alerts#ks3|alert actions]] for nodes. By expanding by clicking **Show Options** you will be able to search, by key text, action name (**Search**) and/or by agent groups (**Group**) and/or alert command (**Command**).
**Commands**{{:wiki:alerts_command_icon_command_center.png?nolink&21x21}}
This section allows you to add, copy and delete [[:en:documentation:pandorafms:management_and_operation:01_alerts#ks2_2|alert commands]] centrally. //It should be noted that there are system alert commands that can neither be copied nor deleted.//**Calendar**{{:wiki:calendar_view_day_icon_command_center.png?nolink&21x21}}
[[:en:documentation:pandorafms:technical_annexes:26_pfms_list_of_special_days|Calendars]] are used in alert templates to mark special days and periodic monitoring cycles and routines. To edit the default calendar, click on the icon {{:wiki:icon_config.png?nolink&21x21}}. To add special days use the icon {{:wiki:icon_plus.png?nolink&21x21}}. You may also create your own calendars with the button **Create**.
**Builder alert**{{:wiki:edit_icon.png?nolink&21x21}}
In a centralized way, it is possible to [[:en:documentation:pandorafms:management_and_operation:01_alerts#ks6|create alerts]] in each one of the agents of the instances.
==== Component management ====
**Tags management**{{:wiki:tag_icon_command_center.png?nolink&21x21}}
It displays a list of [[:en:documentation:pandorafms:monitoring:01_intro_monitoring#ks3_3_2|tags]] used in modules and their count for all nodes. In the **Actions** column you may modify or delete tags. In **Show options** you may filter the list by name or description.
To add new tags click **Create tag**.
**Module groups management**{{:wiki:module_group_icon_command_center.png?nolink&21x21}}
For managing module groups.
You may delete a module group with the corresponding {{:wiki:icon_trash.png?nolink&21x21}}icon, to edit it, click on the name (under the **Name** column). With the **Create module group** button a new module group may be added.
**OS Management**{{:wiki:operating_system_icon_command_center.png?nolink&21x21}}
Pandora FMS manages a [[:en:documentation:pandorafms:management_and_operation:12_console_setup#ks3_1|basic list of operating systems]] to be assigned to agents. Some of them are system operating systems and cannot be deleted, but they can be edited by clicking on their corresponding name (**Name** column). To add the other operating systems needed, click **Create OS**.
==== User management ====
**User management** {{:wiki:gm_users_icon_command_center.png?nolink&21x21}}
A complete listing is available for nodes and their users. You may filter by the group to which the users belong or enter a keyword in the text box to search by user name, full user name or by email registered in PFMS.
In each user listed, in the actions column:
* To disable a user, click on the icon {{:wiki:disable_icon_command_center.svg?nolink&21x21}}.
* Click on the {{:wiki:edit_icon_command_center.svg?nolink&21x21}}icon to edit a user's data (or user name).
* To delete a user, click on the corresponding icon {{:wiki:delete_icon_command_center.svg?nolink&21x21}}. You must always have at least one //superuser// registered and active and this user cannot be deleted.
* To create a new user, click **Create user**. If you need the new user to also have access through the instances, activate the **Enable node access** option.
**Profile management** {{:wiki:profiles_icon_command_center.png?nolink&21x21}}
For full administration of [[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration#ks1_3|user profiles]].
**Edit my user** {{:wiki:op_workspace_icon_command_center.png?nolink&21x21}}
By using this section you may [[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration#ks1_1_1|edit the logged-in user data]] in the Command Center.
**API 2.0 token management** {{:wiki:setup-password_icon_command_center.svg?nolink&21x21}}
For managing user authentication tokens on the [[:en:documentation:pandorafms:technical_reference:02_annex_externalapi#ks1|API 2.0 PFMS]].
==== Policy management ====
The **Command Center** has a centralized management mode. This means that, regarding [[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy|monitoring policies]], management is done from the Command Center and it is disabled in nodes. In the Command Center, this mode is selected from the general settings.
For the configured nodes to adopt the centralized mode, go to the license screen and synchronize. That way, all the policy management pages will be available in read-only mode. New nodes that are added will be automatically configured in this mode.
If a node is in centralized mode, a warning message will appear in the policy view.
{{ :wiki:07_policies_centralised.png }}
**Policy queue in the Command Center**
The policy queue in the Command Center is different from those of the nodes. While in the latter you may see the status of the application of uncompleted policies and a history of those already completed, in the Command Center this second part was deleted. **Only those that have not been applied or are in progress will be displayed, indicating the node they belong to**.
If the history of applied monitoring policies needs to be checked, this will be available on the node. In fact, //it is the only thing that can be managed from the node,// since all other pages are in read-only mode.
**Data integrity**
The data that the nodes and the Command Center have for each policy has to be the same: modules, alerts, inventory modules, collections… all these have to be consistent. Therefore, when applying a policy from the Command Center, all this data is copied to the nodes involved.
This information is very varied and very sensitive. An error may take place when copying the data. In this case, the console will display an error and the node will rollback the data previously stored. In new installations, this will be no problem, but it is advisable to delete the previous policy configurations made manually in the nodes, placing them on the Command Center to later synchronize them from there.
==== Category management ====
It allows module categories (advanced options) to be managed centrally for nodes.
* To edit a module category, click on the icon {{:wiki:icon_config.png?nolink&21x21}}.
* Clicking on the corresponding {{:wiki:icon_trash.png?nolink&21x21}}icon deletes a module category.
* To create a new module category, click **Create category**.
==== Server management ====
It provides information about the type, status, version, etc., of the servers in the Command Center. To find out the status of PFMS servers on the nodes, select each of them from the list of registered instances (**Centralised management → Server management → Show server status of**).
==== Bulk operations ====
**Agent operations**
To perform [[:en:documentation:pandorafms:complex_environments_and_optimization:01_massive_operations#ks1|mass operations on agents]]. Through the list in **Node** you could select the node to apply mass changes on its corresponding agents.
* By default in **Action** mass agent deletion is selected.
* Tou may also mass edit agents.
When editing agents in bulk, the fields left blank (**No change** label) will remain unchanged.
**Bulk user operations**
To perform [[:en:documentation:pandorafms:complex_environments_and_optimization:01_massive_operations#ks4|mass user modifications]].
When editing users in bulk, fields left blank(**No change**) will remain unchanged.
==== Merging Tool ====
From Pandora FMS version 756, the synchronization system for environments with centralized mode has been redesigned from scratch, making it faster and more efficient, since changes will be replicated to nodes automatically, without the need for manual synchronization that was done until now.
This change **replaces the previous system** in disuse, so that in environments where it was active, it will be necessary to go through the automatic merging system to use the new centralization system to guarantee data integrity.
When upgrading, all already centralized Command Center environments will be forced to go through the new **Merging tool** section located in **Centralised managament** in order to be centralized again correctly.
For Command Center installation, and everything related to it, [[:en:documentation:pandorafms:command_center:04_command|visit the topic completely devoted to it]].
===== Extensions =====
==== DB interface ====
This extension allows you to run commands in the database and see the result. It is an advanced tool that should only be used by people who know SQL and Pandora FMS database schema in enough detail.
Through the Command Center you will be able to query both the database and each and every one of its nodes by choosing an option in **Select query target**.
==== CSV group import ====
This extension allows you to import a file with records (whose fields are separated by commas '','' or by another character that you may choose from the **Separator** list) and that define groups, to Pandora FMS server.
Choose the file to be imported by clicking on **Select a file**, the separator character (by default the comma) and click **Go**. The CSV file must contain the following fields in the following order:
Group name, icon, group id //parent//, propagation (''1'' yes or ''0'' no).
==== Cron Jobs ====
It allows periodic execution in the Command Center of operations such as sending logs in CSV format or executing PHP code.
{{ :wiki:pfms-metaconsole-extensions-cron_jobs.png }}
In the actions column there are three icons for editing, deleting or disabling the corresponding task, and the **Create** button may be used to add jobs to the periodic execution list.
==== System audit log ====
Pandora FMS keeps control and registry of the following operations in the Command Center:
* [[#ks1_7|Category management]].
* [[#ks1_5|User registration]].
* System events (service starts, [[#ks2_3|cron]], etc.) and query errors by the [[#ks2_1|DB Interface]].
* Node modifications from the Command Center.
* Module management (creation, failed registrations, et cetera).
* Monitoring policy management.
* Changes in the general configuration.
You will be able to save and edit the filter preferences to be loaded at any other time.
[[:en:documentation:start|Back to Pandora FMS Documentation Index]]