Installation

Currently, the only way to obtain resmon is via git. Check it out into the installation directory (/opt/resmon is a good choice):

git clone git://labs.omniti.com/resmon.git /opt/resmon

You will need to create a configuration file in order for resmon to work. Start by copying the resmon.conf.sample file to /opt/resmon/resmon.conf and editing it. See the Configuration Section for help configuring resmon.

Starting resmon

Resmon can be started simply by running the resmon command. By default, it will use the config file at /opt/resmon/resmon.conf and will detach and become a daemon. To prevent resmon from daemonizing, add the -d option.

Once you have things up and running, you will probably want to install resmon as a service. A Redhat init script and Solaris SMF manifest file are provided to help you with this. You can use these as follows:

Redhat

cp /opt/resmon/resources/resmon_redhat_rc /etc/init.d/resmon
chkconfig resmon on
/etc/init.d/resmon start

Debian/Ubuntu

cp /opt/resmon/resources/resmon_debian_rc /etc/init.d/resmon
update-rc.d resmon defaults
/etc/init.d/resmon start

Solaris

svccfg import /opt/resmon/resources/resmon-manifest.xml
svcadm enable resmon

FreeBSD

cp /opt/resmon/resources/resmon_freebsd_rc /usr/local/etc/rc.d/resmon
/usr/local/etc/rc.d/resmon start

And add the following to /etc/rc.conf:

resmon_enable=YES

If you have a custom config file location, you can also add:

resmon_flags="-c /opt/resmon/resmon.conf"

to /etc/rc.conf.

Moving from subversion to git

  • The easiest way is to move the original svn checkout aside, then make a new git checkout in its place:
    mv /opt/resmon /opt/resmon.oldsvn
    git clone git://labs.omniti.com/resmon.git /opt/resmon
    
  • Any local changes can be copied in place - use svn st and svn diff to find any changes.