FAQ

Questions frequently asked on our support platform will be reported and answered here.

Feel free to ask any help you may need as much as give us any feedbacks on our commercial support platform.

Should my Map 4 server be on a dedicated server or on the Central ?

The server has to be installed on a dedicated machine.

The main reason is that if your Map 4 server start requiring a lot of resources (because many users are connected or your Broker is sending a lot of events for instance), it will not put in danger your Central, Engine and Broker.

Are resources not yet deployed in real time displayed in Centreon Map 4 ?

The answer is YES.

When you add a new resource to your Centreon, it’s automatically displayed and accessible in Map 4, in the ‘Resources’ panel.

../_images/resource_part.png

We did that so you can already start making your views before starting the monitoring. By doing so, you can prepare all your monitoring environment and, when you deploy your configuration, you already have fully functionnal monitoring from Map 4.

Can I access my views through a mobile or a tablet ?

You can access all your views from a mobile device by using the web client. Whether you are using an Android, an IPhone, a Blackberry or a Windows phone device, you can access them as long as your device has a web browser.

However, your mobile device must have access to your Map 4 server on the port used by your Map 4 server (8080 for classic configuration, 8443 for secured configuration). If not, you will have an authentication error displayed on the Map 4 web client.

How to change Map 4 port ?

By default your Map 4 server is listening and sending information through the port 8080. If you have set the SSL (cf SSL configuration with a recognized key) the port is 8443.

You can change this port (if, for instance, you have a firewall on your network blocking these ports).

Warning

If the new port you want to set is lower than 1024, please follow these instructions instead.

On your Map 4 server, stop tomcat

# service tomcat6 stop

Edit the server.xml settings file located in /etc/tomcat6/server.xml

# vim /etc/tomcat6/server.xml

And, in the following lines

<Connector port="8080"
            protocol="HTTP/1.1"
            connectionTimeout="20000"
            redirectPort="8443" />

replace port=”8080” by the port you want.

Then restart your tomcat

# service tomcat6 restart

After 30 seconds test that your server is up and accessible on the new port you defined by entering the following URL in your web browser:

http://<IP_MAP_4>:<NEW_PORT>/centreon-studio/docs

How to change Map 4 port under 1024

You may want to setup your server to listen and send data through ports under 1024, such as port 80 or 443 (as these ports are rarely blocked by any firewall).

In the case where you want to set a port lower than 1024, the method is different since all ports under 1024 have a restricted access and only special applications can access them.

There are a few different methods to get around this issue. We are going to focus on one of them: Create a port forwading thanks to the firewall.

Note

For this example, let’s say we want to make our Map 4 server listen and send data through the port 80.

In your case, replace each occurences of 80 by the port you want to use.

  1. Check that your firewall is running

On you Map 4 server, check that your firewall is running by executing the following command:

# service iptables status
Table: raw
Chain PREROUTING (policy ACCEPT)
num  target     prot opt source               destination

Chain OUTPUT (policy ACCEPT)
num  target     prot opt source               destination

Table: mangle
Chain PREROUTING (policy ACCEPT)
num  target     prot opt source               destination
...
...
...

If your firewall is stopped you will see the following output:

iptables: Firewall is not running.

Start it by executing:

# service iptables start
  1. Allow a connection on the port you want your Map 4 to listen and send data

Enter the following lines in your console:

# /sbin/iptables -A OUTPUT -p tcp --dport 80 -j ACCEPT
# /sbin/iptables -A INPUT -p tcp --dport 80 -j ACCEPT
  1. Add the port forwarding

Execute the following line in your console:

# iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 8080
  1. Restart and save

Restart your firewall:

# service iptables restart

Save this configuration so it will be applied on each reboot of your server

# /sbin/iptables save

You are all set ! Your Map 4 server is now accessible on the 80 port. To check it, enter the following URL in your browser:

http://<IP_MAP_4>/centreon-studio/docs

You should see this page:

../_images/server-api-rest.png

Warning

Don’t forget to update your desktop client configuration and your web client configuration! For your web client, follow these steps For your desktop client, see how to setup a server connexion here

How to run multiple Centreon Map versions on my desktop

Warning

Only excute this procedure if you know what you’re doing or you may have to reinstall your Centreon Map desktop client.

This procedure is not documented for Linux

In case you want to try out a new minor version, major version or our unstable version, you may need to run multiple Centreon Map desktop versions.

To do so, first download the target version you want to run, then :

  • Install it in a non-default destination folder, in our example, we rename the folders & installation to : CentreonMap4-unstable
  • DO NOT run the client just after the installation or it will update your current version and you’ll have to re-install it.
  • Modify the Eclipse.ini that you should find here :

On Windows

C:\users\<YOUR_USERNAME>\AppData\Locale\Centreon-Map4-unstable\Centreon-Map4.ini

On MacOS

/Applications/Centreon-Map4-unstable.app/Contents/Eclipse/Centreon-Map4.ini

And modify the following line to add the ‘unstable’ to Centreon-Map4 :

-data
@user.home/Centreon-Map4-unstable

Now you can start your ‘unstable’ desktop version.

In case you accidentally update your stable version, uninstall all versions and re-install the stable client.