-
MODULE CENTREON SYSLOG
FRONTEND & SERVER
MANUEL D'ADMINISTRATION
S O C I T M E R E T H I S12 Avenue Raspail 94250 Gentilly
Tl: 01.49.69.97.12 - Fax: 01.78.12.00.28
-
Ta b l e d e s m a t i r e s
1 . P R S E N T A T I O N
.....................................................................................................................................32
. L A N G U E D E L ' I N T E R F A C E
...............................................................................................................4
2.1.CONFIGURATION
..................................................................................................................................42.2.CONFIGURATION
DE L
'UTILISATEUR............................................................................................4
3 . D R O I T S D ' A C C S A U M E N U D U M O D U L E S Y S L
O G ...........................................................54 .
C O N N E X I O N L A B A S E D E D O N N E S D U M O D U L E
........................................................65 . G E S
T I O N D E L A D U R E D E R T E N T I O N D E S V N E M E N T S S
Y S L O G ..................86 . E X P O R T D E L A C O N F I G U
R A T I O N D U S E R V E U R
.................................................................9
-
1 . P R S E N TAT I O N
Ce manuel prsente l'administration des modules
centreon-syslog-frontend et centreon-syslog-server .
La gestion de l'administration des deux modules est regroupe au
sein de l'interface de Centreon dans la section administration et
concerne plusieurs points :
Langue de l'interface ;
Droits d'accs au menu du module Syslog ;
Connexion la base de donnes du module centreon-syslog-server
;
Gestion de la dure de rtention des vnements syslog en base de
donnes ;
Export de la configuration du serveur depuis l'interface
d'administration .
L'utilisation et la reproduction de ce document sont interdites
en dehors d'un cadre contractuel 3 / 9
-
2 . L A N G U E D E L ' I N T E R F A C E
L'interface d'exploitation et d'administration du modules
centreon-syslog-frontend peut tre disponible dans plusieurs
langues. Ceci est fonction des deux points suivants :
La langue dfinie pour l'utilisateur connect ;
La prsence du fichier de traduction .
En effet, la langue affiche est celle dfinie pour l'utilisateur
actuellement connect l'interface. Le mcanisme de traduction est
identique celui utilis pour le reste de l'interface de Centreon.
Cependant, le fichier de traduction doit tre disponible dans le
rpertoire du module pour qu'Apache puisse traduire l'interface du
module.
2.1. Configuration
Le fichier de traduction se nomme messages.mo (qui est la
version compile du fichier messages.po qui peut tre modifi avec un
diteur tel que poedit ). Avant d'installer le fichier de langue,
vous devez connatre le type d'encodage : UTF-8, ISO8859-1,
ISO8859-15, ....
Pour cela, tapez la commande :
$> locale
Et rcuprez la valeur de LC_MESSAGES, ici fr_FR.UTF-8 .
Vous pouvez maintenant compiler le fichier "messages.po"
comportant les diffrentes traductions et le placer dans le
rpertoire prvu cet effet. Par exemple, pour traduire Centreon en
franais, crez un nouveau rpertoire fr_FR.UTF-8 dans le rpertoire
/www/locale/ de Centreon.
Crez en suite un second rpertoire LC_MESSAGES dans ce mme
rpertoire :
$> mkdir
/usr/local/centreon/www/modules/Syslog/locale/fr_FR.UTF-8/$>
mkdir
/usr/local/centreon/www/modules/Syslog/locale/fr_FR.UTF-8/LC_MESSAGES/
Remarque : le nom du rpertoire est essentiel, il doit comporter
le code de la langue et du pays. Par exemple, pour la langue
franaise parl en France, se sera fr_FR.UTF-8, pour l'espagnol parl
en Espagne se sera es_ES.UTF-8, le portugais europen pt_PT.UTF-8,
le portugais brsilien pt_BR.UTF-8, l'anglais amricain en_US
etc.
Compiler le fichier *.po vers le rpertoire prvu cet effet :
$> msgfmt messages.po -o
/usr/local/centreon/www/modules/Syslog/locale/fr_FR.UTF-8/LC_MESSAGES/messages.mo
Appliquez les droits aux nouveaux fichiers, ils doivent
appartenir l'utilisateur et au groupe d'Apache :
$> chown -R www-data.www-data
/usr/local/centreon/www/modules/Syslog/locale/fr_FR.UTF-8/
Redmarrer le serveur web pour prendre en compte les
modifications :
$> /etc/init.d/apache2 reload
2.2. Configuration de l'utilisateur
Se rendre dans le menu Configuration Users mon utilisateur puis
choisir dans la liste droulante la langue dsire. L'interface sera
traduite lors du prochain accs aux pages du modules.
L'utilisation et la reproduction de ce document sont interdites
en dehors d'un cadre contractuel 4 / 9
-
3. Droits d'accs au menu du module Syslog
La gestion des droits d'accs est identique celle du reste de
l'interface Centreon. Pour cela il faut manipuler les objets :
Groupe d'accs ;
Accs au menus .
Un groupe d'accs est un conteneur auquel seront lis des
utilisateurs de l'interface de Centreon. Une fois ce groupe cr, il
est possible de lier une restriction d'accs aux menus ce groupe.
Ainsi, tous les utilisateurs inclus dans ce groupe ne peuvent voir
que ce qui leur a t permi.
La gestion des ACL (Access Control List) est modifiable dans le
menu Administration ACL de Centreon.
Remarque : il n'est pas possible de restreindre l'accs aux
vnements syslog. Ainsi, si un utilisateurs a accs la page de
recherche du module, il pourra effectuer une recherche sur
l'ensemble des lments disponibles.
La configuration ci-dessous donne accs aux pages Monitoring et
Research du module centreon-syslog-frontend pour le groupe d'accs
Guest :
L'utilisation et la reproduction de ce document sont interdites
en dehors d'un cadre contractuel 5 / 9
Illustration 1: Gestion des accs aux menus
-
4. Connexion la base de donnes du module
Afin de pouvoir parcourir les vnements syslog depuis l'interface
de visualisation, l'accs la base de donnes du serveur syslog doit
tre au pralable correctement configur, auquel cas un message
d'erreur sera visible :
L'accs la base de donnes est configurable dans le menu
Administration Modules Syslog Configuration :
L'utilisation et la reproduction de ce document sont interdites
en dehors d'un cadre contractuel 6 / 9
Illustration 2: Erreur d'accs
Illustration 3: Administration du module Syslog
-
Les champs modifier sont les suivants :
Syslog DB server : Adresse IP du serveur syslog ;
Syslog DB Name : Nom de la base de donnes, par dfaut syslog
;
Syslog Table Name : Nom de la table utilise pour la recherche.
Si la table indique est logs , alors la page de recherche
slectionne uniquement les entres de la table des vnements du jour.
Si la table indique est all_logs , la recherche est faite sur la
totalit des vnements en base.
Syslog Filters Table Name : Nom de la table contenant les
filtres disponibles pour la recherche. Si la table indique est
cache , alors les filtres disponibles seront ceux de la table des
vnements du jour. Si la table indique est all_cache , les filtres
disponibles seront ceux de la totalit des vnements en base.
Syslog User : Utilisateur MySQL ayant accs la base de donnes
;
Syslog Password : Mot de passe de l'utilisateur MySQL .
Remarque : Toutes ces informations sont celles dfinies lors de
l'installation du module centreon-syslog-server .
L'utilisation et la reproduction de ce document sont interdites
en dehors d'un cadre contractuel 7 / 9
Illustration 4: Champs de connexion au serveur
-
5 . G E S T I O N D E L A D U R E D E R T E N T I O N D E S V N
E M E N T S S Y S L O G
La dure de rtention des vnements syslog permet de supprimer
automatiquement les anciennes donnes. Chaque jours 23h59, un
service planifi supprime les tables logsYYYYMMdd et cacheYYYYMMdd
obsoltes, ou YYYYMMdd correspond au format de date anglais.
Cette dure de rtention est modifiable via le menu Administration
Modules Syslog Configuration :
La dure est comptabilise en jours. Lors d'une mise jour de la
version Syslog 1.1 ou d'une nouvelle installation, la dure par
dfaut est de 30 jours. Auparavant, pour les utilisateurs de la
version Syslog 1.1 , cette dure de rtention tait modifiable dans le
fichier de configuration de php-syslog-ng qui permettait d'excuter
une rotation des tables.
Une fois la modification effectue, il faut exporter la
configuration. Pour plus d'information quand l'export de la
configuration du serveur, voir le chapitre Export de la
configuration du serveur.
L'utilisation et la reproduction de ce document sont interdites
en dehors d'un cadre contractuel 8 / 9
Illustration 5: Dure de rtention
-
6. Export de la configuration du serveur
L'export de la configuration du serveur depuis Centreon se fait
au moyen d'une connexion SSH. C'est pourquoi il est demand lors de
l'installation du module centreon-syslog-frontend d'installer les
librairie libss2 et ssh2 pour PHP.
L'export ne demande pas d'change de cls SSH au pralable. Seuls
doivent tre renseigns l'adresse IP du serveur (dj dfinie pour avoir
accs la base de donnes), ainsi que le port SSH, l'utilisateur
syslog cr lors de l'installation du module centreon-syslog-server ,
du mot de passe de cet utilisateur et du rpertoire etc dans lequel
est copi le fichier de configuration.
Ces informations sont renseigner dans le menu Administration
Modules Syslog Configuration :
Les champs modifier sont les suivants :
Syslog DB Server : adresse IP du serveur syslog ;
Syslog configuration directory : rpertoire etc contenant la
configuration du serveur, dfini lors de l'installation du module
centreon-syslog-server ;
SSH port for connection to Syslog server : port d'coute du
service sshd du serveur syslog ;
Name of syslog user on Syslog server : nom de l'utilisateur
distant, par dfaut syslog ;
Password for distant user on Syslog server : mot de passe de
l'utilisateur .
Une fois ces champs remplis, cliquer sur le bouton Export
configuration . Une boite de dialogue affiche le statut de l'export
qui peut tre:
Configuration file was exported with succes : La configuration a
t copie avec succs ;
Unable to connect on distant server. : L'adresse IP de la
machine est incorrecte ;
Authentification failed. : Le nom de l'utilisateur et/ou le mot
de passe est (sont) incorrect(s) ;
Unable to export configuration file. Rights may be not correct
on distant directory. : Le rpertoire de destination est incorrect
ou les droits sur le fichier syslog.conf.php ne permettent pas
l'utilisateur de le copier dans ce rpertoire.
L'utilisation et la reproduction de ce document sont interdites
en dehors d'un cadre contractuel 9 / 9
Illustration 6: Paramtres de connexion au serveur pour l'export
de la configuration
1. Prsentation2. Langue de l'interface2.1. Configuration 2.2.
Configuration de l'utilisateur
3. Droits d'accs au menu du module Syslog4. Connexion la base de
donnes du module5. Gestion de la dure de rtention des vnements
syslog6. Export de la configuration du serveur
