View Source

Configuration

To define a nagios cfg source:

Configure the module in the file /etc/shinken/modules/cfg-file-nagios.cfg
to define the behaviour of the module
Then configure the source in the file /etc/shinken/sources/cfg-file-nagios.cfg
to enable the source and call the module configured in step 1.
Then you must declare the VMware source in the file /etc/shinken/synchronizers/synchronizer-master.cfg.

During the Shinken Enterprise installation process, a VMware module called sync-vmware is defined but set to inactive.
It is mainly to provide Administrator with an example.

sources/sync-vmware.cfg

Property	Example	Description
source_name	sync-vmware	Name of this source. Must be unique.
order	3	Order in the merge algorithm of this source data. Look in the Synchronizer page for more information about it.
import_interval	5	Launch this source every import_inverval minutes.
modules	sync-vmware	The module to launch
enabled	0	1 - Activate the source 0 - Viewed in the interface, but doesn't collect data nor import objects.
description	This source is about loading hosts from VMware vSphere	A description to show on the UI.

module/sync-vmware.cfg

Here is the list of parameters required by the module to be updated the in cfg file.

Property	Default (if not set)	Description
*vcenter*	*vcenter.fqdn.com*	FQDN (Fully Qualified Domain Name) or IP Address of the vSphere server.
*user*	*DOMAIN\user*	User used to connect to the vSphere server. Must be a read-only account.
*password*	*PASSWORD*	Password for the user access.
*esx_templates*	*esx*	Host template to set on the detected esx or esxi hosts.
*vm_templates*	*vmware-vm*	Host template to set on the detected virtual servers.

The default column shows the value used by the module if the Shinken Enterprise Administrator didn't set it.

Here there an example of the module definition:

define module{
  module_name      sync-vmware
  module_type      sync-vmware
  check_esx_path   /var/lib/shinken/libexec/synchronizer/esx_discovery.pl
  vcenter          myesx.ovh.com
  user             admin
  password         XYZ
  esx_templates    esx
  vm_templates     vmware-vm
}

Automatic templates for Virtual S

Migrating from Nagios to Shinken Enterprise is very easy

You can enable the Nagios configuration file source in the file /etc/shinken/modules/cfg-file-nagios.cfg

All you need to do is to set the following parameters:

cfg_path /etc/nagios/nagios.cfg

Note: you must copy all your Nagios configuration into the Shinken Enterprise.

Please also note that Nagios files are full path based, so you must put the Nagios configuration files in the same place than you did on your Nagios server.