Create your first site
Now we're cooking. In just a few minutes we're about to have a comprehensive IT monitoring solution ready for production.
Creating a site
ICheckmk sets itself apart by allowing you quickly and easiliy create multiple monitoring sites (instances) which is extremely important in practice: you can run several instances on the same server or distributed (across a datacenter, geographically, etc.), running different versions and they are all independent of each other. This powerful feature provides many benefits but the two most common usages are:
trying out new Checkmk versions
operating a test site before applying an upgrade
We learned in the previous section that once installation is finished we have access to a new command called omd which allows us to create and manage checkmk.
In order to create a new site you simply run the following command:
root@linux# omd create mysite
Adding /opt/omd/sites/mysite/tmp to /etc/fstab.Creating temporary filesystem /omd/sites/mysite/tmp...OK
Updating core configuration...
Generating configuration for core (type cmc)...Creating helper config...OK
Created new site mysite with version 2.0.0.cee.
The site can be started with omd start mysite.
The default web UI is available at http://linux/mysite/
The admin user for the web applications is cmkadmin with password: CMysgT87
For command line administration of the site, log in with 'omd su mysite'.
After logging in, you can change the password for cmkadmin with 'htpasswd etc/htpasswd cmkadmin'.
Thats it! With that simple command you now have a site that is ready to begin monitoring your systems, applications, clouds and much more.
Starting your site
As evidenced by the message resulting the omd create command, you need to start your site. This is simply accomplished by running the following command:
root@linux# omd start mysite
You will need the automatically generated password to login to your site. Also, if you hostname is not resolavable via DNS you will most likely need to access your site by using the IP address of your server as follows: http://192.168.2.43/mysite.
To verify the status of your site you can run omd status as follows:
OMD[mysite]:~$ omd statusmkeventd: running
Overall state: running
Your output may vary depending on the edition you are using. For example the RAW edition does not contain the Micro Core but rather Nagios as the core.
Now that you've started the site we can login via the main page. Each site has its own unique URL consisting of the IP/Hostname and site name: http://<hostname>/<site name>. Access your URL in your browser and when presented with the login page, enter your username (cmkadmin) and the generated password and click "Login"
If your website is not started you will get a message saying "OMD: Site not started". This is your hint that maybe you've not started the site or there is a problem starting it (extremely rare). If you get a "Not Found" error than its quite clear that Checkmk is not aware of a site with that name and maybe you should check your spelling.