diff --git a/doc/en/administration_guide/02e.rst b/doc/en/administration_guide/02e.rst index 750c149ec9438ba13b7778ff918681b50f01f680..e97d8915758178fc0d5e19747efbace36a195697 100644 --- a/doc/en/administration_guide/02e.rst +++ b/doc/en/administration_guide/02e.rst @@ -1,4 +1,5 @@ .. _centreon_parameters: + =============================================== Administration options of the Centreon platform =============================================== diff --git a/doc/en/exploitation_guide/03stats.rst b/doc/en/administration_guide/03stats.rst similarity index 100% rename from doc/en/exploitation_guide/03stats.rst rename to doc/en/administration_guide/03stats.rst diff --git a/doc/en/administration_guide/backup.rst b/doc/en/administration_guide/backup.rst index 6462fd6d08c15a2bf821e1e45eae632e18a3b177..67f1b71301eee7c3fe39822162361bc0b57bb725 100644 --- a/doc/en/administration_guide/backup.rst +++ b/doc/en/administration_guide/backup.rst @@ -59,7 +59,7 @@ This part covers the configuration of centreon-backup. The following window is displayed: .. image:: /images/guide_exploitation/backup.png -:align: center + :align: center * **Backup enabled** Enable/Disable backup * **Backup directory** Directory where backup will be stored @@ -79,18 +79,16 @@ The following window is displayed: * **Remote directory** Remote directory for SCP export .. warning:: - **Temporary directory** can not be a folder of **Backup directory**. - ********************************** Restore of Centreon central server ********************************** Restore process is divided in two main steps: -* Re-install the Centreon platform following the installation documentation. Do not forget to upgrade system. -* Restore Centreon-Engines configuration files and Centreon databases +* Re-install the Centreon platform following the installation documentation. Do not forget to upgrade system. +* Restore Centreon-Engines configuration files and Centreon databases Configurations file restore =========================== @@ -120,13 +118,13 @@ Once Centreon server reinstalled (**same Centreon version**), unzip centreon and # gzip -d YYYY-MM-DD-centreon_storage.sql.gz # mysql centreon_storage < YYYY-MM-DD-centreon_storage.sql -.. note:: -Password is stored in configuration files previously restored. For example **$mysql_passwd** field in file "/etc/centreon/conf.pm". +This may take a while due to the size of "centreon_storage" databases. -Chis may take a while due to the size of "centreon_storage" databases. +.. note:: + Password is stored in configuration files previously restored. For example **$mysql_passwd** field in file "/etc/centreon/conf.pm". .. note:: -The default configuration does not define any password for mysql root user. That's why we can connect to database using only command "mysql". + The default configuration does not define any password for mysql root user. That's why we can connect to database using only command "mysql". SSH keys restore ================ @@ -150,7 +148,7 @@ Connection test from central to poller:: Answer "Yes" to the ask question. This is about add poller print on the central server. .. note:: -You have to do this operations only if you work with a distributed environment. + You have to do this operations only if you work with a distributed environment. Plugins restore =============== @@ -189,7 +187,7 @@ In case you're using NRPE or NSCA agents, you have to reinstall and then restore # cp nsca.cfg /etc/centreon-engine/ .. note:: -You have to do this only if you're using the monitoring agents. + You have to do this only if you're using the monitoring agents. Generate Centreon-Engine configuration files within centreon ============================================================ diff --git a/doc/en/administration_guide/index.rst b/doc/en/administration_guide/index.rst index 3761091b62ee525bf86e8af2fde274dd0a842473..932588f6dbe47020878026d475115da9c5ea3e27 100644 --- a/doc/en/administration_guide/index.rst +++ b/doc/en/administration_guide/index.rst @@ -8,13 +8,11 @@ Administration :maxdepth: 2 :glob: - 02a 02b 02c 02d 02e 02f - 02g 02h 02i 02j @@ -22,3 +20,4 @@ Administration 02l backup partitioning/index + 03stats diff --git a/doc/en/administration_guide/partitioning/index.rst b/doc/en/administration_guide/partitioning/index.rst index 3c3abca5f6147985dd8f5c2dfdc06fdc3f58c526..40953504143c3a2502e2fc6ca061449433a5957f 100644 --- a/doc/en/administration_guide/partitioning/index.rst +++ b/doc/en/administration_guide/partitioning/index.rst @@ -68,6 +68,5 @@ Contents: .. toctree:: :maxdepth: 2 - prerequisite/index user/index diff --git a/doc/en/api/clapi/objects/engine_cfg.rst b/doc/en/api/clapi/objects/engine_cfg.rst index 9dc2b441e17432313731f93cff682703c866d6ef..d4d365873a92f594e6aa7a28129160f50f139fc0 100644 --- a/doc/en/api/clapi/objects/engine_cfg.rst +++ b/doc/en/api/clapi/objects/engine_cfg.rst @@ -29,8 +29,7 @@ Order Description 3 Instance that is linked to centreon-engine.cfg 4 Comments regarding the configuration file -======= ============================================== - +======= =============================================== Add --- diff --git a/doc/en/api/clapi/objects/index.rst b/doc/en/api/clapi/objects/index.rst index 78800fe021d2c4f55939a15d3e7e351e8ef10c5c..5ff15e93fb1601efab259666546504c267c1e54c 100644 --- a/doc/en/api/clapi/objects/index.rst +++ b/doc/en/api/clapi/objects/index.rst @@ -10,13 +10,13 @@ Object management acl_menu acl_resource broker_cfg - cgi_cfg commands contacts contact_templates contact_groups dependencies downtimes + engine_cfg host_templates hosts host_categories @@ -24,9 +24,6 @@ Object management host_group_services instances ldap_servers - nagios_cfg - ndo2db_cfg - ndomod_cfg resource_cfg service_templates services diff --git a/doc/en/api/clapi/objects/service_templates.rst b/doc/en/api/clapi/objects/service_templates.rst index 6e1325463fe308b4173f3bae82a824a118014128..1af945a1ac9c99a0227eed7f91902b9163e49227 100644 --- a/doc/en/api/clapi/objects/service_templates.rst +++ b/doc/en/api/clapi/objects/service_templates.rst @@ -150,7 +150,7 @@ first_notification_delay First notification delay in seconds recovery_notification_delay Recovery notification delay -parallelize_checks 1 when parallelize checks are enabled, 0 otherwise +parallelize_check 1 when parallelize checks are enabled, 0 otherwise obsess_over_service 1 when obsess over service is enabled, 0 otherwise @@ -198,7 +198,7 @@ service_notification_options Notification options (w,u,c,r,f,s) .. note:: You need to generate your configuration file and restart monitoring engine in order to apply changes. -.. _addhosttemplate-and-sethosttemplate +.. _addhosttemplate-and-sethosttemplate: Addhosttemplate and Sethosttemplate ----------------------------------- diff --git a/doc/en/api/restApi/index.rst b/doc/en/api/restApi/index.rst deleted file mode 100644 index e6c13e6b3b01fcd2e193fd1a0862e1070dfda72f..0000000000000000000000000000000000000000 --- a/doc/en/api/restApi/index.rst +++ /dev/null @@ -1,17 +0,0 @@ -======== -Rest API -======== - -The Rest API is a Centreon API that enables users to configure their monitoring system through HTTP. - -This documentation aims to introduce all the actions you can perform with Centreon CLAPI, from adding host objects to restarting a remote monitoring poller. - -Contents: - -.. toctree:: - :maxdepth: 1 - - overview - engine_management - objects/index - import_export.rst diff --git a/doc/en/configuration_guide/advanced_configuration/macros.rst b/doc/en/configuration_guide/advanced_configuration/macros.rst index a7740f3959f106ba2cf021b252793d8f09276ffa..c0e829ae79a4aa62422f9617fef02bd896270dda 100644 --- a/doc/en/configuration_guide/advanced_configuration/macros.rst +++ b/doc/en/configuration_guide/advanced_configuration/macros.rst @@ -36,6 +36,7 @@ There are several advantages to using customised macros instead of arguments: * The function of the macro is defined in its name. The macro $_HOSTMOTDEPASSEINTRANET$ is easier to read than $ARG1$ * The macros inherit models of hosts and of services, the hence it is possible to modify a single macro for a host or a service. On the other hand, the arguments all need to be redefined if a single argument is changed * The number of arguments is limited to 32, unlike customised macros which are unlimited + A macro of a host is used to define a variable that is specific to the host and which will not change regardless of the service questioned: host connection identifiers, a port of connection to a particular service, an SNMP community, etc. A macro of a service is used more to define settings specific to a service: a WARNING / CRITICAL threshold, a partition to be questioned, etc. diff --git a/doc/en/configuration_guide/advanced_configuration/metaservices.rst b/doc/en/configuration_guide/advanced_configuration/metaservices.rst index 3424579f4d187c6b00fefce159efe9ccd155fd43..660db931a812f70c465803cd4ca02cf3ab6f6e96 100644 --- a/doc/en/configuration_guide/advanced_configuration/metaservices.rst +++ b/doc/en/configuration_guide/advanced_configuration/metaservices.rst @@ -102,6 +102,7 @@ If you have chosen the option **Service list**, in the screen containing all the * The **Host** field serves to select the host to which the service to be selected belongs. * The **Service** field serves to choose the service (first list) as well as the metric in this service (second list). * The **Status** and **Comment** fields serve to enable / disable or comment on the indicator. + 3. Repeat the operation until you have added all the indicators necessary for the calculation of the meta-service. .. note:: diff --git a/doc/en/configuration_guide/category.rst b/doc/en/configuration_guide/category.rst index 5fb52c59d661231355d5245aeb2e18d5bee735c5..49c54538ff704f6938b9a989be47e51e4ba0df25 100644 --- a/doc/en/configuration_guide/category.rst +++ b/doc/en/configuration_guide/category.rst @@ -28,6 +28,8 @@ To add a category of hosts: * The **Level** and **Icon** fields define a criticality level and an associated icon respectively. * The **Status** and **Comment** fields allow us to enable or disable the category of host and to comment on it. +.. _servicecategory: + ********************** Categories of services ********************** diff --git a/doc/en/configuration_guide/imp/index.rst b/doc/en/configuration_guide/imp/index.rst index 7f60a198e57735016a65868fe8b3904a362534c1..aa5a04553a4f4db9c907e0aeea5006ee75258abe 100644 --- a/doc/en/configuration_guide/imp/index.rst +++ b/doc/en/configuration_guide/imp/index.rst @@ -113,7 +113,7 @@ Your account is now available. You can link your Centreon platform. .. image:: /_static/images/configuration/website/create_account_05.png :width: 1000 px - :align: center + :align: center 2. Link your Centreon platform ------------------------------ diff --git a/doc/en/configuration_guide/poller/03wizards.rst b/doc/en/configuration_guide/poller/03wizards.rst index 8a461e6e74fc386dbbb58b7c6521bd31b8625899..36cc22b901104853588c96cf2607a2fccb3115fc 100644 --- a/doc/en/configuration_guide/poller/03wizards.rst +++ b/doc/en/configuration_guide/poller/03wizards.rst @@ -42,9 +42,6 @@ Configuration of a poller for a distributed architecture :align: center :alt: Schema distributed monitoring -.. note:: - :alt: Schema distributed monitoring - #. Choose **Simple poller** #. Enter a name for the configuration #. Select a poller diff --git a/doc/en/developer/index.rst b/doc/en/developer/index.rst index 9c988ad0ae0017842e979403f147510700c0395b..99631e8ff35142c05a9bc1a6072128525e9cedac 100644 --- a/doc/en/developer/index.rst +++ b/doc/en/developer/index.rst @@ -7,4 +7,3 @@ Developer writemodule writewidget - develop-a-plugin.rst diff --git a/doc/en/exploitation_guide/general/index.rst b/doc/en/exploitation_guide/general/index.rst index 019c01a94c700b627efd0d395157f8d4f28900c6..e2ceef923efb31be00d56bcfef163c4eefd261da 100644 --- a/doc/en/exploitation_guide/general/index.rst +++ b/doc/en/exploitation_guide/general/index.rst @@ -1,5 +1,3 @@ -.. _configuration_start: - ####### General ####### diff --git a/doc/en/exploitation_guide/monitoring/index.rst b/doc/en/exploitation_guide/monitoring/index.rst deleted file mode 100644 index 0286c77a7a6cc157ce8839bfb4bdee7db56fe6e7..0000000000000000000000000000000000000000 --- a/doc/en/exploitation_guide/monitoring/index.rst +++ /dev/null @@ -1,12 +0,0 @@ -========== -Monitoring -========== - -.. toctree:: - :maxdepth: 2 - :glob: - - 01customview - 03stats - 04realtime - 05logs diff --git a/doc/en/extendcentreon/index.rst b/doc/en/extendcentreon/index.rst deleted file mode 100644 index af04996ef82db445cea79ed251e397f0f9b67d13..0000000000000000000000000000000000000000 --- a/doc/en/extendcentreon/index.rst +++ /dev/null @@ -1,11 +0,0 @@ -=============================================== -Comment développer des extensions pour Centreon -=============================================== - -Ce chapitre est une reprise sans traduction de la documentation anglaise. - -.. toctree:: - :maxdepth: 2 - - writemodule - writewidget diff --git a/doc/en/extendcentreon/writemodule.rst b/doc/en/extendcentreon/writemodule.rst deleted file mode 100644 index 1d2a2e1330bcefc2a89348ac709cab5bcc67dbb9..0000000000000000000000000000000000000000 --- a/doc/en/extendcentreon/writemodule.rst +++ /dev/null @@ -1,132 +0,0 @@ -===================== -How to write a module -===================== - -You want to create a new module for Centreon 2 or to adapt an existing -one? You're at the right place! - -You should know Centreon contains a page dedicated to the installation -and the uninstallation of modules (*Administration > Modules*). To -make the module appears on this page, its directory must be placed -inside Cetreon's ``modules/`` directory. Example:: - - /usr/local/centreon/www/modules/module-Dummy - - An empty module template can be found inside `Centreon's repository - <http://svn.centreon.com/trunk/module-Dummy>`_. - - ***** - Basis - ***** - - The essential elements your module's directory must contain are presented below (\* = required): - - **[conf.php]\***:: - - // Short module's name. Must be equal to your module's directory name - $module_conf['dummy']['name'] = "dummy"; - // Full module's name - $module_conf['dummy']['rname'] = "Dummy Module"; - // Module's version - $module_conf['dummy']['mod_release'] = "2.0"; - // Additional information - $module_conf['dummy']['infos'] = "First of all"; - // Allow your module to be uninstalled - $module_conf['dummy']['is_removeable'] = "1"; - // Module author's name - $module_conf['dummy']['author'] = "Centreon Team"; - // 1: the module executes an SQL file for installation and/or uninstallation - // 0: the module doesn't execute any SQL file - $module_conf['dummy']['sql_files'] = "1"; - // 1: the module executes a PHP file for installation and/or uninstallation - // 0: the module doesn't execute any SQL file - $module_conf['dummy']['php_files'] = "1"; - -**[infos > infos.txt]** - -This file can contain various information about your module. - -**[php > install.php]** - -This PHP file is executed at module installation if it is configured -inside the *conf.php* file. - -**[php > uninstall.php]** - -This PHP file is executed at module uninstallation if it is configured -inside the *conf.php* file. - -**[sql > install.sql]** - -This SQL file is executed during the module installation if it is -configured inside the *conf.php* file. If you want your module to be -available from Centreon menus, you must insert new entries into the -``topology`` table of the ``centreon`` database. An example is -available inside the ``Dummy`` module. - -**[sql > uninstall.sql]** - -This SQL file is executed during the module uninstallation if it is -configured inside the *conf.php* file. It can also remove your module -from Centreon menus. - -**[generate_files > \*.php]** - -The PHP files contained inside the ``generate_files`` directory will -be executed during the configuration files generation (inside -*Configuration > Monitoring Engines*). Those files must generate -configuration files. - -**[UPGRADE > dummy-x.x > sql > upgrade.sql]** - -Centreon provides an upgrade system for modules. To use it, just add a -directory under ``UPGRADE`` named using the following pattern: -``<module name>-<version>``. When clicking on the upgrade button, -Centreon will search for scripts to execute, following the logical -order of versions. - -For example, if the version 1.0 of the dummy module is installed and -the following directories exist:: - - $ ls UPGRADE - dummy-1.1 dummy-1.2 - -Centreon will execute the scripts in the following order : 1.1, 1.2. A -configuration file in each upgrade directory is present in order to -allow (or not) the execution. - -You're free to organize the remaining files (your module's content) as -you like. - -******** -Advanced -******** - -That's great, you know how to install a module! As an empty module is -not really usefull, put your imagination at work. Knowing that you can -do almost everything, it should not be too complicated :-). - -Connecting to the database -========================== - -You can use the ``centreon``, ``centstorage`` and ``ndo`` databases by -calling the following file: ``centreon/www/class/centreonDB.class.php``. - -For example, execute requests like this: - -.. sourcecode:: php - - <? - $pearDB = new CentreonDB(); - $pearDB->query("SELECT * FROM host"); - ?> - -Existing functions -================== - -You can access most of the functions already developed within Centreon -using ``include()`` statements. They're generally stored in -``centreon/www/class/``. - -Before developing your own function, check the existing code, it could -spare your time! diff --git a/doc/en/extendcentreon/writewidget.rst b/doc/en/extendcentreon/writewidget.rst deleted file mode 100644 index c892f8cf0b9759ddd0a08ab5b52bd82310f1c533..0000000000000000000000000000000000000000 --- a/doc/en/extendcentreon/writewidget.rst +++ /dev/null @@ -1,253 +0,0 @@ -===================== -How to write a widget -===================== - -Centreon (since version 2.4) offers a custom view system which allows -user to view one or different widgets in the same page : *Home > -Custom views*. - -You may have specific needs that are not yet covered by our widget -catalog and this tutorial will explain to you how to write your first -widget for Centreon. - -*********************************** -Should I make a widget or a module? -*********************************** - -If you are wondering if you should be making a module or a widget, -then ask yourself if your project is meant to contain many menus or is -it rather a plain page which is going to display little information? - -Of course, you could make a widget that would only work with a certain -module. - -******************* -Directory structure -******************* - -Widgets work pretty much like Modules. They have to be placed in -the following directory:: - - # centreon/www/widgets/nameOfYourWidget/ - -Your widget must contain one mandatory file named **configs.xml** at its root. - -****************** -Configuration file -****************** - -This is the XML configuration file of our Dummy widget: - -.. code-block:: xml - - <configs> - <title>Dummy</title> - <author>Centreon</author> - <email>contact@centreon.com</email> - <website>http://www.centreon.com</website> - <description>Dummy widget</description> - <version>1.0.3</version> - <keywords>dummy, widget, centreon</keywords> - <screenshot></screenshot> - <thumbnail>./widgets/dummy/resources/logoCentreon.png</thumbnail> - <url>./widgets/dummy/index.php</url> - <autoRefresh></autoRefresh> - <preferences> - <preference label="text preference" name="text preference" defaultValue="default value" type="text"/> - <preference label="boolean preference" name="boolean preference" defaultValue="1" type="boolean"/> - <preference label="date" name="date" defaultValue="" type="date"/> - <preference label="host preference" name="host preference" defaultValue="" type="host"/> - <preference label="list preference" name="list preference" defaultValue="none" type="list"> - <option value="all" label="all"/> - <option value="none" label="none"/> - </preference> - <preference label="range preference" name="range preference" defaultValue="5" type="range" min="0" max="50" step="5"/> - <preference label="host search" name="host search" defaultValue="notlike _Module_%" type="compare"/> - </preferences> - </configs> - -Now, let's see what these tags refer to. - -Basic tags -========== - -\* = Mandatory tag - -============== ================================================================ -Tag nameDescription -============== ================================================================ -title* Title of your widget - -author* Your name - -email Your email address - -website URL of your project - -description* Short description of your widget - -version* Version of your widget. Increment this number whenever you - publish a new version. - -keywords A few key words that describe your widget - -screenshot Screenshot that shows the best side of your widget. Screenshot - should be placed within your widget directory. - -thumbnail Logo of your project. Best size is 100px x 25px. Thumbnail - shoud be placed within your widget directory. - -url* Path of the main page of your widget - -autorefresh This parameter is not implemented yet -============== ================================================================ - -Parameter attributes -==================== - -\* = *Mandatory parameter* - -====================== ======================================================== -Tag attributes Description -====================== ======================================================== -label* Label of the parameter - -name* Name of the parameter that will be used for retrieving - its value - -defaultValue* Default Value of the parameter - -requirePermission Value can be "1" or "0". When set to 1, this parameter - will not be shown to unauthorized users. - -type* Parameter type, must be one of the following: - text,boolean,date,list,range,compare,host,hostgroup, - hostTemplate,servicegroup,serviceTemplate - -min* For range type only. It refers to the minimum value - of the range parameter - -max* For range type only. It refers to the maximum value - of the range parameter - -step* For range type only. It refers to the step value of - the range parameter -====================== ======================================================== - -Parameter type -============== - -====================== ======================================================== -Type name Description -====================== ======================================================== -text Renders a text input element - -boolean Renders a checkbox - -date Renders two text input elements. One for the date of - start, the other one for the date of end. - -list Renders a selectbox. The selectbox will be populated - with the option tags which have to be defined within the - preference tag. - -range Renders a selectbox which will be populated with values - depending on the min, max and step definitions. - -compare Renders a selectbox and a text input. Selectbox will - contain SQL operands such as:: - - > : greater than - < : less than - >= : greater or equal - <= : less or equal - = : equal - != : not equal - LIKE : can be used with the wildcard %% - NOT LIKE : can be used with the wildcard %% - -host Renders a selectbox populated with a list of hosts. - -hostgroup Renders a selectbox populated with a list of hostgroups. - -hostTemplate Renders a selectbox populated with a list of host - templates. - -servicegroup Renders a selectbox populated with a list of - servicegroups. - -serviceTemplate Renders a selectbox populated with a list of service - templates. -====================== ======================================================== - -The preference window would look like this as a result: - -.. image:: /_static/images/extending/pref_dummy_widget.png - :align: center - -**** -Code -**** - -All langages are separated in differents files, one file for each langage. The file "configs.xml" call the php's file and the php's file call html's file etc... - -We use Smarty, it's an engine and template'php compiler (http://smarty.net). - - -To use Smarty you need to : - -.. source-code:: php - - require_once $centreon_path . 'GPL_LIB/Smarty/libs/Smarty.class.php'; - -1.configuration of smarty: - -.. source-code:: php - - $path = $centreon_path . "www/widgets/Dummy/src/"; - $template = new Smarty(); - $template = initSmartyTplForPopup($path, $template, "./", $centreon_path); - -2.creating php template to be use in html: - -.. source-code:: php - - $template->assign('widgetId', $widgetId); - $template->assign('autoRefresh', $autoRefresh); - $template->assign('data', $data); - -3.affectation of html's file to execute: - -.. source-code:: php - - $template->display('dummy.ihtml'); - - -To call template php's variable in the html look dummy.ihtml - -To do request in database: - -initialization of databases's centreon, centreon storage and recovering preferences: - -.. sourcecode:: php - - try { - global $pearDB; - - $db_centreon = new CentreonDB("centreon"); - $db = new CentreonDB("centstorage"); - $pearDB = $db_centreon; - - $widgetObj = new CentreonWidget($centreon, $db_centreon); - $preferences = $widgetObj->getWidgetPreferences($widgetId); - $autoRefresh = 0; - if (isset($preferences['refresh_interval'])) { - $autoRefresh = $preferences['refresh_interval']; - } - } catch (Exception $e) { - echo $e->getMessage() . "<br/>"; - exit; - } - -then request in database with class' methods. - diff --git a/doc/en/installation/from_centreon.rst b/doc/en/installation/from_centreon.rst index 1a890ea3a4e80121fed66a972878a8a5b25add6b..ee4219e670cdfb09a9cb0fd27ea74b8703ed55fe 100644 --- a/doc/en/installation/from_centreon.rst +++ b/doc/en/installation/from_centreon.rst @@ -262,7 +262,7 @@ Centreon IMP needs the technical components Centreon License Manager and Centreon Plugin Pack Manager to work. Install packages ----------------- +================ When using Centreon ISO, installation of Centreon Plugin Pack Manager is very easy. You'll see that Centreon License Manager will be installed too @@ -273,7 +273,7 @@ as a dependency. $ yum install centreon-pp-manager Web install ------------ +=========== Once the packages installed, you need to enable the module in Centreon. So get to the Administration -> Extensions -> Modules page. diff --git a/doc/en/installation/from_packages.rst b/doc/en/installation/from_packages.rst index ec26ea73180917b00f2c9b2772eb54417c13d007..a500dca9488b9fc5605eb5269c01e7ca1ad80cc9 100644 --- a/doc/en/installation/from_packages.rst +++ b/doc/en/installation/from_packages.rst @@ -17,7 +17,7 @@ To install Centreon software from the repository, you should first install the f Perform the following command from a user with sufficient rights. Centreon Repository --------------- +------------------- For CentOS 6. @@ -189,41 +189,43 @@ Web Installation The End of installation wizard of Centreon is displayed, click on **Next**. -.. image :: /images/user/acentreonwelcome.png +.. image:: /images/user/acentreonwelcome.png :align: center :scale: 85% The End of installation wizard of Centreon checks the availability of the modules, click on **Next**. -.. image :: /images/user/acentreoncheckmodules.png +.. image:: /images/user/acentreoncheckmodules.png :align: center :scale: 85% Click on **Next**. -.. image :: /images/user/amonitoringengine2.png +.. image:: /images/user/amonitoringengine2.png :align: center :scale: 85% Click on **Next**. -.. image :: /images/user/abrokerinfo2.png +.. image:: /images/user/abrokerinfo2.png :align: center :scale: 85% Define the data concerning the admin user, click on **Next**. -.. image :: /images/user/aadmininfo.png +.. image:: /images/user/aadmininfo.png :align: center :scale: 85% By default, the ‘localhost’ server is defined and the root password is empty. If you use a remote database server, these two data entries must be changed. In our box, we only need to define a password for the user accessing the Centreon databases, i.e. ‘Centreon’, click on **Next**. -.. image :: /images/user/adbinfo.png +.. image:: /images/user/adbinfo.png :align: center :scale: 85% -If the following error message appears: **Add innodb_file_per_table=1 in my.cnf file under the [mysqld] section and restart MySQL Server.** Perform the following operation: +If the following error message appears: **Add innodb_file_per_table=1 in my.cnf file under the [mysqld] section and restart MySQL Server.** + +Perform the following operation: 1. Log-on to the ‘root’ user on your server @@ -235,8 +237,6 @@ If the following error message appears: **Add innodb_file_per_table=1 in my.cnf 3. Add these lines to the file -.. raw:: latex - :: [mysqld] @@ -252,7 +252,7 @@ If the following error message appears: **Add innodb_file_per_table=1 in my.cnf The End of installation wizard configures the databases, click on **Next**. -.. image :: /images/user/adbconf.png +.. image:: /images/user/adbconf.png :align: center :scale: 85% @@ -260,13 +260,13 @@ The installation is finished, click on Finish. At this stage a publicity allows to know the latest Centreon . If your platform is connected to the Internet you have the latest information , if the information present in this version will be offered. -.. image :: /images/user/aendinstall.png +.. image:: /images/user/aendinstall.png :align: center :scale: 85% You can now log in. -.. image :: /images/user/aconnection.png +.. image:: /images/user/aconnection.png :align: center :scale: 85% @@ -286,6 +286,7 @@ To start monitoring engine : :: service cbd start + 8. Start Centreon Engine :: @@ -306,7 +307,7 @@ Introduction to the web interface Centreon web interface is made up of several menus, each menu has a specific function: -.. image :: /images/user/amenu.png +.. image:: /images/user/amenu.png :align: center | diff --git a/doc/en/installation/from_sources.rst b/doc/en/installation/from_sources.rst index 41d666e74eb5f5cb68be69220b991a93cb250d78..2ebad55b6a40bc067086966824e68391c5362eef 100644 --- a/doc/en/installation/from_sources.rst +++ b/doc/en/installation/from_sources.rst @@ -148,7 +148,7 @@ Install this Stream Multiplexers before continuing with the installation. Centreon ******** -Download the latest version of Centreon :ref:`here <https://download.centreon.com>`. +Download the latest version of Centreon `here <https://download.centreon.com>`_. Shell Installation @@ -238,7 +238,7 @@ Answer [y] to all the questions. Definition of installation paths --------------------------------- + -------------------------------- :: @@ -323,7 +323,7 @@ Monitoring user --------------- This is the user used to run the monitoring engine (Centreon Engine). If you followed the -`official installation procedure <https://documentation.centreon.com/docs/centreon-engine/en/latest/installation/index.html#using-sources>`_ +`Centreon Engine official installation procedure <https://documentation.centreon.com/docs/centreon-engine/en/latest/installation/index.html#using-sources>`_ the user will likely be *centreon-engine*. :: @@ -333,7 +333,7 @@ the user will likely be *centreon-engine*. > This is the user used to run the stream broker (Centreon Broker). If you followed the -`official installation procedure <https://documentation.centreon.com/docs/centreon-broker/en/3.0/installation/index.html#using-sources>`_ +`Centreon Broker official installation procedure <https://documentation.centreon.com/docs/centreon-broker/en/3.0/installation/index.html#using-sources>`_ the user will likely be *centreon-broker*. :: @@ -681,7 +681,7 @@ SELinux should be disabled; for this, you have to modify the file "/etc/sysconfi :: - SELINUX=disabled + SELINUX=disabled After saving the file, please reboot your operating system to apply the changes. @@ -689,7 +689,7 @@ PHP timezone should be set; go to /etc/php.d directory and create a file named p :: - date.timezone = Europe/Paris + date.timezone = Europe/Paris After saving the file, please don't forget to restart apache server. diff --git a/doc/en/installation/index.rst b/doc/en/installation/index.rst index b302d93befafde7fbeee35941e99fc6840cfe3dd..f4acef31076cedcd8ab480d8397bc5d1dccf4b1e 100644 --- a/doc/en/installation/index.rst +++ b/doc/en/installation/index.rst @@ -16,7 +16,6 @@ Finally, you can install the platform. prerequisites architecture/index - installation/index downloads from_centreon from_packages diff --git a/doc/en/installation/prerequisites.rst b/doc/en/installation/prerequisites.rst index a619078048645e6cc17075e5732a746b5c3b30e6..53e4e4ce7e5fd981e60e0de9fbe677a168d4ce0d 100644 --- a/doc/en/installation/prerequisites.rst +++ b/doc/en/installation/prerequisites.rst @@ -63,6 +63,7 @@ The following table describes the dependent software: +----------+------------------+ | zlib | 1.2.3 | +----------+------------------+ + *************************** Select type of architecture *************************** diff --git a/doc/en/life_cycle.rst b/doc/en/life_cycle.rst index a666777572907353e50baf103626c92af173d147..3be8c0f5820716a35b776426d9e646931a23bd2a 100644 --- a/doc/en/life_cycle.rst +++ b/doc/en/life_cycle.rst @@ -29,7 +29,7 @@ This rule aims to provide operational support for around 2 years. +-----------------+---------------------------------------------------------+ | | Help and support non guaranteed |br| | | UNSUPPORTED | No fix(es) delivery | -| | | +| | | +-----------------+---------------------------------------------------------+ |br|\ diff --git a/doc/en/migration/index.rst b/doc/en/migration/index.rst index 4611bd0bcc8b5154e5b0b33431a844e9c984938e..6ad1d60ee8d66d5aad0bb6327369249f6e005076 100644 --- a/doc/en/migration/index.rst +++ b/doc/en/migration/index.rst @@ -1,5 +1,3 @@ -.. _install: - ################################# Migration from Nagios to Centreon ################################# diff --git a/doc/en/quick_start/add_host.rst b/doc/en/quick_start/add_host.rst index 313d6ea0f49ede10912c69685d918d508646bfc8..770d20cc2d67d355c19b044f07cdc27fa6c44fd1 100644 --- a/doc/en/quick_start/add_host.rst +++ b/doc/en/quick_start/add_host.rst @@ -1,4 +1,5 @@ .. _add_host: + ========== Add a host ========== diff --git a/doc/en/quick_start/add_host_from_template.rst b/doc/en/quick_start/add_host_from_template.rst index 38be38b8b7ba6514e54def107e675febea79b729..93d1c08b32c25bd677132d0414d0fe599b4a3491 100644 --- a/doc/en/quick_start/add_host_from_template.rst +++ b/doc/en/quick_start/add_host_from_template.rst @@ -1,4 +1,5 @@ .. _add_host_template: + ============================= Deploy a host from a template ============================= diff --git a/doc/en/quick_start/login.rst b/doc/en/quick_start/login.rst index 760db8e72e457ee840a0109848862a99dcc52e25..ef3a6654d079bc34e743a7324b1fe78c9609dee2 100644 --- a/doc/en/quick_start/login.rst +++ b/doc/en/quick_start/login.rst @@ -1,4 +1,5 @@ .. _centreon_login: + ===== Login ===== diff --git a/doc/en/release_notes/centreon-2.4/index.rst b/doc/en/release_notes/centreon-2.4/index.rst index 9a1d16d40775ba14dce91c70864b29a4f71ab550..b93ad0a3b1c8f2aa280c84d91e0915f4ea1aeda5 100644 --- a/doc/en/release_notes/centreon-2.4/index.rst +++ b/doc/en/release_notes/centreon-2.4/index.rst @@ -9,7 +9,6 @@ Please find here the release notes dedicated to the last 2.4.x version of Centre centreon-2.4.5 centreon-2.4.4 - centreon-2.4.2 centreon-2.4.1 centreon-2.4.0 diff --git a/doc/en/release_notes/centreon-2.5/centreon-2.5.1.rst b/doc/en/release_notes/centreon-2.5/centreon-2.5.1.rst index 05d1d86a6ac7b700b550e3819bc64394801e13d4..b90b9b17f3ed290d56e34450ef7baaf6a96aa809 100644 --- a/doc/en/release_notes/centreon-2.5/centreon-2.5.1.rst +++ b/doc/en/release_notes/centreon-2.5/centreon-2.5.1.rst @@ -8,9 +8,9 @@ WARNING If you are upgrading from Centreon 2.5.0 make sure to read the following. -.. DANGER:: -If you are upgrading from a version prior to 2.5.0, just skip this notice and follow this procedure instead: -`https://blog.centreon.com/centreon-2-5-0-release/ <https://blog.centreon.com/centreon-2-5-0-release/>`_. +.. WARNING:: + If you are upgrading from a version prior to 2.5.0, just skip this notice and follow this procedure instead: + `https://blog.centreon.com/centreon-2-5-0-release/ <https://blog.centreon.com/centreon-2-5-0-release/>`_. As usual, database backups are to be made before going any further. @@ -21,7 +21,7 @@ the size of your log tables. You are using NDOUtils ********************** -If you are using NDOUtils, chances are that you have plenty of duplicate entries in your log table. Follow the procedure in order to re insert the logs:: +If you are using NDOUtils, chances are that you have plenty of duplicate entries in your log table. Follow the procedure in order to re insert the logs: Copy all the log files from the remote pollers to the local poller in /var/lib/centreon/log/POLLERID/. To know the POLLERID of each of your pollers, execute the following request against the MySQL server (centreon database):: diff --git a/doc/en/release_notes/centreon-2.7/centreon-2.7.0.rst b/doc/en/release_notes/centreon-2.7/centreon-2.7.0.rst index 0c3e6c2793d7e126c1a3cc04220832fff190a4fd..fcfa2aa0fcdd2bc18bd07b71fddbdfaebc301e43 100644 --- a/doc/en/release_notes/centreon-2.7/centreon-2.7.0.rst +++ b/doc/en/release_notes/centreon-2.7/centreon-2.7.0.rst @@ -12,8 +12,10 @@ Features and Bug Fixes * Changing the graphic charter to be consistent with the new logo Centreon * Flat design (CSS and icons) * Custom view improvement + * Adding an editing or visualization mode * Graphic widgets relief to be able to put more on a page + * Adding a fullscreen mode * Menu Review for improved navigation and simplified user actions * Review og pages dedicated hosts and services pages in monitoring to include more informations. @@ -26,16 +28,19 @@ Features and Bug Fixes * Integration of a graphics module to replace a non-performing component QuickForm (Improved forms on multi element selection) * Simplifying the configuration of Centreon Broker (Temporary and Failover are automatically configured + enhanced best practices) * Ergonomic improvement of the configurations objects: + * Improved hosts form * Improved services form * Improved management macros: dynamic form system that provides the necessary inherited macros templates for proper operation of the configuration * Added ability to set a description of each macro used in commands * Review of the pathway for the generation of the configuration * Automatic creation of a configuration file for the poller when it is created + * Deleting configuration options in the Administration section, now automatically configured. This simplifies the handling of Centreon * Improved ACL system (Improved performances) * Native integration of Centreon CLAPI * Improved documentation + * Redesign Configuration part * Redesign Exploitation part * Integration of the API part @@ -76,20 +81,20 @@ Removed Features Known Bugs ---------- * ACL of pages is not fully updated during the upgrade process. So please check all your ACL pages after the migration. You may have problems with the followings pages: + * Monitoring > Hosts * Monitoring > Services * Monitoring > Performances (new page) * Monitoring > Downtimes * Monitoring > Comments * Monitoring > Eventlogs > System logs + * Graph slip not working * Pagination is broker when you go on the last page, change the number of line to the Max. Page become empty. -* If you have timeperiods used in exception or inclusion of timeperiod and now deleted, their ids stays in the database in relation table. During the sql update process, this blocks an addition of constraint on this relation table. To fix it, you have to remove old timeperiod id. - :: - - mysql> DELETE FROM timeperiod_exclude_relations WHERE timeperiod_id NOT IN (SELECT tp_id FROM timeperiod) OR timeperiod_exclude_id NOT IN (SELECT tp_id FROM timeperiod); - mysql> DELETE FROM timeperiod_include_relations WHERE timeperiod_id NOT IN (SELECT tp_id FROM timeperiod) OR timeperiod_exclude_id NOT IN (SELECT tp_id FROM timeperiod); +* If you have timeperiods used in exception or inclusion of timeperiod and now deleted, their ids stays in the database in relation table. During the sql update process, this blocks an addition of constraint on this relation table. To fix it, you have to remove old timeperiod id.:: + mysql> DELETE FROM timeperiod_exclude_relations WHERE timeperiod_id NOT IN (SELECT tp_id FROM timeperiod) OR timeperiod_exclude_id NOT IN (SELECT tp_id FROM timeperiod); + mysql> DELETE FROM timeperiod_include_relations WHERE timeperiod_id NOT IN (SELECT tp_id FROM timeperiod) OR timeperiod_exclude_id NOT IN (SELECT tp_id FROM timeperiod); How to Install ? ---------------- diff --git a/doc/en/release_notes/centreon-2.8/centreon-2.8.6.rst b/doc/en/release_notes/centreon-2.8/centreon-2.8.6.rst index fa25cbf4942d04465507f61e77c14fe2b2eba1d6..e93455b1291a48c59073449b5d4a854ed8e86642 100644 --- a/doc/en/release_notes/centreon-2.8/centreon-2.8.6.rst +++ b/doc/en/release_notes/centreon-2.8/centreon-2.8.6.rst @@ -48,4 +48,4 @@ Known bugs or issues ==================== * There's an issue in the ldap configuration form. A fix is available and will be package with the next bugfix version. Until then you can apply the patch available `here <https://github.com/centreon/centreon/commit/8aef6dfa4e3af27f16277b4211655889cf91fb71>`_ -* There's an issue on all listing pages. A fix is available and will be package with the next bugfix version. Until then you can apply the patch available `here <https://github.com/centreon/centreon/commit/d9b58f203f1af377575328d6f955ac1e9c8fb804>`_ +* There's an issue on all listing pages. A fix is available and will be package with the next bugfix version. Until then you can apply the `available patch <https://github.com/centreon/centreon/commit/d9b58f203f1af377575328d6f955ac1e9c8fb804>`_ diff --git a/doc/en/release_notes/centreon-2.8/index.rst b/doc/en/release_notes/centreon-2.8/index.rst index 71b33963035a85bea453b40c5c432bf0c7eac2a6..ecca4b2af7870c37ef4714800c71fe1c184d2880 100644 --- a/doc/en/release_notes/centreon-2.8/index.rst +++ b/doc/en/release_notes/centreon-2.8/index.rst @@ -15,3 +15,4 @@ Please find here the release notes dedicated to the last 2.8.x version of Centre centreon-2.8.6 centreon-2.8.7 centreon-2.8.8 + centreon-2.8.9