Download pdf - CES en Operation Manual REV02

CENTREON ENTERPRISE SERVER

OPERATION MANUAL

ENGLISH VERSION

Last update 29/03/2011

Version 1.0-rev02

12 avenue Raspail - 94250 Gentilly – France

Tel +33 (0)1 49 69 97 12 – Fax +33 (0)1 78 12 00 28

[email protected] - www.merethis.com

R.C.S. 483 494 589

© Copyright MERETHIS 2005, 2011. All rights reserved.

S u m m a r y

1 . I N T R O D U C T I O N ..........................................................................................................................................42 . C E N T R E O N C O N N E X I O N .......................................................................................................................5

2.1.CHECK THE CENTREON VERSION......................................................................................................53 . C R E A T E / M O D I F Y / D E L E T E N A G I O S O B J E C T S ....................................................................6

3.1.HOST...............................................................................................................................................................63.2.HOST GROUP..............................................................................................................................................63.3.SERVICE........................................................................................................................................................6

3.3.1.passive service...............................................................................................................................63.3.2.act ive service..................................................................................................................................7

3.4.SERVICE GROUP........................................................................................................................................73.5.TEMPLATE....................................................................................................................................................7

3.5.1.host template...................................................................................................................................73.5.2.service template.............................................................................................................................7

3.6.SNMP TRAPS...............................................................................................................................................83.7.META SERVICE...........................................................................................................................................83.8.META SERVICE INDICATOR...................................................................................................................83.9.USER...............................................................................................................................................................93.10.CONTACT GROUP....................................................................................................................................93.11.TIME PERIOD............................................................................................................................................93.12.COMMAND..................................................................................................................................................9

4 . G E N E R A T E N A G I O S C O N F I G U R A T I O N .......................................................................................1 05 . D O W N T I M E S E T U P .................................................................................................................................1 26 . A C L M A N A G E M E N T ................................................................................................................................1 3

6.1.ACCESS GROUP.......................................................................................................................................136.2.MENU ACCESS.........................................................................................................................................136.3.RESOURCES ACCESS............................................................................................................................136.4.ACTIONS ACCESS...................................................................................................................................13

7 . E S C A L A T I O N S ..........................................................................................................................................1 48 . D E P E N D E N C I E S .......................................................................................................................................1 59 . A D D / D E L E T E A C E N T R E O N P O L L E R ........................................................................................1 6

9.1.ADD A CENTREON POLLER.................................................................................................................169.2.DELETE CENTREON POLLER..............................................................................................................16

1 0 . I N S T A L L C E N T R E O N M O D U L E S ...................................................................................................1 71 1 . C E N T R E O N S E R V I C E S ......................................................................................................................1 8

11.1.CENTREON AND NAGIOS SERVICES INIT SCRIPTS................................................................1811.2.CENTREON AND NAGIOS LOGS......................................................................................................18

1 2 . M O N I T O R I N G ..........................................................................................................................................1 912.1.TACTICAL VIEW.....................................................................................................................................1912.2.SERVICE DETAILS................................................................................................................................1912.3.HOST DETAILS ......................................................................................................................................1912.4.VIEW SERVICES IN ERROR STATE................................................................................................1912.5.VIEW HOSTS IN ERROR STATE.......................................................................................................1912.6.ACKNOWLEDGEMENT..........................................................................................................................2012.7.VIEW PERFORMANCE GRAPHS.......................................................................................................20

Property of Merethis – Use and copy of this document is forbidden outside contractual context.MERETHIS 12 avenue Raspail 94250 Gentilly France R.C.S. Créteil 483 494 589 SARL capital of 400 000 €.

3 / 21

1 . I N T R O D U C T I O N

This operation manual explains essentials operation tasks to manage a Centreon monitoring server. Most of the chapter of this

document are based on another document: 'CES-EN-Reference-Document' wich contains screenshots and reference fields

description of Centreon front end. 'CES-EN-Reference-Document' should be delivered with this manual.

A typical chapter looks like:

Centreon menu: Path in Centreon front end.

Reference document chapter: Reference document chapter.

Add: Description on how to add the objet.

Modify: Description on how to modify the objet.

Delete: Description on how to delete the objet.

Post configuration action: Description on post configuration action.

Example for 'service groups':

Centreon menu: Configuration Services Services Groups→ →

Reference document chapter: 3.1.4

Add: Click on 'Add' button to add a new service group. fill out the associated fields.

Modify: Click on an existing service group in the list to edit. fill out the associated fields.

Delete: Tick an existing service group in the list. In the action menu, select 'Delete' and validate.

Post configuration action: Generate configuration and restart Nagios instance.

To view Centreon screens on a service group and see associated fields description, go to chapter 3.1.4 of the reference

document, that's it.


4 / 21

2 . C E N T R E O N C O N N E X I O N

Centreon front end is availabe at the following URL: http://CENTREON_SERVER_IP/centreon/

CENTREON_SERVER_IP is the IP address of Centreon central server.

The login screen asl for a valid login / password.

Default login / password at first connexion is admin / centreon

2 . 1 . C H E C K T H E C E N T R E O N V E R S I O N

There is two ways to know the Centreon version installed on the server:

➢ the Centreon version is displayed on the login screen.

➢ Navigate to 'Administration About' in Centreon front end.→


5 / 21

Illustration 1: Login screen.

3 . C R E AT E / M O D I F Y / D E L E T E N A G I O S O B J E C T S

3 . 1 . H O S T

Centreon menu: Configuration Hosts Hosts → →


Add: Click on 'Add' button to add a new host. fill out the associated fields.

Modify: Click on an existing host in the list to edit. fill out the associated fields. It is also possible to modify a host through

detail host view (see chapter 2.2.4 4. Shortcuts of reference document).→

Delete: Tick an existing host in the list. In the action menu, select 'Delete' and validate.


Note: when deleting a host, all associated services will be delete as well.

3 . 2 . H O S T G R O U P

Centreon menu: Configuration Hosts Hosts Groups → →


Add: Click on 'Add' button to add a new host group. fill out the associated fields.

Modify: Click on an existing host group in the list to edit. fill out the associated fields.

Delete: Tick an existing host group in the list. In the action menu, select 'Delete' and validate.


3 . 3 . S E R V I C E

Centreon menu: Configuration Services Services by host → →

Configuration Services Services by host group→ →


Add: Click on 'Add' button to add a new service . fill out the associated fields.

Modify: Click on an existing service in the list to edit. fill out the associated fields. It is also possible to modify a service

through detail host view (see chapter 2.2.3 4. Shortcuts of reference document).→

Delete: Tick an existing service in the list. In the action menu, select 'Delete' and validate.


3 . 3 . 1 . P A S S I V E S E R V I C E

To setup a passive service, some specific fields need to be configure so that Nagios is able to change the service state when

receiving a external command result.

➢ 'Volatile': 'Yes'

➢ 'check_command' should be 'check_centreon_dummy' and its arguments '!0!OK'. Allows to initiate the service with OK

state.

➢ 'Max Check Attempts': '1'

➢ 'Active checks Enabled': 'No'

➢ 'Passive Checks Enabled': 'Yes'


6 / 21

Note: if the passive service is linked an SNMP trap, just link the service to the trap in 'Relation' tab 'Services Trap Relation' of→

the service sreen.

3 . 3 . 2 . A C T I V E S E R V I C E

To setup an active service, some specific fields need to be configure so that Nagios schedules the check control.

➢ 'Is Volatile': 'No'

➢ 'Active checks Enabled': 'Yes'

3 . 4 . S E R V I C E G R O U P

Centreon menu: Configuration Services Services Groups→ →


Add: Click on 'Add' button to add a new service group. fill out the associated fields.

Modify: Click on an existing service group in the list to edit. fill out the associated fields.

Delete: Tick an existing service group in the list. In the action menu, select 'Delete' and validate.


3 . 5 . T E M P L A T E

3 . 5 . 1 . H O S T T E M P L A T E

Centreon menu: Configuration Hosts Template→ →

Reference document chapter: see host 3.1

Add: Click on 'Add' button to add a new host template. fill out the associated fields.

Modify: Click on an existing host template in the list to edit. fill out the associated fields.

Delete: Tick an existing host template in the list. In the action menu, select 'Delete' and validate.


3 . 5 . 2 . S E R V I C E T E M P L A T E

Centreon menu: Configuration Services Template→ →

Reference document chapter: see service 3.3

Add: Click on 'Add' button to add a new service template. fill out the associated fields.

Modify: Click on an existing service template in the list to edit. fill out the associated fields.

Delete: Tick an existing service template in the list. In the action menu, select 'Delete' and validate.



7 / 21

3 . 6 . S N M P T R A P S

Centreon menu: Configuration Services SNMP Traps→ →


In case of an event (threshold reached...), SNMP traps are sent by monitored resources. For SNMP traps to be integrated within

Centreon, those traps need to be linked to an existing service:

• 'Manufacturer': add a new vendor if needed.

• 'MIBs': upload vendor MIB and link it to a vendor.

• In 'SNMP Traps' menu, it is possible to setup traps. Output message (displays in Centreon) or service state returned by

trap.

• 'SNMP Traps': configure traps details, change output message or linked service state

• Service setup to complete, link the service to the SNMP trap in 'Relation' tab 'Services Trap Relation'.→

3 . 7 . M E T A S E R V I C E

Centreon menu: Configuration Services Meta Services → →


Add: Click on 'Add' button to add a new meta service. fill out the associated fields.

Modify: Click on an existing meta service in the list to edit. fill out the associated fields.

Delete: Tick an existing meta service in the list. In the action menu, select 'Delete' and validate.

Action post configuration: Generate configuration and restart Nagios instance.

3 . 8 . M E T A S E R V I C E I N D I C A T O R

Centreon menu: Configuration Services Meta Services → →

Reference document chapter: 3.3.4.1

Add: Click on the indicator icon of an existing meta service in the list. Click 'Add' button. fill out the associated fields.

Modify: Click on the indicator icon of an existing meta service in the list. Click on the indicator to edit it. fill out the associated

fields.

Delete: Click on the indicator icon of an existing meta service in the list. Tick the indicator in the list. In the action menu, select

'Delete' and validate.

Action post configuration: Generate configuration and restart Nagios instance.


8 / 21

3 . 9 . U S E R

Centreon menu: Configuration Users →


Add: Click on 'Add' button to add a new user. fill out the associated fields.

Modify: Click on an existing user in the list to edit. fill out the associated fields.

Delete: Tick an existing user in the list. In the action menu, select 'Delete' and validate.


3 . 1 0 . C O N T A C T G R O U P

Centreon menu: Configuration Users Contacts Groups→ →


Add: Click on 'Add' button to add a new contact group. fill out the associated fields.

Modify: Click on an existing contact group in the list to edit. fill out the associated fields.

Delete: Tick an existing contact group in the list. In the action menu, select 'Delete' and validate.


3 . 1 1 . T I M E P E R I O D

Centreon menu: Configuration Users Time Periods→ →


Add: Click on 'Add' button to add a new time period. fill out the associated fields.

Modify: Click on an existing time period in the list to edit. fill out the associated fields.

Delete: Tick an existing time period in the list. In the action menu, select 'Delete' and validate.


3 . 1 2 . C O M M A N D

Centreon menu: Configuration Commands Checks→ →

Configuration Commands Notifications→ →

Configuration Commands Miscellaneous→ →


Add: Click on 'Add' button to add a new command. fill out the associated fields.

Modify: Click on an existing command in the list to edit. fill out the associated fields.

Delete: Tick an existing command in the list. In the action menu, select 'Delete' and validate.



9 / 21

4 . G E N E R AT E N A G I O S C O N F I G U R AT I O N

When creating / modifying a Nagios object, the Nagios configuration needs to be generated and the Nagios process to be

restarted. Configuration can be generated for one specific Nagios instance or all instances.

Centreon menu: Configuration Nagios Generate→ →


It is recommended to generate the configuration following those three steps:

1. Tick ' Generation Configuration Files' and 'Run Nagios debug (-v)' options only. Then click on 'Export' button.

2. Check the output for warnings or errors messages.

3. If no warnings or error messages, tick all options and click on 'Export' button.

When testing the configuration, output should looks like this:

Make sure that:

➢ there is no 'Warning' 1)

➢ there is no 'error' 2)


10 / 21

Illustration 2: Configuration test output.

When configuration files are moved, old configuration files are overwritten:

Output message should be 'Centreon : All configuration files copied with success', if no error message occured.

When restarting central Nagios instance, the output should looks like:

Output message:

➢ 'Running configuration check...done.'

➢ 'Stopping nagios: done.'

➢ 'Starting nagios: done.'.


11 / 21

Illustration 3: Configuration files are

overwritten.

Illustration 4: Nagios restart

output.

5 . D O W N T I M E S E T U P

In Centreon it is possible to setup downtime for hosts / services. This is a useful feature for planned maintenance operation on

the infrastructure resources. The downtime disable notifications during the time range defined.

Centreon menu: Create a downtime:

Monitoring Services hostname details Schedule downtime for this host→ → →

Monitoring Hosts service details → → Schedule downtime for this host→

View downtime list:

Monitoring Event Logs Downtime Hosts→ → →

Monitoring Event Logs Downtime Services → → →

• 'Host Name': select hostname

• 'Service': select service. Valid option only for a service downtime.

• 'Fixed': fixed downtime will disable notifications between the time frame defined. Non fixed downtime will only start if a

host / service problem occurred.

• 'Start Time': starting date and time

• 'End Time': end date and time

• 'Comments': mandatory field comments.

Modify: a downtime can't be modified. Delete it and create it again.

Delete: Tick an existing downtime in the list. Click the 'Delete' button.

Post configuration action: None.


12 / 21

Illustration 5: Downtime setup.

6 . A C L M A N A G E M E N T

To setup ACL , follow those steps:

➢ Create an access group with users in it.

➢ Configure menu access for the access group.

➢ Configure resources access for the access group

➢ Configure actions access for the access group

6 . 1 . A C C E S S G R O U P

Centreon menu: Administration ACL Access Groups→ →


Add: Click on 'Add' button to add a new access group. fill out the associated fields.

Modify: Click on an existing access group in the list to edit. fill out the associated fields.

Delete: Tick an existing access group in the list. In the action menu, select 'Delete' and validate.


6 . 2 . M E N U A C C E S S

Centreon menu: Administration ACL Menu Access → →


Add: Click on 'Add' button to add a new menu access. fill out the associated fields.

Modify: Click on an existing menu access in the list to edit. fill out the associated fields.

Delete: Tick an existing menu access in the list. In the action menu, select 'Delete' and validate.


6 . 3 . R E S O U R C E S A C C E S S

Centreon menu: Administration ACL Resources Access → →


Add: Click on 'Add' button to add a new resources access. fill out the associated fields.

Modify: Click on an existing resources access in the list to edit. fill out the associated fields.

Delete: Tick an existing resources access in the list. In the action menu, select 'Delete' and validate.


6 . 4 . A C T I O N S A C C E S S

Centreon menu: Administration ACL Actions Access → →


Add: Click on 'Add' button to add a new actions access. fill out the associated fields.

Modify: Click on an existing actions access in the list to edit. fill out the associated fields.

Delete: Tick an existing actions access in the list. In the action menu, select 'Delete' and validate.



13 / 21

7 . E S C A L AT I O N S

Centreon menu: Configuration Notifications Escalations→ →


Add: Click on 'Add' button to add a new escalation. fill out the associated fields.

Modify: Click on an existing escalation in the list to edit. fill out the associated fields.

Delete: Tick an existing escalation in the list. In the action menu, select 'Delete' and validate.



14 / 21

8 . D E P E N D E N C I E S

Centreon menu: Configuration Notifications Hosts→ →

Configuration Notifications Host Groups→ →

Configuration Notifications Services → →

Configuration Notifications Service Groups → →

Configuration Notifications Meta Services→ →


Add: Click on 'Add' button to add a new dependency. fill out the associated fields.

Modify: Click on an existing dependence in the list to edit. fill out the associated fields.

Delete: Tick an existing dependence in the list. In the action menu, select 'Delete' and validate.



15 / 21

9 . A D D / D E L E T E A C E N T R E O N P O L L E R

9 . 1 . A D D A C E N T R E O N P O L L E R

The procedure to add a poller is described in the document CES-EN-Installation-Configuration at chapter 4.

9 . 2 . D E L E T E C E N T R E O N P O L L E R

Delete or disable all configuration objects created during installation of the poller, in chapter 4 of CES-EN-Installation-

Configuration document.


16 / 21

1 0 . I N S TA L L C E N T R E O N M O D U L E S

It is possible to extend Centreon features by installing new modules. Follow the steps:

➢ First, install the corresponding module rpm package.

➢ Navigate to 'Administration Modules' to check the module list, the new module should be displayed here.→

➢ The action column on the right allows to install / update / uninstall a module

➢ If the icon is visible, that means you can install the module. If the icon is visible that means that the module

is already installed and can be uninstall.


17 / 21

1 1 . C E N T R E O N S E R V I C E S

Centcore: Manage communication and sync between Centreon central server and Centreon pollers. Features are:

• remote control of Nagios process

• send external commands to pollers

• retrieve performance data

• retrieve Nagios logs and archives

• SNMP traps information sync

Centstorage: Manage performance data and hosts / services statistics. Features are:

• analyze performance data files

• update RRD files or database

• analyze hosts / services data statistics

• manage RRD files (create / update / rebuild).

Ndo2db: Daemon running on central Centreon server, manage hosts / services states in database. Ndomod, ndo2db client, is

installed on each Nagios instance.

Nagios: Scheduler engine, execute check controls on monitored resources.

Crond: Linux / Unix default tasks scheduler.

1 1 . 1 . C E N T R E O N A N D N A G I O S S E R V I C E S I N I T S C R I P T S

Centcore : /etc/init.d/centcore (start / stop / restart)

centstorage : /etc/init.d/centstorage (start / stop / restart)

ndo2db : /etc/init.d/ndo2db (start / stop / restart)

nagios : /etc/init.d/nagios (start / stop / restart)

crond : /etc/init.d/crond (start / stop / restart)

1 1 . 2 . C E N T R E O N A N D N A G I O S L O G S

Centreon logs folder is located in:/var/log/centreon/

Nagios logs folder is located in: /var/log/nagios/


18 / 21

1 2 . M O N I TO R I N G

1 2 . 1 . T A C T I C A L V I E W

Centreon menu: Home Tactical Overview→


Description: Global view of monitored resources (hosts, services, acknowledgment).

1 2 . 2 . S E R V I C E D E T A I L S

Centreon menu: Monitoring Services All Services (click on a service)→ →


Description: Detail view of a service.

1 2 . 3 . H O S T D E T A I L S

Centreon menu: Monitoring Hosts Hosts (click on a host)→ →


Description: Detail view of a host.

1 2 . 4 . V I E W S E R V I C E S I N E R R O R S T A T E

Centreon status bar:

Centreon menu:

Monitoring Services Unhandled Problems→ →

Monitoring Services Service Problems→ →

Monitoring Services Details Problems (By Host, By Host Group, by Service Group)→ → →


Description: View of services in error state.

1 2 . 5 . V I E W H O S T S I N E R R O R S T A T E

Centreon status bar:

Centreon menu:

Monitoring Hosts Unhandled Problems→ →

Monitoring Hosts Host Problems→ →

Monitoring Hosts Details Problems (By Host, By Host Group, by Service Group)→ → →


Description: View of hosts in error state.


19 / 21

1 2 . 6 . A C K N O W L E D G E M E N T

Acknowledge an event allows Centreon to stop sending notifications for an host /service in error state. To do so, tick the desired

host / service in error and select 'Acknowledge' in the action menu.

You can also 'disacknownlege' a host / service if needed.

Acknowledgement is effective directly.

1 2 . 7 . V I E W P E R F O R M A N C E G R A P H S

Centreon provides advanced performance graphs views. The graphs view is organized by host groups.

Centreon menu: View Graphs →

Reference document chapter: 2.3

Description: Performance graph view by host groups.


20 / 21

Illustration 6: Action menu acknowledgment.

www.centreon.com

12 avenue Raspail - 94250 Gentilly – France

Tel +33 (0)1 49 69 97 12 – Fax +33 (0)1 78 12 00 28

[email protected] - www.merethis.com

R.C.S. 483 494 589

© COPYRIGHT MERETHIS 2005, 2011. ALL RIGHTS RESERVED.


21 / 21