Créer des démons sur un serveur Shinken
Cet outil est utilisé pour créer (via la création de fichiers de type "ini") ou définir/déclarer (via la création de fichiers de type "cfg") des démons Shinken additionnels.
Plus d'informations sur le démarrage de Shinken en utilisant les fichiers "ini" et "cfg" sont réunies sur cette page de documentation : Démons.
Cet outil ne permet pas la création à distance, mais agit uniquement sur le serveur en local. Il s'agira donc de se placer correctement sur le serveur avant d'utiliser les commandes.
Dans la plupart du temps, pour créer un nouveau démon, il vous faudra lancer les commandes pour 1 créer le fichier ini, et 2, le fichier cfg.
Utilisation
L'option -h de la commande permet d'afficher l'aide de la commande :
| Code Block |
|---|
$ shinken-daemons-create -h
Usage
=====
shinken-daemons-create
This tool is used to create daemons on servers (local ini file) or declare the daemon in your arbiter configuration (cfg file)
Options
=======
--version show program's version number and exit
--help, -h show this help message and exit
--type=DAEMON_TYPE, -t DAEMON_TYPE
Daemon type to create or declare. Allowed daemon types are: broker, poller, reactionner, receiver, scheduler
--port=PORT, -p PORT Daemon port
--ini Creates the daemon locally on the server (will create the .ini configuration file)
--cfg Declares the daemon in your arbiter configuration (will create the .cfg configuration file). Must be launched only from your arbiter server.
--address=ADDRESS For cfg, set the address for this daemon (Mandatory). For ini, address the daemon will listen to on that local server (will listen to all interfaces by default)
--name=NAME Name of this daemon
|
Options :
| Nom | Description |
|---|---|
--version | Montre le numéro de version et sortie. |
-h, --help | Montre l'aide et sortie. |
--type=DAEMON_TYPE, -t DAEMON_TYPE | Type de démon à créer ou déclarer. Peut être: broker, poller, reactionner, receiver, scheduler |
--port=PORT, -p PORT | Port du démon |
--ini | Créé le démon localement sur le serveur (créera le fichier de configuration .ini) |
--cfg | Déclare le démon dans la configuration de votre Arbiter (créera le fichier de configuration .cfg). Dois être lancé seulement depuis un serveur arbiter. |
--address=ADDRESS | Pour les cfg, définir l'adresse de ce démon (Obligatoire). Pour les ini, adresse sur lequel le démon va écouter sur ce serveur local (écoutera sur toutes les interfaces par défaut). |
--name=NAME | Nom du démon |
Exemples :
| Code Block |
|---|
Examples: # Step1 [on the scheduler server]: Create the scheduler ini file so the server can start it: shinken-daemons-create --ini --type=scheduler --port=8768 --name=scheduler-customer-A # Step2 [on the arbiter server]: Create the scheduler in the arbiter configuration: shinken-daemons-create --cfg --type=scheduler --port=8768 --name=scheduler-customer-A --address=192.168.0.100 |
INI
Par exemple, créons un nouveau démon Poller sur un serveur, en local :
| Code Block |
|---|
$ shinken-daemons-create --ini --type=poller --port=8771 --name=poller-2 poller [id:1] : CREATED in the file /etc/shinken/daemons/pollerd-1.ini |
Ici le nouveau Poller s'est vu assigné l'ID numéro 1 et le fichier /etc/shinken/daemons/pollerd-1.ini a été créé.
Une fois créé, démarrez votre démon Poller via la commande :
| Code Block |
|---|
service shinken-poller --id 1 start |
CFG
Une fois le fichier ini créé et le démon démarré sur le serveur (dont l'ip est 192.168.0.15 dans cet exemple), il faut maintenant déclarer ce démon depuis votre serveur Arbiter :
| Code Block |
|---|
$ shinken-daemons-create --cfg --type=poller --port=8771 --name=poller-2 --address=192.168.0.15 poller [name:poller-2] [address:192.168.0.15] [port:8771]: CREATED in the file /etc/shinken/pollers/poller-2.cfg |
Le fichier /etc/shinken/pollers/poller-2.cfg a été créé.
Il vous faudra à présent redémarrer votre serveur Arbiter afin que ce dernier prenne en compte cette nouvelle déclaration de démon:
| Code Block |
|---|
service shinken-arbiter restart |
Supprimer des démons sur un serveur Shinken
Cet outil est utilisé pour Supprimer (via la suppression de fichiers de type "ini") des démons Shinken.
Cet outil ne permet pas la suppression à distance, mais agit uniquement sur le serveur en local. Il s'agira donc de se placer correctement sur le serveur sur lequel on souhaite supprimer le démon avant d'utiliser les commandes.
Utilisation
L'option -h de la commande permet d'afficher l'aide de la commande :
| Code Block |
|---|
$ shinken-daemons-remove -h
Usage
=====
shinken-daemons-remove
This tool is used to remove daemons on the local server
Options
=======
--version show program's version number and exit
--help, -h show this help message and exit
--ini [Mandatory] Remove daemon locally on the server.
--type=DAEMON_TYPE, -t DAEMON_TYPE
Daemon type to remove. Must be in: broker, poller, reactionner, receiver, scheduler
--id=DAEMON_ID ID of the daemon to remove. They can be listed with the command: shinken-daemons-list.
|
Options :
| Nom | Description |
|---|---|
--version | Montre le numéro de version et sortie. |
-h, --help | Montre l'aide et sortie. |
--ini | (Obligatoire) Supprime le démon localement sur le serveur |
--type=DAEMON_TYPE, -t DAEMON_TYPE | Type de démon à supprimer. Peut être: broker, poller, reactionner, receiver, scheduler |
--id=DAEMON_ID | ID du démon à supprimer. Ils peuvent être affichés avec la commande: shinken-daemons-list. |
Exemples :
| Code Block |
|---|
Example: We want to delete a scheduler daemon. # Step1 [on the scheduler server]: First, list all daemons on the server: shinken-daemons-list # Step2 [on the scheduler server]: Then, remove the scheduler with the id 2: shinken-daemons-remove --ini --type=scheduler --id=2 # Step3 [on the arbiter server]: Finally, manually delete the daemon definition: either by deleting the configuration file or by removing the daemon definition inside the configuration file ( in /etc/shinken/schedulers/ ) |
INI
Par exemple, supprimons le démon Poller ayant pour id le numéro 2 sur le serveur en local :
| Code Block |
|---|
$ shinken-daemons-remove --ini --type=poller --id=2 poller [id:2] is REMOVED from local server |
CFG
Maintenant il faut supprimer la définition du démon pour le retirer complètement de Shinken. La manière de faire peut différer en fonction du nombre de définition par fichier de configuration :
Premier cas : Une seule configuration par fichier de configuration
Si la définition de votre démon est seule dans un fichier, vous pouvez supprimer directement le fichier :
| Code Block |
|---|
rm /etc/shinken/pollers/poller-to-delete.cfg |
Second cas : Plusieur définitions par fichier de configuration
Il faut aller voir dans le fichier de configuration pour aller supprimer juste la définition qui nous intéresse :
| Code Block |
|---|
# /etc/shinken/pollers/all-pollers.cfg
define poller {
poller_name poller-master
[ ... ]
}
define poller {
poller_name poller-france
[ ... ]
}
# Delete this one
define poller {
poller_name poller-to-delete
[ ... ]
} |