# Guide: Installation & Setup of the CheckMK Plugin (CheckMK 2.3.0 and later)

## 1. Installing the Plugin

### CheckMK Enterprise or Cloud Edition

1. Download the latest `.mkp` file from the Ferrari Electronic download page:
   👉 [https://download.ferrari-electronic.de/monitoring/check_mk/](https://download.ferrari-electronic.de/monitoring/check_mk/)
2. Log in to the CheckMK Web interface.
3. Navigate to **Setup → Maintenance → Extension packages**.
4. Select **Upload package** and upload the downloaded `.mkp` file.
5. Confirm the upload.

### CheckMK Raw or Free Edition


1. Connect to your CheckMK server via SSH or open a terminal session.
2. Sign in to your site using `su - <site>`
2. Download the latest `.mkp` file from the Ferrari Electronic download page:
   👉 [https://download.ferrari-electronic.de/monitoring/check_mk/](https://download.ferrari-electronic.de/monitoring/check_mk/)
3. Change to the directory containing the downloaded `.mkp` file.
4. Run the following command to install the plugin:
  ```
  mkp add officemaster_suite_v2-v1.x.x.mkp
  ```

---

## 2. Adding a Host & Activating the Plugin

### 2.1 Adding a Host

* If you don’t yet have a host configured for your Officemaster server:

  1. Go to **Setup → Hosts → Hosts → Add host**.
  2. Enter the hostname under **Basic settings**.
  3. Enter the server’s IP address under **Network address**.
  4. Save.

* If the host is already configured:

  * Confirm you have set a valid IP address
  * Continue with 2.2.

---

### 2.2 Activating the Plugin

1. Navigate to **Setup → Agents → Other integrations → Applications → Ferrari Electronic Officemaster Suite**.

2. Create a new rule.

> ⚠️ When updating the plugin from **version 1.0.4 or older** to **version 1.0.5 or newer**, any existing host rules for the Officemaster Suite **must be deleted and recreated** to ensure all new functionality is applied correctly.

3. Adjust parameters if needed (default values shown below):

   | Parameter  | Default value   |
   | ---------- | --------------- |
   | IP-Address | `localhost`     |
   | Port       | `3216`          |
   | Username   | `admin`         |
   | Password   | `OfficeMaster!` |

4. Under **Explicit hosts**, select the host you want to monitor.

5. Save and **Activate changes**.

---

### 2.3 Discovering Services

* Go to **Setup → Hosts → Hosts** and select the host you created earlier.
* Run a **Full service scan**.
* You should now see the Officemaster components being monitored.