Build Procedure

To build the Merlin installation you need to checkout the Merlin project from CVS. The commands in this document assume a unix-style system; the procedure under windows is similar, and identical if you have cygwin installed.

$ cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic login
$ cvs -z3 -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic co avalon/meta/
$ cvs -z3 -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic co avalon/merlin/

Once checkout is complete you can build Merlin using Maven as follows:

$ cd avalon/meta
$ maven avalon:dist
$ cd ../merlin
$ maven merlin:install

The above build procedure will create a installation directory containing the Merlin system at

+-- avalon
  +-- merlin
    +-- target
      +-- merlin

Copy the merlin directory to your preferred location.

Copy the 'merlin' directory to your preferred location installation location. For example, you may want to copy the installation dir to the /opt dir:

$ cp -Rf merlin/target/merlin /opt/merlin-SNAPSHOT
$ ln -s /opt/merlin-SNAPSHOT /opt/merlin

Declare MERLIN_HOME environment variable

To use Merlin command line support or the Merlin NT Service you will need to define the MERLIN_HOME environment variable for your system and include MERLIN_HOME/bin in your system path:

$ echo '
> # set location of merlin
> export MERLIN_HOME=/opt/merlin
> # include it in the path
> export PATH=$PATH:$MERLIN_HOME/bin
> ' >> ~/.bash_profile
$ source ~/.bash_profile

Validating your installation.

The following instructions assume that you have defined the MERLIN_HOME environment variable that points the directory containing the Merlin installation.

To confirm that you MERLIN_HOME variable is correct, you should open a new command line window and invoke the Merlin CLI application. The following command should list the Merlin CLI help information.

$ merlin.sh -help
usage: merlin [block] [-debug] [-config <file>] [-lang
<code>] [-repository <directory>] [-kernel <file>] [-home
<directory>] [-version] [-help]
...

Next Steps

Now that you have installed Merlin on your system you can proceed to the Using Merlin tutorial page.