There are two supported ways to change the configuration of your OP5 Monitor:
- Using the web UI OP5 Monitor configuration tool;
- Using the REST API.
We will discuss the API as a configuration tool in a later chapter. This chapter will take a look at how to use the OP5 Monitor Configuration tool, which henceforth we will call Configure.
OP5 does not support editing configuration files directly!
Editing OP5 configuration files directly (in other words: in '/opt/monitor/etc' on the OP5 server) is not supported!
OP5 Monitor uses Livestatus to parse the configuration files based on a temporary save file and a comparison to the database content. Any manual edits could conflict with Livestatus data as well as anything passed to the API.
We need to make this as clear as possible. Many people reading this Guide may come from Nagios administration, where editing the configuration files and creating new files are commonplace. We beg of you to leave these files alone. Please let our complex of miniature databases serve your higher goals.
Most of the configuration in op5 Monitor is saved in configuration files (text files) in /opt/monitor/etc/. The Configure works with a database and this makes it possible to do changes in the configuration without saving it to file before all configuration is done. The table below describes the workflow:
You (as an admin) open Configure.
This triggers Livestatus to compare the config files and the Nacoma database content:
|3||You edit configuration objects: hosts, services, contacts, groups, templates, commands.|
Click the Submit button at the bottom of the object just added or changed.
|5||Edit or create another configuration object.|
|6||Once you finish editing the configuration objects for a session, save the Configure database to the configuration files by clicking Save.|
Livestatus runs a pre-flight check to verify the configuration changes before exporting them to the configuration files:
|8||Naemon, the main engine of OP5 Monitor, restarts. It also runs a verification ("
|9||Naemon triggers Merlin to synchronize with pollers and peers.|