# checkmk_v2

# Installation

## Automatic (recommended)

Download the latest `officemaster_suite_v2.mkp` file and run `mkp install officemaster_suite_v2.mkp` while logged in to your checkmk site account (`su - <sitename>`)

## Manual

Move the files according to the table below:

### Linux:

| Filename | Filesize | Directory |
|----------|----------|-----------|
| officemaster_suite_v2.py | 2kB | /opt/omd/sites/<site>/local/share/check_mk/web/plugins/wato |
| agent_officemaster_suite_v2 | 1kB | /opt/omd/sites/<site>/local/share/check_mk/checks |
| agent_officemaster_suite_v2 | \>7MB | /opt/omd/sites/<site>/local/share/check_mk/agents/special |
| officemaster_suite_v2_components.py | 4kB | /opt/omd/versions/2.0.0p6.cre/lib/python3/cmk/base/plugins/agent_based |

<hr>

# Setup Host

```
Warning: Messaging Server Version 7.2.1 and up does not listen to the IPv4 Any-Address anymore. Make sure to configure the GateKeeper component to listen for IPv4! Or use IPv6 instead.
```

On the frontend, go to `Setup -> Hosts -> Hosts -> Add host`,
enter your hostname under `Basic settings` and IPv4 address under `Network address`. Hit `save`.
Go to `Setup -> Agents -> Other integrations -> Other integrations -> Ferrari Electronic [...]`.
Create a new rule and fill out the start parameters that are different than the default values as seen below. You can leave the IP-Address field empty if you configured an IPv4 or IPv6 beforehand.

You need to set "Explicit hosts" and add your desired host to ensure only specific hosts are monitored.

Now go back to `Setup -> Hosts -> Hosts` and select the host your created beforehand. Hit `Full service scan` and you should see many components monitored.

| Parameter | Default value | CLI Tag |
|-----------|---------------|---------|
| IP-Address | localhost | \-url |
| Port | 3216 | \-port |
| Username | admin | \-u |
| Password | OfficeMaster! | \-p |