Installation¶
Centreon recommends using its official packages from the Centreon Open Sources version available free of charge on our repository (ex CES). Most of Centreon endorsed software are available as RPM packages.
Alternatively, you can build and install your own version of this software by following the Using sources.
Using packages¶
Centreon provides RPM for its products through Centreon Open Sources (COS) version available free of charge on our repository. Open source products are freely available from our repository. These packages are available for CentOS 6 or 7 architecture x86_64, which is the sole platform officially supported by Centreon
Prerequisites¶
In order to use RPM from the COS repository, you have to install the appropriate repository.
CentOS 6¶
Run the following commands as privileged user
$ wget http://yum.centreon.com/standard/3.4/el6/stable/noarch/RPMS/centreon-release-3.4-4.el6.noarch.rpm
$ yum install --nogpgcheck -y centreon-release-3.4-4.el6.noarch.rpm
$ rm -f centreon-release-3.4-4.el6.noarch.rpm
$ yum clean all
CentOS 7¶
Run the following commands as privileged user
$ wget http://yum.centreon.com/standard/3.4/el7/stable/noarch/RPMS/centreon-release-3.4-4.el7.centos.noarch.rpm
$ yum install --nogpgcheck -y centreon-release-3.4-4.el7.centos.noarch.rpm
$ rm -f centreon-release-3.4-4.el7.centos.noarch.rpm
$ yum clean all
Install¶
Run the following commands as privileged user
$ yum install centreon-engine
All dependencies are automatically installed from Centreon repositories.
Using sources¶
To build Centreon Engine, you will need the following external dependencies:
- a C++ compilation environment.
- CMake (>= 2.8), a cross-platform build system.
- Centreon Clib (>= 1.4), The centreon core library.
This program is compatible only with Unix-like platforms (Linux, FreeBSD, Solaris, ...).
Prerequisites¶
If you decide to build Centreon Engine from sources, we heavily recommand that you create dedicated system user and group for security purposes.
On all systems the commands to create a user and a group both named centreon-engine are as follow (need to run these as root)
$ groupadd centreon-engine
$ useradd -g centreon-engine -m -r -d /var/lib/centreon-engine centreon-engine
Please note that these user and group will be used in the next steps. If you decide to change user and/or group name here, please do so in further steps too.
CentOS¶
Either use the Package Manager or the yum tool to install them. You should check packages version when necessary.
Package required to build:
| Software | Package Name | Description |
|---|---|---|
| C++ compilation environment | gcc gcc-c++ make | Mandatory tools to compile. |
| CMake (>= 2.8) | cmake | Read the build script and prepare sources for compilation. |
| Centreon Clib (>= 1.4) | centreon-clib-devel | Core library used by Centreon |
Install basic compilation tools
$ yum install gcc gcc-c++ make cmake
Install Centreon Clib
See the Centreon Clib documentation.
Debian/Ubuntu¶
In recent Debian/Ubuntu versions, necessary software is available as binary packages from distribution repositories. Either use the Package Manager or the apt-get tool to install them. You should check packages version when necessary.
Package required to build:
| Software | Package Name | Description |
|---|---|---|
| C++ compilation environment | build-essential | Mandatory tools to compile. |
| CMake (>= 2.8) | cmake | Read the build script and prepare sources for compilation. |
| Centreon Clib (>= 1.4) | centreon-clib-dev | Core library used by Centreon Connector. |
Install compilation tools
$ apt-get install build-essential cmake
Install Centreon Clib
See the Centreon Clib documentation.
OpenSUSE¶
In recent OpenSUSE versions, necessary software is available as binary packages from OpenSUSE repositories. Either use the Package Manager or the zypper tool to install them. You should check packages version when necessary.
Package required to build:
| Software | Package Name | Description |
|---|---|---|
| C++ compilation environment | gcc gcc-c++ make | Mandatory tools to compile. |
| CMake (>= 2.8) | cmake | Read the build script and prepare sources for compilation. |
| Centreon Clib (>= 1.4) | centreon-clib-devel | Core library used by Centreon Connector. |
Install compilation tools
$ zypper install gcc gcc-c++ make cmake
Install Centreon Clib
See the Centreon Clib documentation.
Build¶
Get sources¶
Centreon Engine can be checked out from GitHub at https://github.com/centreon/centreon-engine. On a Linux box with git installed this is just a matter of
$ git clone https://github.com/centreon/centreon-engine
Or You can get the latest Centreon Engine’s sources from its download website Once downloaded, extract it
$ tar xzf centreon-engine.tar.gz
Configuration¶
At the root of the project directory you’ll find a build directory which holds build scripts. Generate the Makefile by running the following command
$ cd /path_to_centreon_engine/build
Your Centreon Engine can be tweaked to your particular needs using CMake’s variable system. Variables can be set like this
$ cmake -D<variable1>=<value1> [-D<variable2>=<value2>] .
Here’s the list of variables available and their description:
| Variable | Description | Default value |
|---|---|---|
| WITH_BENCH | Build benchmarking tools. | OFF |
| WITH_CENTREON_CLIB_INCLUDE_DIR | Set the directory path of centreon-clib include. | auto detection |
| WITH_CENTREON_CLIB_LIBRARIES | Set the centreon-clib library to use. | auto detection |
| WITH_CENTREON_CLIB_LIBRARY_DIR | Set the centreon-clib library directory (don’t use it if you use WITH_CENTREON_CLIB_LIBRARIES). | auto detection |
| WITH_GROUP | Set the group for Centreon Engine installation. | root |
| WITH_LOCK_FILE | Used by the startup script. | /var/lock/subsys/centengine.lock |
| WITH_LOG_ARCHIVE_DIR | Use to archive log files that have been rotated. | ${WITH_VAR_DIR}/archives |
| WITH_LOGROTATE_DIR | Use to install logrotate files. | /etc/logrorate.d/ |
| WITH_LOGROTATE_SCRIPT | Enable or disable install logrotate files. | OFF |
| WITH_PID_FILE | This file contains the process id (PID) number of the running Centreon Engine process. | /var/run/centengine.pid |
| WITH_PKGCONFIG_DIR | Use to install pkg-config files. | ${WITH_PREFIX_LIB}/pkgconfig |
| WITH_PKGCONFIG_SCRIPT | Enable or disable install pkg-config files. | ON |
| WITH_PREFIX | Base directory for Centreon Engine installation. If other prefixes are expressed as relative paths, they are relative to this path. | /usr/local |
| WITH_PREFIX_BIN | Define specific directory for Centreon Engine binary. | ${WITH_PREFIX}/bin |
| WITH_PREFIX_CONF | Define specific directory for Centreon Engine configuration. | ${WITH_PREFIX}/etc |
| WITH_PREFIX_INC | Define specific directory for Centreon Engine headers. | ${WITH_PREFIX}/include/centreon-engine |
| WITH_PREFIX_LIB | Define specific directory for Centreon Engine modules. | ${WITH_PREFIX}/lib/centreon-engine |
| WITH_RW_DIR | Use for files to need read/write access. | ${WITH_VAR_DIR}/rw |
| WITH_SAMPLE_CONFIG | Install sample configuration files. | ON |
| WITH_SHARED_LIB | Build shared library for the core library. | OFF |
| WITH_STARTUP_DIR | Define the startup directory. | Generaly in /etc/init.d or /etc/init |
| WITH_STARTUP_SCRIPT | Generate and install startup script. Choices are ‘auto’, ‘sysv’ and ‘upstart’. | auto |
| WITH_TESTING | Build unit test. | OFF |
| WITH_USER | Set the user for Centreon Engine installation. | root |
| WITH_VAR_DIR | Define specific directory for temporary Centreon Engine files. | ${WITH_PREFIX}/var |
Example
$ cmake \
-DWITH_PREFIX=/usr \
-DWITH_PREFIX_BIN=/usr/sbin \
-DWITH_PREFIX_CONF=/etc/centreon-engine \
-DWITH_PREFIX_LIB=/usr/lib/centreon-engine \
-DWITH_USER=centreon-engine \
-DWITH_GROUP=centreon-engine \
-DWITH_LOGROTATE_SCRIPT=1 \
-DWITH_VAR_DIR=/var/log/centreon-engine \
-DWITH_RW_DIR=/var/lib/centreon-engine/rw \
-DWITH_STARTUP_DIR=/etc/init.d \
-DWITH_PKGCONFIG_SCRIPT=1 \
-DWITH_PKGCONFIG_DIR=/usr/lib/pkgconfig \
-DWITH_TESTING=0
At this step, the software will check for existence and usability of the rerequisites. If one cannot be found, an appropriate error message will be printed. Otherwise an installation summary will be printed.
Note
If you need to change the options you used to compile your software, you might want to remove the CMakeCache.txt file that is in the build directory. This will remove cache entries that might have been computed during the last configuration step.
Compilation¶
Once properly configured, the compilation process is really simple
$ make
And wait until compilation completes.
Install¶
Once compiled, the following command must be run as privileged user to finish installation
$ make install
And wait for its completion.
Check-Up¶
After a successful installation, you should check for the existence of some of the following files.
| File | Description |
|---|---|
| ${WITH_PREFIX_BIN}/centengine | Centreon Engine daemon. |
| ${WITH_PREFIX_BIN}/centenginestats | Centreon Engine statistic. |
| ${WITH_PREFIX_CONF}/ | Centreon Engine sample configuration. |
| ${WITH_PREFIX_LIB}/externalcmd.so | External commands module. |
| ${WITH_STARTUP_DIR}/centengine.conf | Startup script for ubuntu. |
| ${WITH_STARTUP_DIR}/centengine | Startup script for other os. |
| ${WITH_PREFIX_INC}/include/centreon-engine/ | All devel Centreon Engine’s include. |
| ${WITH_PKGCONFIG_DIR}/centengine.pc | Centreon Engine pkg-config file. |