Page History

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	true

Panel

title	Sommaire

Table of Contents

style	none

Description

Le module VMware se connecte au serveur vSphere.

Il va détecter automatiquement toute nouvelle machine virtuelle et les hyperviseurs ESX.
Il va collecter les données de l'ESX et des machines virtuelles.

Activation de la source

La source ne peut s'activer que sur le Synchronizer.

L'activation de la source s'effectue en ajoutant le nom de cette source dans le fichier de configuration du démon Synchronizer.
Pour ce faire, ouvrer le fichier de configuration à l'emplacement /etc/shinken/synchronizer/synchronizer-master.cfg, et ajouter le nom de votre collecteur "sync-vmware".

Exemple: par défaut, nous livrons un module dont le nom est "sync-vmware":

Vous pouvez essayer ce type de source soit en activant le collecteur sync-vmware présent par défaut ou en activant vos propres collecteurs de type sync-vmware.

Activer le collecteur sync-vmware livré par défaut

Par défaut, l’installation ou la mise à jour de Shinken Entreprise va mettre à disposition une définition de collecteur "sync-vmware".

La configuration de ce collecteur se trouve par défaut dans le fichier : /etc/shinken/sources/sync-vmware.cfg
Vérifier que le nom "sync-vmware" est présent dans le paramètre sources du fichier /etc/shinken/synchronizers/synchronizer-master.cfg ( ou le .cfg que vous utilisez pour définir les options du Synchronizer ).
- Ce collecteur est déjà présent dans la liste des sources livrées par défaut, il n'y a donc rien à modifier.
- S'il n'y est pas ( car modifié ) , vous pouvez le rajouter pour qu'il soit de nouveau actif.

Exemple :

Code Block

language	bash

define synchronizer {
    [...]
    sources                   Source 1, Source 2, Source 3, sync-vmware
    [...]
}

Si vous avez rajouté la source, redémarrez le Synchronizer pour qu'il puisse prendre en compte cette nouvelle source.
Code Block
language bash
theme Confluence
service shinken-synchronizer restart

Ajouter un autre collecteur de type sync-vmware

Pour ajouter une autre source, vous devez :

Choisissez un nom pour ce nouveau collecteur.
- Pour l'exemple, nous allons l'appeler "Mon-Collecteur-Vmware".
- Remplacer dans l'exemple le mot "Mon-Collecteur-Vmware" par le nom que vous aurez choisi.

Copier le fichier de définition de la source d'exemple : /etc/shinken-user-example/configuration/daemons/synchronizers/sources/sync-vmware/sync-vmware-example.cfg dans le répertoire de définition des sources /etc/shinken/sources/ et modifier son nom pour qu'il soit différent de la source sync-vmware livrée par défaut.
( Exemple : /etc/shinken/sources/Mon-Collecteur-Vmware.cfg )

Code Block

language	bash
theme	Confluence

cp  /etc/shinken-user-example/configuration/daemons/synchronizers/sources/sync-vmware/sync-vmware-example.cfg /etc/shinken/sources/collector__sync-vmware__Mon-Collecteur-Vmware.cfg

Ajouter le nom de la nouvelle source au Synchronizer en modifiant le paramètre sources du fichier /etc/shinken/synchronizers/synchronizer-master.cfg.

Code Block

language	bash

define synchronizer {
    [...]
    sources                   Source 1, Source 2, Source 3, sync-vmware
    [...]
}

Pour

Redémarrez le Synchronizer pour qu'il puisse prendre en compte

le changement de configuration, redémarrer le Synchronizer:

cette nouvelle source.

Code Block

language	bash
theme	Confluence

code

service shinken-synchronizer restart

Configuration

Voici le détail du fichier de configuration de la source qui se trouve ( suivant la procédure choisie ) :

La configuration du module se trouve par défaut dans le fichier

Soit dans le fichier que vous venez de créer en ajoutant le module ( par exemple /etc/shinken/sources/collector__sync-vmware__Mon-Collecteur-Vmware.cfg ).
Soit dans le fichier

/etc/shinken/sources/sync-vmware.cfg.

Exemple de fichier de configuration

Vous trouverez aussi systématiquement un exemple dans /etc/shinken-user-example/configuration/daemons/synchronizers/sources/sync-vmware/sync-vmware-example.cfg

Exemple de fichier de configuration

code

Code Block

language	js
theme	Confluence

#===============================================================================
# sync-vmware
#===============================================================================
# Daemons that can load this source:
# - synchronizer
# This source import hosts from a vSphere server
#===============================================================================


define source {

    #======== source identity =========
    # Source name. Must be unique
    source_name		sync-vmware

    # Module type (to load module code). Do not edit.
    module_type     	sync-vmware

    # order: source order for a source imply if a source is before an another source when
    # merging data
    order		    3

    # import_interval:  in minutes, what is the schedule import interval for this source.
    # note: 0 = don't schedule this source, will run only if an administrator launch it from the
    # interface
    import_interval	5

    # enabled: is this source enabled or not
    enabled		           0

    # description: display a description on the interface for this source
    description		This source is about loading hosts from VMware vSphere



    #======== vSphere access =========
    # command used to grab vSphere information. Do not edit.
    check_esx_path	/var/lib/shinken/libexec/synchronizer/esx_discovery.pl

    # vcenter:      ip/fqdn of your vcenter server
    vcenter		          vcenter.fqdn.com

    # user:         user to login to vSphere
    user		    DOMAIN\user

    # password:     password to login to vSphere
    password	  	PASSWORD



    #======== Templates association =========
    # esx_templates: apply templates to detected esx servers
    esx_templates	esx

    # vm_templates: apply templates to detected VM
    vm_templates	vmware-vm


}

Détails des sections composant le fichier de configuration

Identification de la source

Il est possible de définir plusieurs instances de module de type "sync-vmware" dans votre architecture Shinken.

Chaque instance devra avoir un nom unique.

Nom

Type

Unité

Défaut

Commentaire

Code Block
source_name

Texte

---

sync-vmware

Nous vous conseillons de choisir un nom en fonction de l'utilisation du module pour que votre configuration soit simple à maintenir.

Chaîne de caractères composée de lettres, de chiffres et des caractères _ et - .

Doit être unique.
Doit commencer par une lettre.
D'une longueur maximum à 40 caractères.
Ne doit pas contenir le caractère "$".

Code Block
module_type

Texte

---

sync-vmware

Ne peut être modifié.

Intervalle d'import et ordre de la source

Nom

Type

Unité

Défaut

Commentaire

Code Block
import_interval

Entier positif

minute

5

Délai écoulé entre les imports automatiques de la source.
Si 0, l'import de la source ne sera jamais exécuté automatiquement. ( L'import ne pourra être effectué uniquement manuellement )

Code Block
order

Entier positif

---

99

L'ordre de la source dans l'interface de configuration ( A un impact dans la fusion des données lors des imports de sources ).

Voir la page du Synchronizer pour plus d'information au sujet des fusions.

Info

icon	false
title	Remarque

Si vous changez l'ordre depuis l'interface ( page d’accueil ), le fichier .cfg sera mis à jour.

Connexion au serveur VMWare

Code Block

language	js
theme	Confluence

 	#======== vSphere access =========
    # command used to grab vSphere information. Do not edit.
    check_esx_path  /var/lib/shinken/libexec/synchronizer/esx_discovery.pl
 
    # vcenter:      ip/fqdn of your vcenter server
    vcenter     vcenter.fqdn.com
 
    # user:         user to login to vSphere
    user        DOMAIN\user
 
    # password:     password to login to vSphere
    password        PASSWORD

Nom

Type

Unité

Défaut

Commentaire

Code Block

check_esx_path

Entier positif

minute

Commande utilisée pour récupérer les informations du Vsphere / ESX.

Code Block

vcenter

Entier positif

---

Correspond à l'adresse réseau ( IP ou DNS ) du serveur ESX.

Code Block

user

Texte

---

Identifiant permettant de se connecter au serveur ESX.

Code Block

password

Texte

---

Mot de passe permettant de se connecter au serveur ESX.

Association des modèles d'hôtes Shinken

Code Block

language	js
theme	Confluence

   	#======== Templates association =========
    # esx_templates: apply templates to detected esx servers
    esx_templates   esx
 
    # vm_templates: apply templates to detected VM
    vm_templates    vmware-vm

Nom

Type

Unité

Défaut

Commentaire

Code Block

esx_templates

Texte

---

Modèle d'hôtes Shinken associé aux ESX

recupérés

récupérés.

Code Block

vm_templates

Texte

---

Modèle d'hôtes Shinken associé aux

machine

machines virtuelles

recupérées

récupérées.

Propriétés non importées dans shinken

NomTypeUnitéDéfautDescription

Code Block
not_stored_properties

ListeListe de propriétésCe paramètre permet de définir un ou plusieurs champs qui ne seront pas importés dans shinken. Cela peut être utile pour exclure une propriété ou bien utiliser des champs personnalisés utiles pour la gestion de vos fichiers .cfg

Modèles automatiques pour les serveurs virtuels en fonction de leur OS

Certains modèles d'hôtes sont ajoutés automatiquement aux serveurs détectés en fonction de la valeur définie dans les données vSphere
(définition VM et/ou outils VMware ).

Voici une liste de modèles qui peuvent être attachés automatiquement:

centos

debian

debian5

debian6

fedora

linux

oracle-linux

redhat

redhat4

redhat5

redhat6

windows

windows-datacenter

windows-enterprise

windows2000

windows2003

windows2008

windows2008r2

windows2012

windows7

windowsnt

windowsvista

windowsxp

Serveurs vSphere multiples

Une source/module peut parler à un seul serveur vSphere. Pour récupérer les données de plusieurs serveurs vSphere , vous devez définir autant de modules/sources correspondants.

Pour lier votre solution de supervision à un serveur vSphere, vous devez:

Dupliquer les fichiers de configuration de la source (.cfg), par exemple:/etc/shinken/sources/sync-vmware.cfg => /etc/shinken/sources/sync-vmware-EU.cfg
Mettre à jour les paramètres à l'intérieur de la source dans le fichier /etc/shinken/sources/sync-vmware-EU.cfg en pointant vers le nouveau serveur vSphere:

au minimum, vous devez changer les paramètres vcenter
- => source_name sync-vmware
- => vcenter myesx-EU.ovh.com

Déclarer votre nouvelle source dans le synchronizer . Editer le fichier /etc/shinken/synchronizers/synchronizer-master.cfg

Editer les lignes sources:

sources syncui,cfg-file-shinken,active-dir,sync-vmware,sync-vmware-EU,cfg-file-nagios,discovery

Redémarrer ensuite le synchronizer

=> service shinken restart synchronizer

Il est possible de définir des propriétés que la source ne devra pas récupérer.

Dans le cas de cette source, il se peut que la source remonte des informations sensibles ou que vous ne voulez pas importer dans Shinken.

Nom

Type

Unité

Défaut

Commentaire

Code Block
not_stored_properties

Liste

Liste de propriétés

Empêche la récupération de certaines propriétés des éléments récoltés

Précisions techniques

Clés de synchronisation

Les clés de synchronisation sont des propriétés des objets utilisées pour les identifier dans les sources. Le fonctionnement et l'utilité des clés de synchronisation sont décrits de manière plus détaillée dans la page de documentation dédiée: Précision technique sur le fonctionnement de l'import des sources.

Les propriétés VMWare suivantes sont ajoutées comme clés de synchronisation de l'objet Shinken:

fqdn

ip

Page tree

Versions Compared

Old Version 1

New Version Current

Key

Description

Activation de la source

Activer le collecteur sync-vmware livré par défaut

Ajouter un autre collecteur de type sync-vmware

Configuration

Exemple de fichier de configuration

Exemple de fichier de configuration

Détails des sections composant le fichier de configuration

Identification de la source

Intervalle d'import et ordre de la source

Connexion au serveur VMWare

Association des modèles d'hôtes Shinken

Propriétés non importées dans shinken

Modèles automatiques pour les serveurs virtuels en fonction de leur OS

Serveurs vSphere multiples

Précisions techniques

Clés de synchronisation