We use cookies to ensure that we give you the best experience on our website.  Visit our Privacy Policy to learn more. If you continue to use this site, we will assume that you are okay with it.

Your choices regarding cookies on this site.
Your preferences have been updated.
In order for the changes to take effect completely please clear your browser cookies and cache. Then reload the page.

Checkmk 1.6 has arrived! Learn more about it here!

Administrating monitoring instances

Checkmk Manual
Last updated: April 4 2019

Search in the manual

Open the main menu of the web interface and click on the menu item instance administration. In this dialogue box, you have access to all monitoring instances of this device. You can configure, update and delete monitoring instances as well as create new ones.

The first time you open the dialogue box it will be empty. To create your first monitoring instance, click on the button Create instance. In the dialogue box that then appears, you can specify the initial configuration of the monitoring instance.

Start by entering an instance ID, which serves to identify the monitoring instance. The instance ID may only contain letters, numbers, - and _, must start with a letter or _ and may be a maximum of 16 characters in length.

Now select the Checkmk version with which to create the monitoring instance.

You can leave all other settings as they are for the time being. You can change these settings later on using the instance editing dialogue.

As soon as you confirm the dialogue box with Create instance, the new monitoring instance will be created. This may take a few seconds. Once the instance has been created or started, you will be taken to the list of all monitoring instances.

In this list, you will see the instance just created with the ID sysmon. You can also see the status of the instance, where "active" means the instance has been fully started. You can start or stop the instance with the button to the right of the status. On the left you will see different icons, with which you can a) edit the settings of the instance, b) update the instance and c) delete the instance.

After the instance has been created and started, you can either click on the instance ID or enter the URL for the monitoring instance http://<ipaddress>/<instanz-id>/ (in this case into the address bar of your browser.

You will now see the login screen of the monitoring instance, where you can log in using the access data you entered when creating the instance. Once you have logged in you can set up Checkmk in the usual manner. The snap-in Checkmk Appliance is available in all monitoring instances and for all administrators. You will find it in the sidebar. This snap-in will take you from your monitoring instances directly to the web interface of the device.

1. Migrating existing sites

It is a common case to migrate existing sites from other Linux systems to a Checkmk appliance. The Checkmk appliance offers a migration dialog which is performing the migration for you.

The following requirements need to be met:

  • You need to have a network connection between the source system and your device.
  • The Checkmk version of the source site needs to be installed on your device (Architecture changes from 32-bit to 64-bit are possible).
  • The source site needs to be stopped during migration.

Open the main menu of the web interface and click on the menu item Instance Administration. Then click on the button Migrate Site.

In this dialogue, you first need to configure the host address (host name, DNS name, IP address) the source system, which you want to migrate the site from. Now you need to enter the site ID of the site you want to be migrated.

The migration of the site is done via SSH. To get access to the source site, you need to provide the credentials of a user which is able to connect to the source system and access all files of the source site. You can use the root user of the source system or, if you have configured a password for the site user, you can use the site user credentials.

Optionally you can choose to let the migration create the site with a new site ID on your device.

Additionally you have the option to skip the performance data (measurements, graphs) and historic monitoring data during migration. This can be useful if you don’t need an exact copy of the source site and only want to copy it e.g. for testing purposes.

After filling the dialogue and confirming it by clicking the start button. The following dialogue will show you the progress of the migration.

After completion of the migration you can finish the migration by clicking on Complete. Now you can configure and control the new site in the instance administration dialogue.