== 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 [wiki:Configuration 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.