Setup:HowToUseTemplateWithInstallCentreon2
From Wiki Centreon
To translate... (for a moment, just use google translate tools :p )
Contents |
How to use templates files
With Centreon2, it is now possible to use templates for installation. That means by using templates it is now possible to answer all the questions with a simple installer file. This option may be practical for an automatic installation.
Where are these templates ?
Per default a series of templates can be found in tmpl/vardistrib in the sources of Centreon2. Il est malgrés tout conseiller de parcourir ces fichiers afin de valider l'ensemble des variables.
current templates:
- Debian Stable (etch): debian-etch
- Debian Futur Stable (lenny): debian-lenny
- Ubuntu 8.04 (Hardy): ubuntu-hardy
- Fedora: fedora-core
- Redhat 4: redhat-4
- base model: sample.tmpl
How to specify a template
To instruct the installer script to use a template file just use the option -f:
./install.sh -f tmpl/vardistrib/sample.tmpl
If the fields are correct there shouldn't be any further questions.
Créer son propre fichier de template
Nous allons détailler l'ensemble des parties de se fichier afin de bien comprendre les possibilités de personnalisation.
Prenons l'exemple de notre fichier sample.tmpl, qui pourra facilement être notre base pour créer sont propre fichier.
- L'ensemble des binaires spécifiés ci-dessous peuvent être ignoré uniquement s'ils ne trouvent dans un des répertoires de la variable $PATH. Il peut parfois être utile de définir un autre binaire pour la même tâche.
Les modules de Centreon
##################################################################### ## Begin: Install modules ##################################################################### ## What do you want to install ? ## 0 = no, 1 = yes ## CentWeb: Web front Centreon for Nagios PROCESS_CENTREON_WWW=1 ## CentStorage: Log and charts archiving. PROCESS_CENTSTORAGE=1 ## CentCore: Distributed Monitoring engine. PROCESS_CENTCORE=1 ## CentPlugins: Centreon Plugins for nagios PROCESS_CENTREON_PLUGINS=1 ## CentTraps: Centreon Snmp traps process for nagios PROCESS_CENTREON_SNMP_TRAPS=1 ##################################################################### ## End: Install modules #####################################################################
Comme vous l'avez remarqué, il s'agit de la liste des parties qui constituent Centreon. Il suffit de mettre à 1 la variable correspondante pour que l'installation prenne en compte ce changement. Un commentaire (# en debut de ligne) ou un 0 permettra de ne pas installer le module en question.
Variables par défaut utilisés dans le script
##################################################################### ## Begin: Default variables ##################################################################### ## Your default variables ## $BASE_DIR is the centreon source directory LOG_DIR="$BASE_DIR/log" LOG_FILE="$LOG_DIR/install_centreon.log" ## Don't change values above unless you perfectly understand ## what you are doing. ## Centreon temporary directory to work TMPDIR="/tmp/centreon-setup" ## default snmp config directory SNMP_ETC="/etc/snmp/" ## a list of pear modules require by Centreon PEAR_MODULES_LIST="pear.lst" ##################################################################### ## End: Default variables #####################################################################
Ces variables sont utilisées pour le fonctionnement de l'installeur. Il est conseillé de les laisser par défaut.
- PEAR_MODULES_LIST: par défaut, la liste est présente dans vars/pear.lst. Il n'est pas nécessaire de changer le contenu de ce fichier.
Variables liés à Centreon
##################################################################### ## Begin: Centreon preferences ##################################################################### ## Above variables are necessary to run a silent install ## Where you want to install Centreon (Centreon root directory) INSTALL_DIR_CENTREON="/srv/centreon" ## Centreon log files directory CENTREON_LOG="/var/log/centreon" ## Centreon config files CENTREON_ETC="/etc/centreon" ## Centreon run dir (all .pid, .run, .lock) CENTREON_RUNDIR="/var/run/centreon" ## Centreon generation config directory ## filesGeneration and filesUpload CENTREON_GENDIR="/var/cache/centreon" ## CentStorage RRDs directory (where .rrd files go) CENTSTORAGE_RRD="/var/lib/centreon" ## path to centstorage binary CENTSTORAGE_BINDIR="/srv/centreon/bin" ## path to centcore binary CENTCORE_BINDIR="/srv/centreon/bin" ## libraries temporary files directory CENTREON_VARLIB="/var/lib/centreon" ## Some plugins require temporary datas to process output. ## These temp datas are store in the CENTPLUGINS_TMP path. CENTPLUGINS_TMP="/var/lib/centreon/centplugins" ## path to centpluginsTraps binaries CENTPLUGINSTRAPS_BINDIR="/srv/centreon/bin" ## path for snmptt installation SNMPTT_BINDIR="/opt/snmptt" ## force install init script (install in init.d) ## Set to "1" to enable CENTCORE_INSTALL_INIT=0 CENTSTORAGE_INSTALL_INIT=0 ## force install run level for init script (add all link on rcX.d) ## Set to "1" to enable CENTCORE_INSTALL_RUNLVL=0 CENTSTORAGE_INSTALL_RUNLVL=0 ##################################################################### ## End: Centreon preferences #####################################################################
Nous rassemblons ici l'ensemble des variables liés à centreon. Comme le répertoire d'install, où se trouverons les fichiers de générations, ... Dans le cas où ces variables ne sont pas définies, une question sera posée.
- CENTCORE_INSTALL_INIT/CENTSTORAGE_INSTALL_INIT: permettent de forcer l'installation du script d'init sur le système
- CENTCORE_INSTALL_RUNLVL/CENTSTORAGE_INSTALL_RUNLVL: permetttent de forcer l'installation des niveaux d'execution.
Tout ce qui concerne Nagios
##################################################################### ## Begin: Nagios preferences ##################################################################### ## Install directory INSTALL_DIR_NAGIOS="/usr/share/nagios" # Configuration directory NAGIOS_ETC="/etc/nagios" ## Plugins directory NAGIOS_PLUGIN="/usr/lib/nagios/plugins" ## Images (logos) directory NAGIOS_IMG="/usr/share/nagios/htdocs/images" ## The nagios binary (optional) NAGIOS_BINARY="/usr/sbin/nagios" ## The nagiostats binary (optional) NAGIOSSTATS_BINARY="/usr/sbin/nagiostats" ## Logging directory NAGIOS_VAR="/var/log/nagios" ## Nagios user (optional) NAGIOS_USER="nagios" ## If you want to force NAGIOS_USER, set FORCE_NAGIOS_USER to 1 (optional) FORCE_NAGIOS_USER=0 ## Nagios group (optional) NAGIOS_GROUP="nagios" ## If you want to force NAGIOS_GROUP, set FORCE_NAGIOS_GROUP to 1 (optional) FORCE_NAGIOS_GROUP=0 ## Nagios p1.pl file (perl embedded) NAGIOS_P1_FILE="/usr/lib/nagios2/p1.pl" ## Nagios NDO module NDOMOD_BINARY=/usr/sbin/ndomod.o ## Nagios init script (optional) NAGIOS_INIT_SCRIPT="/etc/init.d/nagios" ##################################################################### ## End: Nagios preferences #####################################################################
Cette partie permet de spécifier l'ensemble des valeurs nécessaire à l'installation, concernant nagios.
Les valeurs pour Apache
##################################################################### ## Begin: Apache preferences ##################################################################### ## Apache configuration directory (optional) DIR_APACHE="/etc/apache" ## Apache local specific configuration directory (optional) DIR_APACHE_CONF="/etc/apache/conf.d" ## Apache configuration file. Only file name. (optional) APACHE_CONF="apache.conf" ## Apache user (optional) WEB_USER="www-data" ## Apache group (optional) WEB_GROUP="www-data" ## Force apache reload (optional): set APACHE_RELOAD to 1 APACHE_RELOAD=0 ##################################################################### ## End: Apache preferences #####################################################################
Rassemble les variables pour Apache.
- APACHE_RELOAD: permet d'authoriser le "reload" du service apache lorsque celui-ci est nécessaire pendant l'installation.
Autres variables
##################################################################### ## Begin: Other binary ##################################################################### ## RRDTOOL (optional) BIN_RRDTOOL="/usr/bin/rrdtool" ## Mail (optional) BIN_MAIL="/usr/bin/mail" ## SSH (optional) BIN_SSH="/usr/bin/ssh" ## SCP (optional) BIN_SCP="/usr/bin/scp" ## PHP (optional) PHP_BIN="/usr/bin/php" ## GREP (optional) GREP="" ## CAT (optional) CAT="" ## SED (optional) SED="" ## CHMOD (optional) CHMOD="" ## CHOWN (optional) CHOWN="" ##################################################################### ## End: Other binary #####################################################################
Autres binaires utilisés dans l'installation. S'il ne sont pas définit, le script se chargera de les rechercher dans le $PATH.
- Les variables GREP,CAT,SED,CHMOD,CHOWN, peuvent être définie. Possibilité de personnalisé les binaires pour l'installation. (Version des binaires sur le systèmes trop anciennes, pas compatibles, ...). Ces variables sont reprisent dans le script cinstall.
##################################################################### ## Begin: Others ##################################################################### ## Perl path for RRDs.pm file RRD_PERL="/usr/lib/perl5" ## Path to sudoers file (optional) SUDO_FILE="/etc/sudoers" ## init script directory (optional) INIT_D="/etc/init.d" ## cron config script directory (optional) CRON_D="/etc/cron.d" ## Path for PEAR.php file PEAR_PATH="/usr/share/php" ##################################################################### ## End: Others #####################################################################
Toutes les variables, que l'on ne peut pas classer dans les autres parties.
