Vous êtes sur la page 1sur 33

CENTREON ENTERPRISE SERVER

INSTALLATION DOCUMENT

ENGLISH VERSION

Dernire mise jour : 15/02/2011 Version 1.0-rev07

12 avenue Raspail - 94250 Gentilly France Tel +33 (0)1 49 69 97 12 Fax +33 (0)1 78 12 00 28 commercial@merethis.com - www.merethis.com R.C.S. 483 494 589

Copyright MERETHIS 2005, 2011. Tous droits rservs.

Ta b l e o f c o n t e n t s
1 . C E N T R E O N S E R V E R P A R T I T I O N I N G ............................................................................................4 2 . C E N T R E O N I N S T A L L A T I O N P R O C E D U R E ...................................................................................5 2.1.P RE RE QUIS ITE S........................................................................................................................................5 2.2.INS TAL L A TION:...........................................................................................................................................5 2.2.1 .ste p 1 : cho o se in sta lla tio n type.................................................................................................5 2.2.2 .ste p 2 : lan gu a ge an d ke yb oa rd ch o ice s.................................................................................6 2.2.3 .ste p 3 : d isks p a rtitio n in g .............................................................................................................7 2.2.4 .ste p 4 : con figu re ge og rap h ica l zo n e........................................................................................7 2.2.5 .ste p 5 : ro ot p asswo rd co nfigu ra tion.........................................................................................8 2.2.6 .ste p 6 : rp m p ackag e s in sta llation .............................................................................................8 2.2.7 .ste p 7 : re sta rt the syste m ..........................................................................................................9 2.3.NE TWORK CONFIGURA TION...............................................................................................................10 2.3.1 .n e two rk in te rfa ce con fig u ra tio n...............................................................................................10 2.3.2 .n a me se rve r an d d ns con fig u ra tio n........................................................................................14 2.3.3 .time se rve r.....................................................................................................................................16 2.4.P OS T- INS TAL L A TION.............................................................................................................................17 2.4.1 .d e ll o pe n ma na ge........................................................................................................................17 3 . C E N T R E O N C E N T R A L S E R V E R C O N F I G U R A T I O N ...............................................................1 8 3.1.P RE RE QUIS ITE S......................................................................................................................................18 3.2.INS TAL L A TION:........................................................................................................................................18 3.2.1 .first con ne ction an d n ag io s co n fig u ration............................................................................18 3.2.2 .se t ce n treo n a d min acco un t p a sswo rd..................................................................................21 3.2.3 .se t roo t pa sswo rd fo r mysq l.....................................................................................................22 3.2.4 .u p da te o pe rating syste m p acka ge s........................................................................................23 4 . C E N T R E O N P O L L E R C O N F I G U R A T I O N ......................................................................................2 6 4.1.P RE RE QUIS ITE S......................................................................................................................................26 4.2.CONFIGURA TION:...................................................................................................................................26 4.2.1 .ste p 1 : se tting na gio s use r pa sswo rd o n cen treo n po lle r................................................26 4.2.2 .ste p 2 : se tting up ssh au th en tication ke y o n ce n treo n ce ntra l......................................26 4.2.3 .ste p 3 : a dd ce ntre o n p olle r to ce ntre on cen tra l con figu ra tio n.......................................27 4.2.4 .ste p 4 : a dd an h ost to ce n treo n p olle r to in itia te it...........................................................31

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

3 / 33

1.

CENTREON SERVER PARTITIONING

The purpose of this section is to describe the ideal performances for your Centreon monitoring platform.

partitioning recommended in order to get the optimal

The recommended partition are:

/var/log : used to store all logs of your system. Its is recommended to use a significant disk space for this partition. 15 Go seems to be a good size for this partition.

/var/lib : used to store MySQL tables and configuration files and also used by other applications. All data in this partition can be very large because it contains all performance data from Nagios and Centreon. Please consider to use as much space as possible.

/ : used for all remaining data on a server of this type. It is not likely to evolve rapidly over time. As for the /var/log, 15 Go seems to be a good size for this partition.

Swap : used to expand the memory used by the OS. It is usually set to twice the size of the RAM.

To summarize: /var/log /var/lib swap Container of different applications logs Container of different application files Systems of files Extension of physical memory 15 Go As large as possible 15 Go 2*RAM

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

4 / 33

2.
2.1.

C E N T R E O N I N S TA L L AT I O N P R O C E D U R E
PREREQUISITES

In order to install Centreon, it's necessary to have a server that can be formatted. If so, you can insert your CES CD in the drive and configure your server BIOS to boot on the CD.

2.2.

I N S TA L L AT I O N :

Follow the different steps to complete the Centreon installation successfully.

2.2.1.

S T E P 1 : C H O OS E I N S TA L L AT I O N T Y P E

The first step is to choose the installation type on the following screen.

Picture 1: Select installation type

Depending on your installation and your needs, type the following options: linux poller for Centreon poller installation (poller only); linux central for Centreon central installation (central server + database); By default (enter key), the central option will be used.

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

5 / 33

2.2.2.

STEP 2: LANGUAGE AND KEYBOARD CHOICES.

Select your language and press enter key to validate.

Picture 2: Select operating system language

Select your keyboard type and press enter key to validate.

Picture 3: Select keyboard language

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

6 / 33

2.2.3.

STEP 3: DISKS PARTITIONING.

A message alerts you that the partitioning process is starting. Validate by clicking yes.

Picture 4: Warning message

Now the setup process will ask you how you would like to organize disk partitions. Please refer to the information previously presented about the partitioning in paragraph 1 Centreon Server Partitioning of this document.

2.2.4.

STEP 4: CONFIGURE GEOGRAPHICAL ZONE

Please select your location. The location you select will have an influence on your timezone.

Picture 5: Select timezone

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

7 / 33

2.2.5.

S TE P 5 : RO OT PA SS W O RD CO N F I GU R ATI O N

Set the root user password and confirm it.

Picture 6: Define root password

2.2.6.

S T E P 6 : R P M PA C K A G E S I N S TA L L AT I O N .

The setup process check all needed dependencies and the installation of all packages will proceed. It may take a few minutes for the installation to be completed.

Picture 7: Instlalation of packages

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

8 / 33

2.2.7.

S T E P 7 : R E S TA RT T H E S YS T E M

The setup process is now finished. Click on the Reboot button to restart the system.

Picture 8: End of installation

Once restarted, the Text Mode Setup Utility will be launched. Go to chapter 2.3 Network configuration to setup the network configuration.

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

9 / 33

2.3. 2.3.1.

NE TW O R K C O N FI G UR ATI O N N E TW O R K I N TER FA C E C ON F I G UR ATI O N

The default network configuration is DHCP; it is recommended to define a static IP to Centreon server. To configure network, type the following command in a terminal as root user:

# setup

The following screen appears after first reboot of the server or when using the setup command line. Select Network configuration , using up and down keys on your keyboard and press enter to validate.

Picture 9: Network configuration

Select Edit Devices, press enter.

Picture 10: Network cards configuration

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

10 / 33

Depending on your hardware specification, one or more network interfaces should be listed on screen, select your network card and press enter key.

Picture 11: Select network card

Enter the network settings of the interface and validate with OK button. Use DHCP: enable DHCP (press space key to uncheck box) ; Static IP: interface static IP ; Netmask ; Default gateway IP.

Picture 12: Card's configuration

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

11 / 33

Once you reached the Select A Devices screen, you can configure other network interface or validate all your changes with the Save Button using the tab key.

Picture 13: SAve configuration of network cards

Select Save & Quit button with tab key and press enter.

Picture 14: Save configuration

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

12 / 33

To exit from the configuration utility, select the Quit button with tab key and press enter.

Picture 15: Exit setup tool

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

13 / 33

2.3.2.

N A ME SE R VE R AN D D NS CO N F I G UR ATI O N

To configure DNS on the server, type the following command in a terminal as root user:

# setup

Select Network configuration , using up and down keys on your keyboard and press enter to validate.

Picture 16: Network configuration

Select Edit DNS Configuration, press enter to validate.

Picture 17: DNS configuration

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

14 / 33

Enter the DNS settings of the interface and validate with OK button. Host name is the name of the monitoring server ; Primary DNS is the primary DNS ; Secondary DNS is the secondary DNS ; Tertiary DNS is the tertiary DNS ; Search is the default domain name ;

Picture 18: Configuration of DNS servers

Once your validate the DNS settings, go to Save&Quit button with tabulation key and press enter .

Picture 19: Save configuration

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

15 / 33

To exit from the configuration utility, select the Quit button with tab key and press enter.

Picture 20: Exit tool

Check your network configuration with the following commands:

# ifconfig # cat /etc/resolv.conf # hostname

If the configuration is not correct, restart the network service:


# /etc/init.d/network restart

2.3.3.

TIME SERVER

Edit the following file /etc/ntp.conf :


# vi /etc/ntp.conf

Insert the name(s) or address(es) of your time server in this file:


# undisciplined Local Clock. This is a fake driver intended for backup and when no outside source of # synchronized time is available server 127.127.1.0 # local clock fudge 127.127.1.0 stratum 10 server <TIMESERVERADDRE> server <TIMESERVERADDRE>

Restart NTP service: # /etc/init.d/ntpd restart

Check the server date:


# date

If the date is still not the good one, please update the time of your server with the date command. If you want more information about date, please to date manual (man date).

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

16 / 33

2.4.

P O S T - I N S TA L L AT I O N

If you need to install some additional packages like DELL-OpenManage, please follow the next procedure.

2.4.1.

DELL OPEN MANAGE

Dell Open Manage is a tool which gives you the possibility to monitor Dell Hardware information via SNMP MIBs.

In order to install DELL Open Manage, please connect yourself as root on the server and launch the following commands:

# wget -q -O - http://linux.dell.com/repo/hardware/latest/bootstrap.cgi | bash # yum install -y srvadmin-all dell_ft_install

Before installing the RPM, the system will ask you validate the GPG key. Please type y if you agree to do that.

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

17 / 33

3.
3.1.

C E N T R E O N C E N T R A L S E R V E R C O N F I G U R AT I O N
PREREQUISITES

This section deals with the configuration of Centreon central server. Centreon central server have to be installed properly following the chapter 5 instructions with installation type as central or default installation before doing anything else.

3.2. 3.2.1.

I N S TA L L AT I O N : F I RS T C ON N E C TI O N AN D N A GI O S C O N FI G U R ATI ON

For information, HTTPS is disable by default in the Centreon configuration.

You can now access Centreon front-end with a web browser at the following address:

http://SERVER_IP_ADDRESS/centreon/

Login / password for first connection on Centreon front-end: admin/centreon

Picture 21: connection

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

18 / 33

Once login successfully, Centreon Home page displays:

Picture 22: Centreon web interface

Navigate from the centreon front-end to:

Configuration -> Nagios

On the right side, check the following options: Generate Configuration Files Run Nagios debug (-v) Move Export Files

Click on the Export button.

Picture 23: Generate Nagios configuration files

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

19 / 33

Check the status of the process, it should be OK.

Picture 24: Result of geneation of Nagios configuration files

Enter the following command in a terminal on the Centreon server as 'root' user:

# /etc/init.d/ndo2db restart

Navigate from the centreon front-end to:

Configuration -> Nagios

On the right side, only check the following option: Restart Nagios

Picture 25: Restart Nagios

Click on the Export button and check the status of the process.

Centreon server is now up and running !

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

20 / 33

3.2.2.

SET CENTREON ADMIN ACCOUNT PASSWORD

For security reasons, Centreon admin account password needs to be changed after Centreon has been successfully installed. Connect to

Centreon front-end:

http://SERVER_IP_ADDRESS/centreon/

Default login / password on Centreon front-end: admin/centreon

Picture 26: connection

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

21 / 33

Click on Administration tab, click on Options sub-menu, then MyAccount button:

Picture 27: Change user password

Set the new password, confirm it and validate with the Save" button. The password for admin account is now updated.

3.2.3.

SET ROOT PASSWORD FOR MYSQL

For security reasons, MySQL root password needs to be set after Centreon has been successfully installed.

Enter the following command in a terminal on the Centreon server as 'root' user:

# mysqladmin -u root password 'your_new_password'

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

22 / 33

3.2.4.

U PD ATE O PER ATI N G S YS TE M PA C KA G E S

Notice: to be able to use yum utility, the centreon server need to have an Internet access.

To have an up-to-date operating system, you can update your packages, to do so, enter the following command in a terminal on the Centreon server as 'root' user:

# yum update

Yum will check for updates and asks if it is OK to download:

Picture 28: RPM to update

Type 'y' to validate the download.

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

23 / 33

Yum is downloading the packages:

Picture 29: Download RPM

Yum may ask you to import a GPG key several times, input 'y' and press enter.

Picture 30: Validate GPG keys

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

24 / 33

Yum finally update the packages:

Picture 31: Update RPM

Wait until process is completed and enter the following command to restart operating system:

# shutdown -r now

The system is updated.

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

25 / 33

4.
4.1.

C E N T R E O N P O L L E R C O N F I G U R AT I O N
PREREQUISITES

This section deals with the configuration of Centreon poller. Centreon poller have to be installed properly following the chapter 2 Centreon Installation procedure instructions with installation type as poller before doing anything else.

4.2. 4.2.1.

C ON F I G UR ATI O N : STEP 1: SETTING NAGIOS USER PASSWORD ON CENTREON POLLER

Enter the following command in a terminal on the Centreon server as 'root' user to set 'nagios' user account password:

# passwd nagios Changing password for user nagios. New UNIX password: Retype new UNIX password: passwd: all authentication tokens updated successfully.

4.2.2.

S TE P 2 : SE TTI N G U P SS H A UTHE N TI C ATI O N KE Y O N C EN TR E O N CE N TR AL

Enter the following command in a terminal on the Centreon server, accept all defaults, do not enter any password:

# su - nagios # ssh-keygen Generating public/private rsa key pair. Enter file in which to save the key (/var/spool/nagios/.ssh/id_rsa): Created directory '/var/spool/nagios/.ssh'. Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /var/spool/nagios/.ssh/id_rsa. Your public key has been saved in /var/spool/nagios/.ssh/id_rsa.pub.

Enter the following command to transfer the public key to the poller for the Nagios daemon owner (replace {IP_ADDRESS} with the IP address of the poller), use password defined in step 1 (chapter 4.2.1):

# ssh-copy-id -i ~/.ssh/id_rsa.pub nagios@{IP_ADDRESS}

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

26 / 33

4.2.3.

S TE P 3 : AD D CE N TR E ON POL LE R TO CE N TR E O N CE N TR AL C O N F I GU R ATI O N

Connect to the centreon front-end and navigate to:

Configuration -> Centreon -> Pollers -> Add

Input the following options: Satellite Name: centreon poller name IP address: IP address of the poller

Leave the other options with defaults values and validate with save button.

Picture 32: Configuration of Nagios poller

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

27 / 33

Navigate from the centreon front-end to:

Configuration -> Centreon -> ndomod.cfg -> Add

Input the following options: Description: enter description Instance Name: select the poller name you defined just before Output: enter centreon central IP address

Leave the other options with defaults values and validate with save button.

Picture 33: Configuration of ndomod broker for poller

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

28 / 33

Navigate from the centreon front-end to:

Configuration -> Nagios -> nagios.cfg

On the right side, check the Nagios CFG 1 line. Click on the More actions dropdown list and select duplicate, then confirm the duplication by OK.

Picture 34: Duplication of configuration

Click on the Nagios CFG 1_1 to edit the settings.

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

29 / 33

Input the following options: Configuration name: description of the configuration Status: check box Enabled Server Nagios configured: select the instance name of the centreon poller

Leave the others options with defaults values and validate with save button.

Picture 35: Configuration of Nagios poller

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

30 / 33

4.2.4.

S TEP 4: A DD A N H OS T TO CENTR EON POLLER TO I NI TI ATE I T

In order for the poller to be fully operational, it must have at least one resource to monitor. In this chapter we add the poller to monitor itself.

Connect to the centreon front-end and navigate to:

Configuration -> Hosts -> Add

Input the following options: Host Name: name of the host to add (name of the centreon poller) Alias: alias of the host Monitored from: select the instance of the poller from where the host will be monitored Add a template: select generic host Create Services linked to the Template too: Yes

Leave the other options with defaults values and validate with save button.

Picture 36: Add host

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

31 / 33

Now the new host should be displayed in the hosts list:

Picture 37: List of hosts

Navigate from the centreon front-end to:

Configuration -> Nagios

Check the following options: Nagios Server: All Nagios Servers Generate Configuration Files Run Nagios debug Move Export files Restart Nagios Method: Restart

Picture 38: Generate Nagios configuration files

Finally click on Export and check the status.

Picture 39: Result of generation

The Centreon poller is now operational.

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

32 / 33

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 commercial@merethis.com - www.merethis.com R.C.S. 483 494 589

Copyright MERETHIS 2005, 2011. All rights reserved.