From 0f45730fdcfa8303b798b5b232429bfd99de0ee3 Mon Sep 17 00:00:00 2001
From: Laurent Pinsivy <lpinsivy@gmail.com>
Date: Wed, 6 Sep 2017 09:51:27 +0200
Subject: [PATCH] 5611 improve centreon documentation (#5612)
* Add notice label to restart server after disabled selinux
* Move installation documentation chapters in correct order
* Fix french typo in install chapter
---
doc/en/installation/from_packages.rst | 75 +++----------------------
doc/fr/installation/from_packages.rst | 80 +++------------------------
2 files changed, 17 insertions(+), 138 deletions(-)
diff --git a/doc/en/installation/from_packages.rst b/doc/en/installation/from_packages.rst
index 088409db3d..524f49df56 100644
--- a/doc/en/installation/from_packages.rst
+++ b/doc/en/installation/from_packages.rst
@@ -18,8 +18,8 @@ SELinux should be disabled; for this, you have to modify the file */etc/selinux/
SELINUX=disabled
-After saving the file, please reboot your operating system to apply the changes.
-
+.. note::
+ After saving the file, please reboot your operating system to apply the changes.
******************
Repository install
@@ -51,52 +51,19 @@ For CentOS 7.
The repository is now installed.
-***************
-Package install
-***************
-
-Installing a central server
----------------------------
+************************
+Install a central server
+************************
The chapter describes the installation of a Centreon central server.
Perform the command:
- ::
+::
$ yum install centreon-base-config-centreon-engine centreon
-:ref:`After this step you should connect to Centreon to finalise the installation process <installation_web_ces>`.
-
-Installing a poller
--------------------
-
-This chapter describes the installation of a collector.
-
-Perform the command:
-
- ::
-
- $ yum install centreon-poller-centreon-engine
-
-The communication between a central server and a poller server is by SSH.
-
-You should exchange the SSH keys between the servers.
-
-If you don’t have any private SSH keys on the central server for the Centreon user:
-
- ::
-
- $ su - centreon
- $ ssh-keygen -t rsa
-
-Copy this key on the collector:
-
- ::
-
- $ ssh-copy-id centreon@your_poller_ip
-
Installing MySQL on the same server
-----------------------------------
@@ -104,20 +71,16 @@ This chapter describes the installation of MySQL on a server including Centreon.
Perform the command:
- ::
+::
$ yum install MariaDB-server
$ service mysql restart
-******************
-Post-package steps
-******************
-
PHP timezone
------------
-PHP timezone should be set; go to /etc/php.d directory and create a file named php-timezone.ini who contain the following line :
+PHP timezone should be set; go to /etc/php.d directory and create a file named php-timezone.ini which contains the following line :
::
@@ -157,28 +120,6 @@ Setting this option into /etc/my.cnf will NOT work.
# systemctl daemon-reload
# service mysql restart
-Launch services during the system startup
------------------------------------------
-
-Enable the automatically start of services during the system startup.
-
-Execute these commands on central server.
-
-* **CentOS v6** ::
-
- # chkconfig httpd on
- # chkconfig snmpd on
- # chkconfig mysql on
-
-* **CentOS v7** ::
-
- # systemctl enable httpd.service
- # systemctl enable snmpd.service
- # systemctl enable mysql.service
-
-.. note::
- If MySQL database is on a dedicated server, execute the enable command of mysql on DB server.
-
Conclude installation
---------------------
diff --git a/doc/fr/installation/from_packages.rst b/doc/fr/installation/from_packages.rst
index 79d0378c8c..19bfd4d430 100644
--- a/doc/fr/installation/from_packages.rst
+++ b/doc/fr/installation/from_packages.rst
@@ -20,8 +20,8 @@ SELinux doit être désactivé. Pour cela vous devez modifier le fichier */etc/s
SELINUX=disabled
-Après avoir sauvegardé le fichier, veuillez redémarrer votre système d'exploitation pour prendre en compte les changements.
-
+.. note::
+ Après avoir sauvegardé le fichier, veuillez redémarrer votre système d'exploitation pour prendre en compte les changements.
***********************
Installation des dépôts
@@ -50,52 +50,18 @@ Pour CentOS 7.
Le dépôt est maintenant installé.
-************************
-Installation des paquets
-************************
-
-Installer un serveur central
-----------------------------
+*******************************
+Installation du serveur central
+*******************************
Ce chapitre décrit l'installation d'un serveur central Centreon.
Exécutez la commande :
- ::
+::
$ yum install centreon-base-config-centreon-engine centreon
-
-:ref:`A la fin de cette étape, connectez-vous à Centreon pour finaliser le processus d'installation <installation_web_ces>`.
-
-Installer un collecteur
------------------------
-
-Ce chapitre décrit l'installation d'un collecteur.
-
-Exécutez la commande :
-
- ::
-
- $ yum install centreon-poller-centreon-engine
-
-La communication entre le serveur central et un collecteur se fait via SSH.
-
-Vous devez échanger les clés SSH entre les serveurs.
-
-Si vous n'avez pas de clé SSH privés sur le serveur central pour l'utilisateur 'centreon' :
-
- ::
-
- $ su - centreon
- $ ssh-keygen -t rsa
-
-Vous devez copier cette clé sur le collecteur :
-
- ::
-
- $ ssh-copy-id centreon@your_poller_ip
-
Installer MySQL sur le même serveur
-----------------------------------
@@ -103,16 +69,11 @@ Ce chapitre décrit l'installation de MySQL sur un serveur comprenant Centreon.
Exécutez la commande :
- ::
+::
$ yum install MariaDB-server
$ service mysql restart
-
-*******************
-Étapes post-paquets
-*******************
-
Fuseau horaire PHP
------------------
@@ -146,7 +107,7 @@ Système de gestion de base de données
La base de données MySQL doit être disponible pour pouvoir continuer l'installation (localement ou non). Pour information nous recommandons MariaDB.
-Pour les système CentOS / RHEL en verison 7, il est nécessaire de modifidier la limitation **LimitNOFILE**.
+Pour les systèmes CentOS / RHEL en version 7, il est nécessaire de modifier la limitation **LimitNOFILE**.
Changer cette option dans /etc/my.cnf NE fonctionnera PAS.
::
@@ -155,33 +116,11 @@ Changer cette option dans /etc/my.cnf NE fonctionnera PAS.
# echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf
# systemctl daemon-reload
# service mysqld restart
-
-Lancer les services au démarrage
---------------------------------
-
-Activer le lancement automatique de services au démarrage.
-
-Lancer les commandes suivantes sur le serveur Central.
-
-* **CentOS v6** ::
-
- # chkconfig httpd on
- # chkconfig snmpd on
- # chkconfig mysql on
-
-* **CentOS v7** ::
-
- # systemctl enable httpd.service
- # systemctl enable snmpd.service
- # systemctl enable mysql.service
-
-.. note::
- Si la base de données MySQL est sur un serveur dédié, lancer la commande d'activation mysql sur ce dernier.
Terminer l'installation
-----------------------
-:ref:`Clicquer ici pour finaliser le processus d'installation <installation_web_ces>`.
+:ref:`Cliquer ici pour finaliser le processus d'installation <installation_web_ces>`.
Installer un collecteur
-----------------------
@@ -210,4 +149,3 @@ Vous devez copier cette clé sur le collecteur :
::
$ ssh-copy-id centreon@your_poller_ip
-
--
GitLab