CheckMK Rail2 Mark I User manual

Check_MK rail2 Mark I - Quick start
Valid since version 1.4.6

Contents
1 Quick start guide 1
2 Shipment 2
3 Hardware 3
3.1 Connectors .................................................. 3
3.2 Switching the appliance on and off ................................... 3
3.3 Information on the SD card ........................................ 3
3.4 SD card requirements ........................................... 4
4 Appendices 5
.1 CE declaration of conformity ....................................... 5
.2 Licences ................................................... 5
.3 VMware Tools ................................................ 6
.4 VirtualBox Guest Additions ........................................ 6
.5 Legal notice ................................................. 6
©Copyright Mathias Kettner GmbH 2019 mathias-kettner.de

Check_MK rail2 Mark I - Quick start 1 / 6
1. Quick start guide
• Unpack the device and first of all check that your shipment is complete.
• An SD card is needed to operate the device and must meet the minimum requirements. Put the card
into the designated slot, making it lock into place.
• Plug in the device. When installing for the first time, you should ensure the following connections as
a minimum:
–Monitor-to-VGA connector
–USB-keyboard
–Network connection (connector: LAN1)
–Power supply
• When you switch on the power, the device will start up automatically.
• While the device is starting up, a dialogue box will appear on the screen asking you to initialise the
SD card (NOTE: All data on the SD card will be deleted!). Confirm the box. After a few minutes
the launching procedure will resume.
• On completion of the launching procedure, the console status view will be displayed.
• So that the appliance can be used for monitoring, there are some settings that need to be made. Press
the key <F1> and, using the configuration dialogue box, configure the following settings as a minimum:
–Network configuration
–Access to the web interface
• Once you have configured these settings, you can access the web interface from a computer connected
to the network by entering the URL http://<ipaddress>/ into the web browser. Log into the web
interface using the password you just configured.
• Select the item instance administration on the menu now shown and click on Create new instance on
the following page.
• Now create a new monitoring instance using the current dialogue box. This instance will start auto-
matically.
• You can now call up the URL http://<ipaddress>/<instanz-id>/ in your browser,
where you can set up Check_MK in the usual manner.
• In order to make things such as name resolution and sending emails possible, you must make further
settings in the web interface. You can read more about this in the chapter on basic configuration on
the web interface.
The full manual can be found on our website1.
1https://mathias-kettner.de/
©Copyright Mathias Kettner GmbH 2019 mathias-kettner.de

Check_MK rail2 Mark I - Quick start 2 / 6
2. Shipment
The following are included with your Check_MK rail2:
• Check_MK rail2 appliance
• Documentation
©Copyright Mathias Kettner GmbH 2019 mathias-kettner.de

Check_MK rail2 Mark I - Quick start 3 / 6
3. Hardware
3.1 Connectors
The following images show the Check_MK rail2 connectors.
images/rail2_front.png
images/rail2_back.png
For the initial configuration, you must provide the following connectors as a minimum:
• Monitor-to-VGA connector
• USB-keyboard
• Network connection (connector: LAN1)
• Power supply
Once you have completed the initial configuration, all that is needed for regular operation is the network
connection and the power supply.
3.2 Switching the appliance on and off
As soon as the power is connected to Check_MK rail2, the device will automatically switch on and start.
Caution
As far as possible, do not disconnect the appliance from the power supply without shutting down
the system first. If you do this you will risk losing data. You can find out how to shut down the
system in the chapter Control.
3.3 Information on the SD card
Your specific appliance settings are saved to the SD card as well as your monitoring configuration and
the monitoring runtime data. The appliance cannot be operated without an SD card.
Caution
The SD card must not be removed while the appliance is running, as this may cause data loss.
©Copyright Mathias Kettner GmbH 2019 mathias-kettner.de

Check_MK rail2 Mark I - Quick start 4 / 6
3.4 SD card requirements
The SD card must provide at least 4 gigabytes of storage. So that the appliance can reach its specified
performance, the SD card must support a write speed of at least 45 MB per second.
Tip
Many consumer SD cards are not suitable for permanent operation. We therefore recommend special
industry-compatible cards. You will find more about these on our website.
©Copyright Mathias Kettner GmbH 2019 mathias-kettner.de

Check_MK rail2 Mark I - Quick start 5 / 6
4. Appendices
.1 CE declaration of conformity
Mathias Kettner GmbH declares that the device described in this document is in accordance with the
essential requirements and other relevant provisions of the directive 1999/5/EC.
.2 Licences
The Check_MK appliance contains both software developed by Mathias Kettner GmbH itself and open
source software from various sources. Despite selecting the components carefully, we cannot guarantee
that components not developed by us are free from defects of title.
The following table will provide you with information on the respective software licences of the compo-
nents used.
Designation Version Licence information
Debian 7 (Wheezy) Free Software1
OMD 1.2.4 2GPL v23
pnp4nagios 0.6.21 GPL v23
nagvis 1.8 GPL v23
rrdtool 1.4.8 GPL v23
check_mk 1.2.4 GPL v23
mk-livestatus 1.2.4 GPL v23
cmc 1.2.4 Proprietary
dokuwiki 2013-05-10a GPL v23
nagios 3.5.0 GPL v23
nagios-plugins 1.5 GPL v34
pyasn1 0.1.7 BSD-Style5
pysnmp 4.2.4 BSD-Style6
pysphere 0.1.7 New BSD License7
net-snmp 5.7.2 BSD / BSD like8
mod_python 3.3.1 Apache License, Version 2.09
patch 2.6 GPL v34
nail 11.25 Free, Custom10
©Copyright Mathias Kettner GmbH 2019 mathias-kettner.de

Check_MK rail2 Mark I - Quick start 6 / 6
You can get the source codes for the open source components mentioned and any adjustments created
by us in the download center of your subscription (excludes Debian 7). You can get the source codes for
Debian 7 either at the address specified in the table or through us at a fee.
.3 VMware Tools
The firmware of the Check_MK appliance comes with the software VMware Tools (version 8.6.10.18555)
of the manufacturer VMWare11. This software is activated as soon as the firmware is started as Check_MK
virt1 in a virtual machine on a VMware hypervisor. The software is needed in order to improve the per-
formance and functionality of the virtual machine.
If you use the VMware Tools software, you must take care to do so in accordance with (EULA) licensing
conditions 12.
.4 VirtualBox Guest Additions
The firmware of the Check_MK Appliance is delivered with the software VirtualBox Guest Additions
(version 4.3.18) from the manufacturer ORACLE13. This software is activated as soon as the firmware
is started as Check_MK virt1 in a virtual machine on a VirtualBox hypervisor. The software is used to
improve the performance and functionality of the virtual machine.
The VirtualBox Guest Additions software is licensed under GPLv2.
.5 Legal notice
All information contained in this documentation has been compiled with great care, but must not be
construed as a warranty for product characteristics. Mathias Kettner GmbH shall only be liable to the
extent set forth in the Terms and Conditions of Sale and Delivery.
This manual is the property of Mathias Kettner GmbH and is protected by copyright. This document may
be neither copied, translated, transmitted, duplicated nor passed on to third parties for commercial
purposes without the prior written permission of Mathias Kettner GmbH, neither completely nor in
excerpts.
Product names mentioned in this document may be the trademarks and/or registered trademarks of
their respective owners.
1http://www.debian.org/legal/licenses/
2OMD is preinstalled in one or several versions, along with all components included in it. You can delete or replace these
versions at any time. Depending on the version, the included components and versions may vary.
3http://www.gnu.org/licenses/gpl.html
4https://www.gnu.org/copyleft/gpl.html
5http://pyasn1.sourceforge.net/license.html
6http://pysnmp.sourceforge.net/license.html
7http://opensource.org/licenses/BSD-3-Clause
8http://www.net-snmp.org/about/license.html
9http://www.apache.org/licenses/LICENSE-2.0
10 http://heirloom.sourceforge.net/mailx.html
11 https://www.vmware.com/
12 http://www.vmware.com/download/eula/universal_eula
13 http://www.oracle.com/
©Copyright Mathias Kettner GmbH 2019 mathias-kettner.de

Mathias Kettner GmbH
Kellerstraße 29
81667 München, Germany
http://mathias-kettner.de