Page History

Principe

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

Configuration

Pour définir le module source VMware :

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

1. Configurer la source dans le fichier  /etc/shinken/sources/sync-vmware.cfg
   pour activer la source et appeler le module "sync-vmware".
   
2. Vous devez ensuite déclarer la source VMware dans le fichier

1. /etc/shinken/

1. synchronizers/synchronizer-master.cfg

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

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

service shinken-synchronizer restart

Configuration

La configuration du module se trouve par défaut dans le fichier  /etc/shinken/sources/sync-vmware.cfg

• 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

1. .
   
   
   

sources/sync-vmware.cfg

Exemple de définition:

define source {
    source_name      sync-vmware

#===============================================================================
# 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 4
    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 a1
    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

Intervalle d'import et ordre de la source

Connexion au serveur VMWare

 	#======== 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\useradmin
 
    # password:     password to login to vSphere
    password        PASSWORD

 check_esx_path 

Entier positif

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

 vcenter

---

  user

  password

Association des modèles d'hôtes Shinken 

Propriétés non importées dans shinken

   not_stored_properties

 admin_pwd
    esx_templates    esx
    vm_templates     vmware-vm
}

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:

1. Dupliquer les fichiers de configuration de la source (.cfg), par exemple:
   • /etc/shinken/sources/sync-vmware.cfg => /etc/shinken/sources/sync-vmware-EU.cfg
     
     
     
2. 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
   
   
3. 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
       
       

4. Redémarrer ensuite le synchronizer

   • => service shinken restart synchronizer

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