Ces en Installation Configuration Rev08

CENTREON ENTERPRISE SERVER

INSTALLATION DOCUMENT

ENGLISH VERSION

Dernière mise à jour : 20/08/2012

Version 1.0-rev08

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. Tous droits réservés.

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 ............................................................................................42 . 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.PREREQUISITES........................................................................................................................................ 52.2. INSTALLATION:........................................................................................................................................... 5

2.2.1.step 1: choose instal lat ion type .................................................................................................52.2.2.step 2: language and keyboard choices. ................................................................................62.2.3.step 3: disks part i t ioning. ............................................................................................................72.2.4.step 4: configure geographical zone ........................................................................................72.2.5.step 5: root password conf igurat ion .........................................................................................82.2.6.step 6: rpm packages instal lat ion. ............................................................................................82.2.7.step 7: restart the system ..........................................................................................................9

2.3.NETWORK CONFIGURATION...............................................................................................................102.3.1.network interface conf igurat ion ...............................................................................................102.3.2.name server and dns conf igurat ion ........................................................................................142.3.3. t ime server..................................................................................................................................... 16

2.4.POST- INSTALLATION............................................................................................................................. 172.4.1.del l open manage........................................................................................................................ 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 83.1.PREREQUISITES...................................................................................................................................... 183.2. INSTALLATION:........................................................................................................................................ 18

3.2.1. f i rst connection and nagios conf igurat ion ............................................................................183.2.2.set centreon admin account password ..................................................................................213.2.3.set root password for mysql .....................................................................................................223.2.4.update operat ing system packages........................................................................................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 64.1.PREREQUISITES...................................................................................................................................... 264.2.CONFIGURATION:................................................................................................................................... 26

4.2.1.step 1: set t ing nagios user password on centreon pol ler ................................................264.2.2.step 2: set t ing up ssh authent icat ion key on centreon central ......................................264.2.3.step 3: add centreon pol ler to centreon central configurat ion .......................................274.2.4.step 4: add an host to centreon pol ler to ini t iate i t ...........................................................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. Créteil 483 494 589 SARL capital of 400 000 €.

3 / 33

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

The purpose of this section is to describe the ideal partitioning recommended in order to get the optimal

performances for your Centreon monitoring platform.

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 Container of different applications logs 15 Go

/var/lib Container of different application files As large as possible

Systems of files 15 Go

swap Extension of physical memory 2*RAM


4 / 33

2 . 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

2 . 1 . P R E R E Q U I S I T E S

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 T A L L A T I O N :

Follow the different steps to complete the Centreon installation successfully.

2 . 2 . 1 . S T E P 1 : C H O O S E I N S T A L L A T I O N T Y P E

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

Depending on your installation and your needs, type the following options:

➢ “poller” for Centreon poller installation (poller only);

➢ “central” for Centreon central installation (central server + database);

➢ By default (enter key), the “central” option will be used.


5 / 33

Picture 1: Select installation type

2 . 2 . 2 . S T E P 2 : L A N G U A G E A N D K E Y B O A R D C H O I C E S .

Select your language and press “enter” key to validate.

Select your keyboard type and press “enter” key to validate.


6 / 33

Picture 2: Select operating system language

Picture 3: Select keyboard language

2 . 2 . 3 . S T E P 3 : D I S K S P A R T I T I O N I N G .

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

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 . S T E P 4 : C O N F I G U R E G E O G R A P H I C A L Z O N E

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


7 / 33

Picture 4: Warning message

Picture 5: Select timezone

2 . 2 . 5 . S T E P 5 : R O O T P A S S W O R D C O N F I G U R A T I O N

Set the “root” user password and confirm it.

2 . 2 . 6 . S T E P 6 : R P M P A C K A G E S I N S T A L L A T 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.


8 / 33

Picture 6: Define root password

Picture 7: Instlalation of packages

2 . 2 . 7 . S T E P 7 : R E S T A R T T H E S Y S T E M

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

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

network configuration.


9 / 33

Picture 8: End of installation

2 . 3 . N E T W O R K C O N F I G U R A T I O N

2 . 3 . 1 . N E T W O R K I N T E R F A C E C O N F I G U R A T I 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.

Select “Edit Devices”, press “enter”.


10 / 33

Picture 9: Network configuration

Picture 10: Network cards configuration

Depending on your hardware specification, one or more network interfaces should be listed on screen, select your

network card and press “enter” key.

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.


11 / 33

Picture 11: Select network card

Picture 12: Card's configuration

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.

Select « Save & Quit » button with “tab” key and press “enter”.


12 / 33

Picture 13: SAve configuration of network cards

Picture 14: Save configuration

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


13 / 33

Picture 15: Exit setup tool

2 . 3 . 2 . N A M E S E R V E R A N D D N S C O N F I G U R A T I 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.

Select “Edit DNS Configuration”, press “enter” to validate.


14 / 33

Picture 16: Network configuration

Picture 17: DNS configuration

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 ;

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


15 / 33

Picture 18: Configuration of DNS servers

Picture 19: Save configuration

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

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 . T I M E S E R V E R

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 availableserver 127.127.1.0 # local clockfudge 127.127.1.0 stratum 10server <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).


16 / 33

Picture 20: Exit tool

2 . 4 . P O S T - I N S T A L L A T I O N

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

2 . 4 . 1 . D E L L O P E N M A N A G E

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.


17 / 33

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 AT I O N

3 . 1 . P R E R E Q U I S I T E S

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 . I N S T A L L A T I O N :

3 . 2 . 1 . F I R S T C O N N E C T I O N A N D N A G I O S C O N F I G U R A T I O N

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


18 / 33

Picture 21: connection

Once login successfully, Centreon Home page displays:

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.


19 / 33

Picture 22: Centreon web interface

Picture 23: Generate Nagios configuration files

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

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

# /etc/init.d/ndo2db restart



On the right side, only check the following option:

➢ Restart Nagios

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

Centreon server is now up and running !


20 / 33

Picture 24: Result of geneation of Nagios configuration files

Picture 25: Restart Nagios

3 . 2 . 2 . S E T C E N T R E O N A D M I N A C C O U N T P A S S W O R D

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


21 / 33

Picture 26: connection

Click on “Administration” tab, click on “Options” sub-menu, then « MyAccount » button:

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

updated.

3 . 2 . 3 . S E T R O O T P A S S W O R D F O R M Y S Q L

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'


22 / 33

Picture 27: Change user password

3 . 2 . 4 . U P D A T E O P E R A T I N G S Y S T E M P A C K A 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:

Type 'y' to validate the download.


23 / 33

Picture 28: RPM to update

Yum is downloading the packages:

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


24 / 33

Picture 29: Download RPM

Picture 30: Validate GPG keys

Yum finally update the packages:

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

# shutdown -r now

The system is updated.


25 / 33

Picture 31: Update RPM

4 . 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

4 . 1 . P R E R E Q U I S I T E S

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 . C O N F I G U R A T I O N :

4 . 2 . 1 . S T E P 1 : S E T T I N G N A G I O S U S E R P A S S W O R D O N C E N T R E O N P O L L E R

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

password:

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

4 . 2 . 2 . S T E P 2 : S E T T I N G U P S S H A U T H E N T I C A T I O N K E Y O N C E N T R E O N C E N T R A L

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

password:

# su - nagios# ssh-keygenGenerating 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}


26 / 33

4 . 2 . 3 . S T E P 3 : A D D C E N T R E O N P O L L E R T O C E N T R E O N C E N T R A L C O N F I G U R A T I 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.


27 / 33

Picture 32: Configuration of Nagios poller


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


➢ Description: enter description

➢ Instance Name: select the poller name you defined just before

➢ Output: enter centreon central IP address



28 / 33

Picture 33: Configuration of ndomod broker for poller


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”.

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


29 / 33

Picture 34: Duplication of configuration


➢ 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.


30 / 33

Picture 35: Configuration of Nagios poller

4 . 2 . 4 . S T E P 4 : A D D A N H O S T T O C E N T R E O N P O L L E R T O I N I T I AT E 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


➢ 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



31 / 33

Picture 36: Add host

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



Check the following options:

➢ Nagios Server: All Nagios Servers

➢ Generate Configuration Files

➢ Run Nagios debug

➢ Move Export files

➢ Restart Nagios – Method: Restart

Finally click on Export and check the status.

The Centreon poller is now operational.


32 / 33

Picture 37: List of hosts

Picture 38: Generate Nagios configuration files

Picture 39: Result of generation

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.

Documents

Ces en Installation Configuration Rev08