OP5 Monitor - How to fix missing locations in Geomap?

The geomap functionality in OP5 monitor allows you to map out objects on a map, as well as links between the objects. Geomap requires certain XML files to exist, have correct permissions, and have valid contents. These files are placed in:

/opt/monitor/op5/ninja/application/config/geomap

The correct ownership of *.xml is apache:apache. Incorrect permissions may manifest, for example, as nothing happening when you press "Save" for a new location.

At the very least, the following files must exist and have correct permissions:

• links.xml
  • This file contains links between locations.
• locations.xml
  • This file contains locations. A location can contain a host object, but it's not required for the object to show up. This host object cannot be empty or null, this will hide the object -- fix the object or remove it completely.
• settings.xml
  • This file contains geomap settings, such as which provider to use for displaying the map.

Improving readability

XML files are saved as one single line. To improve readability, you can run them through tidy:

# cat locations.xml | tidy -xml -qi

This will make location objects with nested objects (hosts, services, etc.) significantly easier to spot.