Course content

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
OK
Restarting Apache...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 status
mkeventd:       running
liveproxyd:     running
mknotifyd:      running
rrdcached:      running
cmc:            running
apache:         running
dcd:            running
redis:          running
crontab:        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.

Logging in

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"

                         
Checkmk login page
                 

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.

Views
3 Total Views
3 Members Views
0 Public Views
Actions
0 Likes
0 Dislikes
0 Comments
Share on Social Networks
Share Link
Share by mail

Please login to share this webpage by email.