Installation

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-sandbox/merlin/

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

$ cd avalon-sandbox/merlin
$ maven merlin-dist

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

+-- avalon-sandbox
  +-- merlin
    +-- target
      +-- inst

Copy inst 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>] [-system <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.