Centreon Map Enaa

Centreon Documentation
Release 3.7.0
Merethis
July 28, 2015
Contents
ii
CHAPTER 1
Presentation
Centreon Map is an advanced mapping unit, which represents user-friendly views of indicators being monitored by
Centreon.
Thanks to drill-down navigation, users can create representations without any depth limitation.
The most alarming statuses of elements being monitored are provided in real time through customisable views that
correspond to each users requirements: business, functional, technical, topological etc.
Views can be created very easily (for example with drag-and-drop) and depend on the database of resources configured
in Centreon. Views are automatically synchronised and updated thanks to information gathered by Centreon and the
scheduler.
Data is represented graphically and in real time, which makes it possible to have one console focusing on monitoring
its activities.
Definition
Screen: A single visual representation. Each depth level corresponds to a Screen.
View: Set of Screens linked together by a tree structure system.
Perspective: Set of windows linked to internal operation of Centreon Map software.
Window: Perspective component linked to daily software management.
Object: Resource used to create Screens. Objects come from the Centreon web interface or from Centreon
Map.
Drop-down menu: Menu of actions can be accessed by right clicking the mouse when selecting an Object.
Scheduler : refere to Centreon Engine or Nagios.
Chapter 1. Presentation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
CHAPTER 2
Prerequisites
2.1 Client
Centreon Map Version
< 3.6
>= 3.6
>= 3.6
Supported Java versions

1.6 / 1.7
1.6 / 1.7
1.8
Minimum Update
0
25
40
Maximum Update
25
71
40
The update version limitation applies only to Java Web Start launching. The desktop client works well with any Java
6, 7 and 8 JVM version.
2.2 Server
Softwares
Centreon
Nagios or Centreon Engine
Minimum version
2.5.x
3.x or 1.x
2.3 PHP
PHP version
< 5.3
>= 5.3
Required modules and softwares

Zend Optimizer, php-mcrypt, php-xml, php-xml-writer
Zend Guard Loader, php-mcrypt, php-xml, php-xml-writer
2.4 Centreon
The Centreon Map maintenance and support does not include the maintenance and support of Centreon and/or
Nagios. It is the system administrators responsibility to ensure that the Centreon & Nagios system works correctly
when installing Centreon Map extension.
In order to fully benefit from the use of the Centreon Map module, here is a non-exhaustive list of properties that
Centreon & Nagios must have:
Centreon installed and operational
No or little latency with Nagios / Centreon Engine
Activation, collection and presentation of RRDTool performance graphs in Centreon

No gap holes within the Centreon performance graphs
Nagios / Centreon Engine logging
Operational downtime scheduling and comment submit
Operational notification system
Definition of monitoring indicators (hosts/services) in Centreon
MySQL database correctly configured
Operational and stable Linux / Unix system
Network topology adapted to allow a large bandwith of communications between Centreon and Centreon Map
Once the prerequisites are met, proceed with the installation of the Centreon Map module.
All paths and service names in the following documentation are based on CentOs. You may need to adapt these your
own linux distribution.
For example /usr/share may be /usr/local and httpd may be apache2.
Chapter 2. Prerequisites
CHAPTER 3
Install
3.1 Install for Centreon enterprise server

MERETHIS also provides repository files for CES 2.x and CES 3.x, respectively based on CentOs 5 and CentOs 6.
Add the url of the repository and install Centreon Map :
# cd /etc/yum.repos.d
# wget http://url-to-centreon-map-repository.repo
# yum install centreon-map-server
3.2 Package install

Several packages are provided by MERETHIS and are available on the download Web platform. Each version has
two different packages, depending on the version of PHP 5.x or 5.3+ For instance : centreon-map-server-3.7.0php5.tar.gz.
Follow the procedure under root privileges.
Uncompress the package and execute the installation script :
# tar zxf centreon-map-server-3.7.0-php5.tar.gz
# cd centreon-map-server-3.7.0-php5
# ./install.sh
Specify the path that contains the Centreon configuration files. Usually, /etc/centreon and press Enter to submit.
Specify the php.ini file path. Usually, /etc and press Enter to submit and finish the installation.
Since version 3.7, if these 2 files are located on default locations, no action will be needed.
3.3 License
A license has been provided to you by MERETHIS.
The filename is merethis_lic.zl. Keep this file as it is essential for the execution of Centreon Map.
Copy this file in the license directory of the module then reload the web server service :
# cp merethis_lic.zl /usr/share/centreon/www/modules/centreon-map-server/license/
# service httpd reload
Whilst you can also upload the licence file from Centreon web interface, you will still need to reload the httpd service.
3.4 Web install

The rest of the installation of the module is achieved through the Centreon Web user interface.
Navigate to the module management page : Administration > Extensions
Click on the installation icon of the centreon-map-server module.

On the new page click on Install Module.
The module is now installed.
Chapter 3. Install
CHAPTER 4
Update
To upgrade your module, simply apply the same procedure as with the installation process.
Follow the installation sequence, the final step is slightly different, for you will have to click on the Upgrade icon.
Clicking on the Upgrade will perform an update to the module.
The update Centreon Map is incremental, you may need to do this several times.
Chapter 4. Update
CHAPTER 5
Uninstall
In order to uninstall the Centreon Map module, navigate in the Centreon interface to the module management page
Administration > Extensions
Click on the uninstall icon.

A confirmation window will appear, click on OK to confirm the uninstall of the module.
Note that the uninstall of the Centreon Map module will result in the removal of all data related to the module
and its components (Views, Screens..).
Lost data cannot be restored unless a database backup has been made.
This procedure is not covered by the maintenance and support of the Centreon Map software.
10
Chapter 5. Uninstall
CHAPTER 6
User guide
6.1 Main Concepts

6.1.1 Centreon Map operation
Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manipulate monitoring-events. By offering users a wide variety of technical and operational components, it is possible to
reach a very detailed presentation level that is adapted to various cases of use:
Network views
Business views
Geographic views
Office plan
etc.
Once the first Screens and Views have been created, it is recommended that you customize the software preference
options before proceeding. Colours, sounds and pop-ups etc. and various other user settings are all beneficial for a
productive user-friendly environment.
6.1.2 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface.
Host objects
Service objects
Host group objects
Service group objects
Meta service objects
Business Activity objects (Centreon BAM)
KPI objects, Business Activities component (Centreon BAM)
We shall introduce new Objects that are specific to Centreon Map.
Image, shape and text objects for decorating Screens with visual elements
Container objects; elements for arbitrarily gathering other Objects
11
Link objects for creating Screens with logical or physical links between Objects
Legend objects, which allow the user to be written on the code being used
All Objects, except for images, shapes, texts, links, legends, and shapes will have status information; their own status
that comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregating
child states.
This system makes it possible to move step-by-step in real time to quickly identify the elements at fault. This procedure
is known as Drilldown.
6.2 Licence system

Centreon Map has 2 licence types : administrator license and user license.
The terms user slot and admin slot will be used within this document.
6.2.1 User license

The user slots only allow view manipulation as opposed to administration.
6.2.2 Administrator license

The admin slot permits all possible actions in Centreon Map.
Actions are always subject to ACL, even with an admin slot.
The Centreon administrator can grant the Centreon Map admin rights and manage their ACL.
The Centreon administrators are automatically Centreon Map administrators.
12
Chapter 6. User guide

6.3 Login screen
When launching the application, the login screen appears. It allows you to choose a connection profile Centreon Map
and connect to the desired server.
The login screen can be moved by drag and drop.
If this screen does not appear it is necessary to verify the installation of the Java virtual machine.
6.3.1 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie:
A server, represented by a name, consisting of an address, a port, URL and whose connection can be made
securely, with SSL.
(Optional) A named proxy, having an address and a port and optional authorisation credentials: a username and
password.
A delay, that is the status refresh rate for objects displayed in the client Centreon Map.
A Centreon login username and password.
The Profile management form enables the creation and management of connection profiles and their relevant information. It is accessible via the button to the right of the list of profiles.
6.3. Login screen
13
It is possible to store the configuration of different connection profiles.

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation.
List Profiles presents all the saved profiles. The button to the right of this list allows, upon confirmation, the deletion
of the selected profile.
List Servers shows the different existing servers. Servers can be configured via a dedicated form provided, made
available by clicking on the button next to the list. A server must be selected in order to create a new profile.
List Proxies displays all available proxies and the button to the right of the list opens the proxy management form.
In is not necessary to select a proxy when creating a new profile.
The field Refresh Time is the interval in seconds between each object status update in the current view. A numeric
value greater than 0 is required, by default 60 seconds.
Finally the fields Login and Password are the Centreon login and password, they are optional in the profile definition. However if they are not entered, they must be manually typed at each connection.
The label of a profile is automatically generated as :
Login @ server name or
Login @ server name / proxy name
14

6.3.2 Servers management form
List Servers presents all user-created servers. The button to the right of the list, after confirmation, deletes the
selected server.
The server name is the label under which it will appear in different lists. It is also displayed in the title of the main
window Centreon Map.
In the Address field, simply enter the IP address or DNS name of the web Centreon server.
Example: 192.168.1.240 or my.server.com.
Do not enter additional information about the protocol in this field (http:// ...).
Field Port is the connection port to the server, it is usually port 80 for regular connections (HTTP) or 443 for a secure
connection (HTTPS). These two default values can be overridden.
The field URL is the additional address to refer to the web directory Centreon.
It is usually accessible via /centreon/ or / but can be customized by the administrator below :
Example: Centreon available at this address: http://mon.server.com/centreon/, the URL will be /centreon/. Example: Centreon available at this address: http://mon.server.com/, the URL will be /.
The Secure connection enables the transmission of encrypted data over SSL (HTTPS), this option changes the default
value of the field Port.
6.3. Login screen
15
6.3.3 Proxys management form
List Proxies presents all user-created proxies. The button to the right of this list, upon confirmation, deletes the
selected proxy.
The proxy name is the label under which it will appear in different lists.
In the Address field, enter the IP address or DNS name of the proxy address.
Example: 192.168.1.250 or my.proxy.com.
Do not enter any additional information on the protocol in this field ( http:// ... ).
The proxy definition files such as proxy.pac are not supported in Centreon Map.
Field Port is the connection port to the proxy, it is usually port 3128, the default value, which can be modified if
necessary.
The Authentication option enables user-entry for Login and Password fields for proxy connections.
The two proxy fields Login and Password must be explicitly set by the administrator and are distinct from Centreon.
The two checkboxes allow to choose for wich connections the proxy will be used, to the server Centreon Map and/or
to MapBox that needs acces to the Internet.
16

6.4 View Selection Perspective
The view selection perspective allows users, using the administrator slot, to create new views and delete them.
Opening a view provides access to the monitoring perspective.
There is a wide choice of parameters relating to visualization and access rights for views. These options are configurable from the Centreon web interface and are detailed later in this manual.
Every view has a tooltip displaying all user rights of that view, depending on the configuration of the ACL defined in
Centreon and the slot used.
6.4.1 Menus and toolbars

Main menu
6.4. View Selection Perspective

17
Action
Disconnect
Exit
Description
Hides application window and displays login screen
Closes application Centreon Map and all connections to Centreon server
Action menu
Action
Centreon Map History
Refresh view list
Create a new view
Import lat/long data
Full screen
Description
Opens Centreon Map logs window
Refreshes views list
Opens the view creation dialog
imports lat/long data from a CSV file
Activates full screen ( press F11 to deactivate it)
? menu
Action
About
Description
Open the About dialog
Toolbar and search bar
The toolbar provides quick access to the main functions.

Action
Disconnect
Create a new view
Refresh view list
Full screen
Use admin slot
Description
Opens the view creation dialog
Refreshes views list
Activates full screen ( press F11 to deactivate it)
Toggles from one slot type to another
The search bar, preceded by the label Search ..., filters out all views that do not contain the entered text.
18

Context menu
A right click on any picture displayed in the list will cause a context menu to show.
Action
Display view
Edit
Delete
Create launcher file
Description
Opens the monitoring perspective and displays the selected view
Opens the view creation dialog filled with selected view data
Deletes the selected view
Opens the launcher file creation dialog

19
View creation dialog
This window allows the creation of a new view. The user must enter the view name to create it. He can also provide a
view description and select an icon from a predefined list.
This window can also be used to edit the details of an existing view, in which case these three fields are automatically
pre-filled with information from the selected view.
Note: these features are only available from the administrator slot.
20

Launcher file creation dialog
A launcher file holds, on the local workstation, login information for the current server and the selected view.
Centreon Map uses information found in this file to connect to the server and open the user-selected view.
More information concerning this feature is detailed in the life-cycle section.

21
About dialog
The About dialog displays the current version of the client and the list of contributors in alphabetical order.
It also displays the installation details, ie all components used, produced by Merethis or from the Eclipse community.
6.4.2 Import lat/long data

Since version 3.6, Centreon Map has a new feature: geolocation. This displays the Centreon resources on a map
according to their lat/long position. It will be detailed in the next chapter.
In this view selection perspective it is possible to import a CSV file to associate geographical positions to Centreon
resources.
The CSV file format should have at least 5 columns in the following order, additional columns are ignored:
resource_type,resource_name,service_name,latitude,longitude
The resource type can be: host, hostgroup, service, servicegroup, metaservice, bam
The resource name must be identical to the name configured in Centreon
The service name must be identical to the name configured in Centreon, this column is used for only for services
and may, otherwise, be empty
Latitude is a valid decimal number -90 to 90
Longitude is a valid decimal number -180 and 180
Centreon Map validates the imported data, all errors are presented to the user with their line number.
22

Once the import is successfully completed, the user can add imported Centreon resources to the view of his choice.

23
6.5 Monitoring perspective
6.5.1 Workspace
This screenshot shows the monitoring perspective. This is the main perspective in which the majority of actions and
manipulations are made.
These actions are available via various means, including the main menu, the main toolbar and the palette, which have
been highlighted in this screenshot.
Toolbars are provided for manipulating window resources, such as the small-button filtering toolbar for the Explorer
window, and finally right-click context menus for most application tool elements.
At initial opening of the view, the perspective will display the default view configuration that depends on the user
profile :
The upper left area has a single window called Explorer, which shows a tree representation of the current view.
This window is available for all users however some actions are restricted to the administrator.
The bottom left area, called Resources is only available to the administrator. Windows tabbed in this area display all reso
Hosts and Hosts groups in two separate views
Meta-services and Service groups, in two separate views
Centreon BAM, in its own view, and finally
The images available in Centreon.
The main viewing area features screens also known as editors, these are components that enable the creation
and display of maps and views in Centreon Map. This main viewing area can be personalized and subdivided
as required. There are 4 different types of editors, these will be described in more detail further on.
24

There are two other screen viewing areas, they appear on this screenshot but are not displayed by default in the
workspace:
ThePreview area comprises the following windows:
Outline, which offers an overview of the active editor and simplifies navigation amongst the main
views.
Downtimes and Acknowledged highlight the resources that are either in downtime or acknowledged state.
Finally, the Summary area has a set of windows that display an overall collective view of information:
The subwindow Centreon Map History displays important events in the current session.
The subwindow Problematic elements presents a list of all objects whose status is not OK.
The subwindow Pollers shows all pollers configured in Centreon, their states and particular information.
All these areas are default settings that may be freely customized.
Each window can be closed and re-opened via a special component later described in this document.
Windows can be displaced, added to an existing zone, or establish an independent zone at any desired location. To
do this, simply click the title of the view, hold down the mousebutton and drag the window, the application proposes
various drop locations with dotted lines. The child windows can also be dragged from the main window into a separate
window.
Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window.
Lastly, each zone can be resized to optimise the the display of each composing subwindow.
The customized workspace (positions, dimensions, etc.) is implicitly saved on the following events:
Refresh the workspace
Display of the preferences
Return to the list of views
Logout
Application closure
This configuration is stored on a local file. It is associated with the current user account, the server and the current
view.
This enables each user to tailor his own independent working environment for each different machine.
The workspace conforms to this user-customized configuration upon opening of the monitoring perspective.
The is a facility to reset the configuration back to factory settings.
6.5.2 Main menus
6.5. Monitoring perspective

25
Action
Back to view selector
Disconnect
Exit
Action
Refresh status
Refresh everything
Tabs rotation
Full screen
Restore perspective
Action
Preferences
Description
Saves the workspace state and returns to the view selection perspective
Closes application Centreon Map and all connections to Centreon server
Description
Refreshes the status of the objects of the current view
Refreshes all the data of the objects of the current view
Toggles the tabs rotation
Activates full screen, to desactivates it, press F11
Restores windows and default positions of the perspective
Description
Displays the preferences dialog
6.5.3 Toolbars
The main toolbar is comprises two parts. The first part, on the left and detailed below, is common to the whole
perspective and sports global features.
Action
Back to view selector
Windows management
Full screen
Refresh status
Refresh everything
Tabs rotation
Open problematic elements window
Description
Saves the workspace state and returns to the view selection perspective
Opens the windows manager, this feature is detailed further on
Activates full screen, to deactivate it, press F11
Refreshes the status of the objects in the current view
Refreshes all the data of the objects in the current view
Toggles the tabs rotation
Quick display of the list of problematic elements
The second is context-specific and depends on the selected view open in the workspace.
26

Action
Zoom +
Zoom Zoom levels
Export the screen
Print the screen
Show / hide text
Enable / disable tooltip
Automatic order
Show / hide grid
Add a legend
Open parent
Previous
Next
Save position
Restore position
Description
Zoom on the current screen
De-zoom on the current screen
Specifies the zoom level of the current screen
Exports the content of the current screen as an image
Prints the content of the current screen
Shows / Hides the objects label in the current screen
Shows / Hides tooltips in the current screen
Show / Hide info balloons, activated when the mouse hovers over an item
Displays the grid and the magnetic positioning mode
Displays a legend of load link colors
Displays the parent object of the editor
Displays the previous object of the current screens navigation history
Displays the next object of the current screens navigation history
In geographic mode, saves the current zoom level and lat / long position
In geographic mode, restores the saved zoom level and lat / long position
Each objects zoom settings, label display and automatic positioning are preserved on the server.
Tooltips and grid parameters are stored locally along with the workspace state.

27
6.5.4 Context menus
Most application items presented have right-click context menus.

Wherever an object is located, the context menu defines the available actions for its particular state.
The screenshot above shows the menu in its entirety in order to present all functions accessible through it.
The first 9 menuitems and the 17th menuitem, Create a Shortcut, are for building and navigating the workspace.
The following 3 menuitems are content-editing actions.
Acknowledge,Downtime and status checking are specific monitoring actions, these originate from Nagios and are
not detailed here.
The last 3 menuitems facilitate access to the supervised Centreon resource.
28

Action
Open in new screen
Open in the same screen
Open in a new information
screen
Open in the same information
screen
Open in a new detailed tab
Open in the current detailed tab
Display relations in new editor
Display relations in current
editor
Open log
Add a container
Rename
Delete
Acknowledgement
Downtime
Status check
Change style
Create a shortcut
RDP Client
Telnet console
SSH Console
Description
Displays the selected item in a new edition screen
Displays the selected item in the current screen or opens a new one
Displays the tooltip of the selected item in a new dedicated screen
Displays the tooltip of the selected item in its dedicated screen or opens a new
one
Displays the selected item in a new Details window
Displays the selected item in the current Details window or opens a new one
Shows the relationships of the selected item in a new dedicated screen
Shows the relationships of the selected item in its dedicated screen or opens a
new one
Shows a new Logs window corresponding to the selected item
Creates a container with the selected item as parent
Renames the selected item
Removes the selected item
Takes into account the status of the selected item
Declares a downtime for the selected item
Performs an immediate or scheduled check for the status of the selected item
Changes the style of the selected item
Creates a shortcut to the selected item
Opens a RDP command prompt to the selected server
Opens a telnet console to the selected server
Opens an SSH console to the selected server

29
6.5.5 Windows
Explorer window
In the workspace, the explorer window shows all the items in a tree-structured view.
The root element is the view itself, its children are the various user-added elements. For clarity, services and unsupervised elements (shapes, images, links, etc..) do not appear in this list.
An option permits the display of the services of each host. Warning : this can be the cause of delay when views contain
thousands of elements.
This window has two applicable ways of being filtered to facilitate the view of desired items:
Filter by state, the colored knobs correspond to the default state colors.
When a knob is deselected, all tree items whose status is that of the knob will be hidden. By default, all knobs are
selected and therefore all items are displayed. * Filter by label, using the text field at the top of the tree. When a string
is entered, only the elements whose label match are displayed. (For convenience, this search field is case-insensitive ).
Both filters can be combined for greater precision in the selection of items.
30

In this window, as is the case with most of the components from the monitoring perspective, a context menu is available
by right-clicking on the items presented. This menu will be detailed later in this document.
Double-clicking on a tree item opens the selected item in the current screen, displaying the children and other details
not displayed in the tree (such as links, shapes and images).
Mini-map window
The mini-map shows an overview of the current screen.

It offers an overview of its contents and displays the states of the elements in real time as the screen.
It facilitates the navigation of elements, particularly with very large screens, using a user-defined blue frame to limit
the area of interest.
Acknowledgements and Downtime windows

31
Windows Acknowledged and Downtime present all taken into account and downtime elements of the current
view regardless of their hierarchical level.
Warning: only resources in the current view appear in these windows.
Resources windows
32


33
Resources windows display all objects monitored by Centreon.

By default, they are piled in the bottom left corner of the workspace as shown earlier in the document. Each window
handles a specific object type:
The hosts,
34

The host groups,

The service groups,
Meta-services,
The Centreon Business Activity Monitoring (BAM)
These windows are only available to administrator-slot users because they entail the creation of views.
To create a corresponding Centreon Map object, simply drag any of these resources into either the edition screen or
Explorer window.
These created Centreon Map objects display Centreon information such as status as well as additional information
specific to Centreon Map including icon, position, and inherited status.
Such objects appear in the corresponding screen and in the tree view.
The resource windows have a filter: similar to the explorer window, the search masks elements whose label does not
contain the search string.
This behavior is similar in all Centreon Map and needs no further introduction.
The hosts window, however, has an additional search feature: a button by the search field toogles whether the search
targets the name or IP address. (Otherwise, all resource windows use the same configurable search component.)
Beside the standard search facility, there is a mini-tree button which hides all elements in the tree view already present
in the main current view.
On the righthand side of the mini-tree button, the mini-tree button, a yellow button to refresh the windows contents.
(Note: the contents of these windows cannot be changed after a restart of the poller).
Images window

35
The Images window is part of the resource windows in the sense that it presents objects for creating views.
However it differs from other resources windows as it does not have elements monitored by Centreon*. These images
are still from the server **Centreon and can be managed via this interface.
In addition it is the only window resource whose content can be modified via Centreon Map. Indeed, the user can
add images using the Centreon Map client and thus indirectly on Centreon in two different ways :
The button Add an image displays a dialog box for selecting an image file on the local machine.
Dragging an image file onto an edition screen view or to the explorer window as a drop target.
In both cases, the new image is added to the Image window contents and to Centreon server.
Centreon Map History window
This window displays the various important Centreon Map events, such as logins, status changes, etc..
Problematic elements window
The problematic elements window offers a concise view of all objects whose own status or inherited status is not
OK.
36

This window also allows you to sort items by columns and features a customizable search component. This allows you
to select the columns on which the search is performed. All elements that do not match the search string are hidden.
The same object can appear multiple times in this table if present in different screens. This feature allows access to
the different locations of the object.
Warning: only resources in the current view appear in this window.
Details window
The Details window is a dynamic: the contents depend on the element associated with the window. This window can
be opened by double-clicking a host object or via the context menu of most Centreon Map objects.
It presents in detail the children of the selected item.
This window has essentially the same search and sort functions as the problematic elements window.
Yet it offers two additional options:
The button Include sub-elements, represented by little green cubes, displays the full object hierarchy in the
view.
The Lock / Unlock button enables the object associated with this window to be changed by merely clicking
on a screen or tree.
( Whereas the default behavior would require a double-click or access to a context menu)

37
Logs window
The logs window displays the historical monitoring data created by the scheduler. It is available via the menuitem
Open log from a host or service context menu.
The log entries are categorized and displayed in tabs. The first of these is a flat list of all entries regardless of category.
This window has the same options Include sub-elements and Lock / Unlock as the window details.
Windows manager
The windows manager enables the opening and closing of context-free windows in the workspace. (These are views
and windows that are not bound to any particular selected object)
38

Some windows, however, are not context-free windows but rather contextual: such are Details and Logs windows.
These refer to a selected object and are outside of the window managers sphere of control.
When displaying the windows manager, only the windows open in the workspace appear checked. When the windows manager dialog box is validated, the unchecked windows are closed, the checked windows opened each at their
previous location.
6.5.6 The screen (editors)

View edition screen
The Editing Screen view is the central component of the application. This is the graphical component that provides
the most thorough and precise monitoring information.
Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and
/ or inherited status.
The central part is the elements own status, the surrounding circle being its inherited status. This provides a succinct
view of an objects status and that of its children.
In addition, it is possible to navigate through the objects on the edition screen:
Double-click to enter an element containing children,
Using the Parent button to go back one level in the tree.
Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the host
dummy in the previous screenshot.
This operation can be performed by the interface Centreon.

39
When the mouse hovers an icon, the application displays a contextual tooltip, which presents all the information
available for this item. The content of the tooltip differs depending on the selected element.
(The above screenshot shows the tooltip for the host UNREACHABLE).
The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globally
via the Preferences module detailed in this manual.
The Edition screen also provides a range of features.
Tools are available by clicking the icon in the palette; selecting a tool changes the cursor icon and the corresponding
action available on the screen.
The palette, accessible by administrator-slot users only, is located on the right-hand side of the screen otherwise by
default it is hidden.
Action
Simple selection
Multiple selection
Rectangle / Ellipse
Text
Basic link
Status link
Load link
Disconnection
Link template
Description
Allows to select any item on the screen and move it by drag / drop.
Allows to select a group of elements
Adds the corresponding shape to the screen
Adds an editable text to the screen (font, size and color are customizable)
Creates a simple link between two elements
Creates a status link between two elements
Creates a load link between two elements
Deletes a link between two elements
Creates a link from a predefined template
Shapes abstract individual objects into a single logical group on the screen.
Since version 3.4 of Centreon Map, shapes take on the color of the status of the most critical sub-element. The
various options available for shapes are available by right-clicking.
Relationships screen
Centreon, relying on the host dependency configuration, allows the scheduler to determine whether a host
is unavailable or inaccessible.
As of version 3.5 of Centreon Map, these relations can be viewed by right-clicking on a host, with the action Display
relations in new editor.
40

Three different representations exist:

Radial (host-centered selection)
Tree (selected host is the tree-top node)

41
Spring (hosts are grouped into blocks - rendering may vary from one display to another)
These three rules apply:
42

Only children of the selected host are displayed.

The branches where there is no child available (ACL) are automatically dropped.
If a host of a branch is not accessible (ACL), but its children are available, only the host status is displayed.
The Relationships perspective shows all host relationships irrespective of the host limitations configured for the view.
Therefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows.
Geoagraphic screen
Since version 3.6 of Centreon Map, elements can overlay a map using their long/lat coordinates.
Maps are provided by the means of a third-party mapping service : MapBox.
Since version 3.7 the Google Maps mapping service is not supporter anymore.
Configure geolocation
Activation of geolocation in Centreon Map, requires specific configuration in Centreon. Indeed, this feature relies
on an external mapping service to Centreon Map. It is necessary to open a user account with one of these service
providers.
MapBox free account allows 3,000 downloads for free per month. Beyond this limit, the use of this service costs
around a dollar per 2,000 downloads (current prices on March 1st 2014).
The configuration is made on the page Centreon > Administration > Extensions > Centreon Map > Geolocation.
Once the process of opening a MapBox account is finished, copy the default API access token present on top of the
MapBox page into the field MapBox API access token of the configuration page.
At last, create a new project in the MapBox interface and copy its ID into the field MaBox Project token.

43
Activate geolocalisation
In a standard view edition screen, right click on the background, open the context menu and select the action Edit.
The following dialog appears and allows, had the map ID been configured in Centreon, to activate the geographical
mode and enter the long/lat coordinates.
44

Navigate within a map
Geolocation-enabled, the screen background is replaced by a map having the lat/long coordinates as the center and a
zoom level between 1 and 21.
Zoom level 1 represents the full world map, each successive level focuses on half of the previous view with twice the
detail.
Two user actions trigger a request to the mapping service:
A map relocation : this can be done in 2 ways, either by a drag/drop of the map or by direct access to a known
lat/long, being a saved position or the position of one of the elements on the map
change the zoom level, using the main toolbar or via the mouse wheel by holding the ctrl key.
Viewpoints:
The map view is defined by having a particular position and a particular zoom level. We shall henceforth refer
to the this position/zoom pair as being a viewpoint. Centreon maps has an active viewpoint and a default
viewpoint.
The active viewpoint determines the area displayed on the screen, it is modified for every displacement or
zoom change and can be saved as the default viewpoint via the toolbar, this viewpoint is never synchronized
between clients.
The default viewpoint establishes the initial coordinate and zoom level view of a map. This viewpoint is
maintained on the server and transmitted to other users. At any moment, the user can revert to the default
viewpoint via the toolbar.
Map Element Positioning: Recollect that a Centreon resource can be multiply represented by dragging and dropping
the resource on the map many times.
There are two manners to organise such host elements on the map.

45
With resource-defined positions, all resource map elements that ascribe to a Centreon resource will be positioned at the resources coordinates.
Editing the resourcess coordinates will displace all elements as one logical block.
With element-defined positions, host-mapped elements are freely placed on the map - each independent of the
other.
( Note : that this is only possible when the hosts coordinates are NOT defined )
When an object of the current map is selected in either the Explorer window or the problematic elements window, the
current map is automatically centered to its coordinates. This allows instant access to its immediate surroundings.
Abstraction: As map elements become ubiquitous on the screen, it becomes rapidly evident that such need to be
abstracted into more manageable constructs. Centreon maps provides containers to logically group related
elements and therefore filter the information from the data, shielding the user from irrelevant details. As well
as being map elements, containers have viewpoints. Each container is capable of portraying a viewpoint of the
map. The containers position as an element on the screen is used as a reference point for its internal viewpoint.
(A containers default view and element position are strongly bound concepts - updating the coordinates of
either updates both.) Typically, the user will define a containers viewpoint such that all child elements be
within scope. Containers are also able to embed other containers recursively - this is a powerful paradigm for
complexity management.
[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clients
discretion. Additional costs and fees incurred by a third party service are the full responsibility of the client,
MERETHIS cannot be held accountable. The Centreon Map license, updates and support do not include
professional services MapBox and Google Maps. Ultimately, Merethis cannot be held accountable for any
professional, technical or financial prejudice due to a total or partial failure of the third party mapping service
The tooltips screen
46

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner.
The above image depicts the service type Ping as a graph, showing the evolution of pings within the monitoring
perspective.
Depending on the element type, this sort of visual representation can be made manifest by double-clicking or using a
context menu.
Tabs rotation
In the former screenshot, there are 10 tabs grouped into 4 zones. Each zone is composed of at least one tabbed screen,
of which only one can be active at a time.
Tab rotation revolves around the zones list of tabbed screens a regular and configurable interval in order to have a
global vision of the workspace without requiring human intervention.
6.5.7 The links

The object link type is purely Centreon Map concept, it is not supervised object and is only a visual help.
A link can be created between any elements in an view edition screen, with the exception of text objects.
In addition it is possible to create multiple links between two objects. They are created, modified and deleted using
the corresponding tools in the palette of the view edition screen.

47
There are 3 different types of links used to emphasize different aspects.

Basic link
The basic link is used to link elements of the screen without displaying additional monitoring information.
These links have configurable properties:
a type (basic, status or load)
a name and a description
the lines width
a line type, continuous, dotted, etc..
a style, direct that displays a direct line or indirect with a right angles
a color
48

Status link
The status link is a basic link having a fixed system-defined line type, style and color whilst able to display the status
of a service.
To be associated to a status link, a service must be configured for this purpose in Centreon : it must be associated
to a category that is associated with this type of link. This configuration is established in the Centreon interface,
Administration > Extensions > Centreon Map tab

49
The link then displays the status of the configured service.

This feature is particularly useful for modeling connectivity between two devices.
The load link (unidirectional or bidirectional)
The bi-directional load link, similar to the status link, has fixed visual link properties.
Similar to the status link, it is associated with a service but instead displays metrics about the service.
50

To be associated with a load link, a service must be configured for this purpose in Centreon : it must be associated with
a category that is associated with this type of link. This configuration is done in the Centreon interface, Administration
> Extensions > Centreon Map tab
The load link models the rate of flow between two devices.
Typically it is used to model the state and bandwidth of the network.
Since version 3.5, the load links can be unidirectional and also the user can define what metrics to display, what is the
current value and what is the max value.
6.5.8 Warnings
When changing to a critical state, an error or any other significant event, Centreon Map alerts the user in two ways:
visual feedback, as a colored popup at the bottom right of the screen
sound event
Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved.
In this example there is a loss of connection between the client and the server, the popup appears in red as it is important
information, a specific sound is also played.
6.5.9 Preferences
In Centreon Map, many features are configurable: you can customize the size of icons, the colors used to indicate
different status, etc..

51
Remote access
These preferences configure various settings of the remote access. The above screenshot shows the configuration
screen of the 3 default access protocols.
The tab Custom configures other actions by associating a name to an executable path and arguments. For this
purpose, predefined variables are shown in the submenu Informations.
52

Drilldown
The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm.
The first checkbox Use simple drilldown options is enabled by default. Unchecked, it activates the advanced configuration mode, presented by the lower screen.

53
In advanced mode the user can customize the rules for: * computing the inherited status of acknowledged or downtime
items. * the order of criticality.
The two following checkboxes are available in simple mode. They determine the exclusion of acknowledged or
downtime resources from the algorithm.
The checkbox Display poller-down status, this refers to a new status specific to Centreon Map. This condition
occurs when a poller is out of order. All monitored elements depending on the defective poller enter poller-down state.
Use soft statutes for inherited status when available lets the algorithm rely on unconfirmed states for inherited state
54

processing. This is more efficient but less reliable.

The last check box excludes the internal links of a container from the inherited state calculation.
Ensuing any change, it is necessary to reload the statutes of the view for it to be applied.
Warning: Incorrect configuration of these options can completely thwart the supervision. Be careful!
Graphics
This preference page allows the user to customize various visual settings:
The style determines whether the objects displayed in screens are represented by an icon or a geometric shape.
The police is for all on-screen text.
The space between the icons is that used when they are placed automatically.
blinking allows easier visualization of problematic elements.
The unit selected is used to display load links.
Show services in tree will cause services to be displayed in the Explorer. Note : This option can slowdown the processing as it increases the tree items by an order of magnitude.
55
The Rotate delay determines the time between each tab rotation.
This preference page allows the user to apply geometric styles of differing shapes and sizes to items.
This preference page allows you to change the shapes and sizes of items for the geometric style.
The lower preference page allows the user to pick a geometric shape to represent a discrete state.
These settings do not affect the style icon.
56


57
With the following preferences page the user can customize how an element icon is represented for every discrete state.
In particular, this involves setting the color and opacity of the surrounding halo for a given state in a given condition.
Finally the color, opacity, and the relative size displayed depending on each status can also be changed.
Warning: Incorrect configuration of these options can completely thwart the supervision. Be careful!
58

Tooltip
On this preference page, the tooltip can be disabled for all screens of the current view.
Other options such as graph displaying and the period displayed can be set here.
Finally, the dimensions of the tooltip can also be defined.

59
Links Templates
This preference page allows you to create link templates.

A user-created template has the same properties of the link type on which it is based.
Created templates are available in the palette of the view edition screen.
When creating a link from the template, the link automatically takes on the template-defined properties without further
user interaction.
When a link template is changed the changes are automatically applied to all links associated with the template.
However, it is possible to override one or more properties of a link associated with a template. Such properties are not
affected by the modification of the template.
60

Popup
The popup preferences page addresses the properties of two different popups in Centreon Map.
The first two forms relate to the warning popup. It can be totally disabled or more finely configured to appear
only for certain events. The color associated with each event can also be set individually.
The Poller alert options concern the dialog that appears when a poller connection drops.
The addition of the new status Poller down deprecates this alert and the above preferences allow you to disable or
automatically close this dialog.

61
Sounds
Sound settings allow you to choose which sound is to be associated with each state change.
62


Centreon Map Enaa

Uploaded by

Copyright:

Available Formats

Centreon Map Enaa

Uploaded by

Document Information

Original Description:

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Centreon Map Enaa

Uploaded by

Copyright:

Available Formats

Centreon Documentation

July 28, 2015

Supported Java versions

Required modules and softwares

Activation, collection and presentation of RRDTool performance graphs in Centreon

3.1 Install for Centreon enterprise server

3.2 Package install

3.4 Web install

Click on the installation icon of the centreon-map-server module.

Click on the uninstall icon.

6.1 Main Concepts

6.1.2 Used objects

6.2 Licence system

6.2.1 User license

6.2.2 Administrator license

Chapter 6. User guide

6.3 Login screen

6.3.1 Profiles management form

6.3. Login screen

It is possible to store the configuration of different connection profiles.

Chapter 6. User guide

6.3.2 Servers management form

6.3. Login screen

6.3.3 Proxys management form

Chapter 6. User guide

6.4 View Selection Perspective

6.4.1 Menus and toolbars

6.4. View Selection Perspective

Toolbar and search bar

The toolbar provides quick access to the main functions.

Chapter 6. User guide

6.4. View Selection Perspective

View creation dialog

Chapter 6. User guide

Launcher file creation dialog

6.4. View Selection Perspective

6.4.2 Import lat/long data

Chapter 6. User guide

6.4. View Selection Perspective

6.5 Monitoring perspective

Chapter 6. User guide

6.5.2 Main menus

6.5. Monitoring perspective

Chapter 6. User guide

6.5. Monitoring perspective

6.5.4 Context menus

Most application items presented have right-click context menus.

Chapter 6. User guide

6.5. Monitoring perspective

Chapter 6. User guide

The mini-map shows an overview of the current screen.

6.5. Monitoring perspective

Chapter 6. User guide

6.5. Monitoring perspective

Resources windows display all objects monitored by Centreon.

Chapter 6. User guide

The host groups,

6.5. Monitoring perspective

Chapter 6. User guide