Install xymon server on FreeBSD

       230 words, 2 minutes

Because it takes only a few minutes to do and because I didn’t find any tutorial on the Net, here’s my notes to get Xymon server running on FreeBSD.

Install Xymon server

Add the package and set the start parameter:

  # pkg_add -r xymon-server
  
  # echo 'xymon_server_enable="YES"' >> /etc/rc.conf

Configure Xymon server to check it-self:

  # vi /usr/local/www/xymon/server/etc/hosts.cfg
  (...)
  127.0.0.1 localhost # bbd http://localhost/

Setup some permissions, start the daemon and check that it works:

  # chown xymon /usr/local/www/xymon/server/www
  
  # /usr/local/etc/rc.d/xymon-server start
  
  # tail /var/log/xymon/xymond.log 
  2012-06-02 11:03:15 Setup complete

Install the Web server

Xymon server listens on port 1984 but you need a Web server to actually see the GUI. I’m using lighttpd here as it is tiny and fast:

  # pkg_add -r lighttpd
  
  # echo 'lighttpd_enable="YES"' >> /etc/rc.conf
  
  # vi /usr/local/etc/lighttpd/modules.conf
  (...)
  "mod_alias",
  (...)
  include "conf.d/cgi.conf"
  (...)
  
  # vi /usr/local/etc/lighttpd/conf.d/cgi.conf
  (...)
  cgi.assign = ( ".sh"  => "/bin/sh" )
  (...)
  
  # vi /usr/local/etc/lighttpd/lighttpd.conf
  (...)
  var.server_root = "/usr/local/www/xymon/server/www"
  (...)
  server.document-root = server_root + "/"
  (...)
  alias.url += ( "/xymon/" => server_root + "/" )
  alias.url += ( "/xymon-cgi/" => "/usr/local/www/xymon/cgi-bin/" )
  (...)
  #var.vhosts_dir  = server_root + "/vhosts"
  (...)
  server.document-root = "/usr/local/www/xymon/server/www/"
  (...)
  
  # /usr/local/etc/rc.d/lighttpd start

Now, browse http://localhost/xymon/ and watch your Xymon instance working.

Note that the xymon-seccgi is not configured here. Should you want to use it, create the alias for it and set the credentials to secure the access.