View Source

Importing Shinken framework cfg file to Shinken Enterprise is very easy. You can import your previous Shinken framework configuration using the cfg-file-shinken source.

Configuration

To define a shinken cfg source:

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

During the Shinken Enterprise installation process, a cfg-file-shinken module called cfg-file-shinken is already defined.
It is provided to be able to import default Shinken Entrerprise configuration.

sources/cfg-file-shinken.cfg

Property	Example	Description
source_name	cfg-file-shinken	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. If you set it to 0, the module will never be launcher automatically
modules	cfg-file-shinken	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 a Shinken framework configuration	A description to show on the UI.

module/cfg-file-shinken.cfg

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

Property

Default (if not set)

Description

module_name

cfg-file-shinken

Name of this module. Must be unique.

module_type

cfg-file-import

Can't be changed

cfg_path

/etc/shinken/local-import.cfg

The path of the cfg file that list file and directories to import.

...
cfg_file=dependencies.cfg
...
cfg_dir=hosts
cfg_dir=services
...

Here there an example of the module definition:

define module{
	# Shinken Enterprise. Lines added by import core. 
	# Do not remove it, it's used by Shinken Enterprise to update your objects if you re-import them.
	_SE_UUID XXXXXXXXXXXXXXXX
	_SE_UUID_HASH XXXXXXXXXXXXXXXX
	# End of Shinken Enterprise part

	module_name cfg-file-shinken
	module_type cfg-file-import
	cfg_path /etc/shinken/local-import.cfg
}

Having more than 1 cfg-file-nagios source defined.

When you have many source of configuration (for example 2 nagios to import in your shinken), we advise you to create 2 automatic sources.

If you keep only one source, you will have to merge the 2 nagios configurations in the same directory. You may have naming conflict...

To have an additional source:

Copy /etc/shinken/modules/cfg-file-nagios.cfg into an other cfg file name and configure it.
- Remember that the module_name must be unique (Example: my_module_name)
Copy /etc/shinken/sources/cfg-file-nagios.cfg into an other cfg file name and configure it.
- Remember that the source_name must be unique.
  (Example: my_source_name)
- modules must be set to the new module you just define (my_module_name)
Then you must declare the source_name source in the file /etc/shinken/synchronizers/synchronizer-master.cfg.
- add the source name in the line sources
- sources syncui,cfg-file-shinken,active-dir,sync-vmware,cfg-file-nagios,discovery, my_source_name

define synchronizer {
	...
	sources syncui,cfg-file-shinken,active-dir,sync-vmware,cfg-file-nagios,discovery,my_source_name
	...
}