============
CENGINE CFG
============

Overview
--------

Object name: **ENGINECFG**

Show
----

In order to list available Centreon Engine conf, use the **SHOW** action::

  [root@centreon ~]# ./centreon -u admin -p centreon -o ENGINECFG -a show 
  id;name;instance;comment
  1;Centreon Engine CFG 1;Central;Default CentreonEngine.cfg
  [...]

Columns are the following :

======= ===============================================
Order	Description
======= ===============================================
1	Centreon Engine ID

2	Centreon Engine configuration name

3	Instance that is linked to centreon-engine.cfg

4	Comments regarding the configuration file
======= ===============================================

Add
---

In order to add a Centreon Engine conf, use the **ADD** action::

  [root@centreon ~]# ./centreon -u admin -p centreon -o ENGINECFG -a add -v "Centreon Engine cfg for poller NY;Poller-NY;Just a small comment" 

Required fields are:

======== ================================================
Order	 Description
======== ================================================
1	 Centreon Engine configuration name

2	 Instance that is linked to centreon-engine.cfg

3	 Comment regarding the configuration file
======== ================================================


Del
---

If you want to remove a Centreon Engine conf, use the **DEL** action. The name is used for identifying the configuration to delete::

  [root@centreon ~]# ./centreon -u admin -p centreon -o ENGINECFG -a del -v "Centreon Engine cfg for poller NY" 


Setparam
--------

If you want to change a specific parameter of a Centreon Engine conf, use the **SETPARAM** action. The name is used for identifying the configuration to update::

  [root@centreon ~]# ./centreon -u admin -p centreon -o ENGINECFG -a setparam -v "Centreon Engine cfg for poller NY;cfg_dir;/usr/local/nagios/etc" 

Arguments are composed of the following columns:

======= =====================================
Order	Column description
======= =====================================
1	Name of Centreon Engine configuration

2	Parameter name

3	Parameter value
======= =====================================

Parameters that you may change are:

================ =============================================================================================================================
Column	         Description
================ =============================================================================================================================
nagios_name	         Name

instance	 Instance that is linked to centreon-engine.cfg

broker_module	 example: [...] -v "Engine CFG NY;broker_module;/usr/lib64/nagios/cbmod.so /etc/centreon-broker/central-module.xml", 
                 you can use a | delimiter for defining multiple broker modules

nagios_activate	 *1* if activated, *0* otherwise

*	         Centreon CLAPI handles pretty much all the options available in a centreon-engine configuration file. 
                 Because the list is quite long, it is best to refer to the official documentation of Centreon Engine
================ =============================================================================================================================


Addbrokermodule
---------------

If you want to add new broker module without removing existing modules, use the **ADDBROKERMODULE**::
  [root@centreon ~]# ./centreon -u admin -p centreon -o ENGINECFG -a addbrokermodule -v "Centreon Engine cfg for poller NY;/usr/lib64/centreon-engine/externalcmd.so"


Arguments are composed of the following columns:

======= =====================================
Order	Column description
======= =====================================
1	Name of Centreon Engine configuration

2	Module name
======= =====================================

To add multiple modules in one line, it will put the separator "|" between the name of the modules::
  [root@centreon ~]# ./centreon -u admin -p centreon -o ENGINECFG -a addbrokermodule -v "Centreon Engine cfg for poller NY;/usr/lib64/centreon-engine/externalcmd.so|/etc/centreon-broker/central-module.xml"


Delbrokermodule
---------------

If you want to delete broker module, use the **DELBROKERMODULE**::
  [root@centreon ~]# ./centreon -u admin -p centreon -o ENGINECFG -a delbrokermodule -v "Centreon Engine cfg for poller NY;/usr/lib64/centreon-engine/externalcmd.so"


Arguments are composed of the following columns:

======= =====================================
Order	Column description
======= =====================================
1	Name of Centreon Engine configuration

2	Module name
======= =====================================

To delete multiple modules in one line, it will put the separator "|" between the name of the modules::
  [root@centreon ~]# ./centreon -u admin -p centreon -o ENGINECFG -a delbrokermodule -v "Centreon Engine cfg for poller NY;/usr/lib64/centreon-engine/externalcmd.so|/etc/centreon-broker/central-module.xml"
