MAP troubleshooting
This chapter shows some guidelines on how to troubleshoot your MAP installation.
centreon-map-engine and all its dependencies cannot get installed on Alma Linux 8
Symptom
You get a GPG error during the installation of OpenJDK 17 preventing centreon-map-engine and all its dependencies from being installed.
Problem
You are not importing the right repository.
Solution
Run the following command to import the right repository:
rpm --import https://repo.almalinux.org/almalinux/RPM-GPG-KEY-AlmaLinux
"Failed to authenticate" error when connecting to the MAP homepage
Symptom
A "Failed to authenticate" error occurs in the MAP homepage when trying to connect to the Centreon MAP service.
Problem
The credentials used by the Web interface user (defined during the installation) to connect to the MAP module are no longer valid because they have been changed, probably due to a password expiration.
Solution
You can update the password by accessing this file: /etc/centreon-map/map-config.properties.
MAP configuration is not working in HTTPS
Symptom
The MAP configuration is not working. This issue occurs when the MAP module is installed on the Centreon central server while the MAP platform is secured in HTTPS.
Problem
The MAP configuration is not set in TLS.
Solution
If you are using IPv6, you need to force the MAP server to use IPv4.
Go to the /etc/centreon-map/centreon-map.conf file.
Edit the file by adding the following option:
RUN_ARGS="--spring.profiles.active=prod,tls"
JAVA_OPTS="-Djava.net.preferIPv4Stack=true -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/log/centreon-map -Dcentreon-map.signing-key=8uT4BM1RsXRmIPQbTEazUAhQHtyM7xZ4nlFMIUqQ7lRkbWz24yemkGs9tS4eOwDfF -Dcentreon-map.access-token-validity-seconds=15552000 -Xms512m -Xmx4G"
Make sure you installed the correct RPMs
Run the following command:
- Alma / RHEL / Oracle Linux 8
- CentOS 7
- Debian
dnf info centreon-map-web-client
dnf info centreon-map-server-engineyum info centreon-map-web-client
yum info centreon-map-server-engineapt info centreon-map-web-client
apt info centreon-map-engineIn the output, Repository should read centreon-stable-noarch. If this is not the case, you do not have the correct packages installed. Do the following :
- Alma / RHEL / Oracle Linux 8
- CentOS 7
- Debian
sudo dnf install centreon-map-web-client
sudo yum install centreon-map-web-client
sudo apt install centreon-map-web-client
Increase the logs level
To increase the logs level, edit the /etc/centreon-map/map-log.xml file by changing the following entries to INFO:
<logger name="com.centreon.studio" level="INFO" />
<logger name="org.springframework" level="INFO" />
<logger name="org.springframework.web" level="INFO" />
<logger name="org.apache" level="INFO" />Restart your centreon-map-engine server:
systemctl restart centreon-map-engine
Run our diagnostic tool
Run the following script:
cd /etc/centreon-map
./diagnostic.shAll entries should be set to OK or INFO.
Try to solve any errors using the guidelines below.
If you still have an error, send us the complete output of the script (see the Still stuck? section).
Here are the main errors that you can encounter:
Database connection or authentication: if any of these are not OK, check your credentials, network, and mysql users.
########## Database connection ##########
[ok] Connection to centreon
[ok] Connection to centreon_storage
[ok] Connection to centreon_mapConnection to broker output: if this is not OK, check broker output configuration, network, and TLS configuration (if used).
########## Broker connection ##########
[ok] Connection to 127.0.0.1 5758 portConnection or authentication from MAP NG to central server: if this is not OK, check your credentials, network, proxies, and TLS configuration (if used).
########## Authentication ##########
[ok] Centreon Central authentication using user admin
Debug problems with the web interface
Make sure the URL specified in Administration > Extensions > MAP > Options is reachable (both reachable and resolvable) from the computer accessing the web interface.
Check the status of MAP by opening the following URL in the browser (use the same values for MAP_IP_ADDRESS and MAP_PORT as the ones defined in Administration > Extensions > MAP > Options).
http://[MAP_IP_ADDRESS]:[MAP_PORT]/centreon-map/api/beta/actuator/health
Example:
http://10.0.0.2:8081/centreon-map/api/beta/actuator/health
The result should be as follows:
{
"status" : "UP"
}If not, send us a screenshot of the error (see the Still stuck? section).
Still stuck?
If you still need help, please contact the Centreon support team with the basic information about the way Centreon MAP is installed.
Here is an example for a standard installation:
Central | MAP | MAP (Legacy) | |
---|---|---|---|
Is there a direct connection between this element and the central (are they on the same network?) | n/a | Y | Y |
Is this element installed on the same server as the central? | n/a | Y | N |
Is HTTPS enabled? | Y | Y | Y |
Is it a new installation? | N | Y | N |
Output of diagnostic.sh
See above Run our diagnostic tool and send us the complete output of the script.
Provide the following log files (default paths):
Centreon MAP server:
/var/log/centreon-map/centreon-map-engine.log
Centreon Central server:
/var/log/php-fpm/centreon-error.log
Screenshots from the web interface
If you encounter issues on the web interface, please provide us with screenshots of the interface with the error, with the browser Dev tool opened on the following tabs:
- Network tab (F12 key), if possible filtered on failing requests.
- Console tab (F12 key), if possible filtered on errors.
Output of yum list
command
Run the following commands and send us their output:
On the central:
yum list centreon-map-web-client --showduplicates -q
On the server where centreon-map-engine is installed:
yum list centreon-map-engine --showduplicates -q