1.2. Installation

1.2.1. Requirements

Monkey uses very low CPU and Memory consumption, it should work on any x86 platform without problems. We have not tested yet on older hardware such as 486. do you want to help us ? :)

Regarding to the software required to run Monkey successfully, you will need a Linux environment with Kernel version 2.6.29 (at least). The server is developed on top of the Kernel features, so use an older version can cause some buggy behaviors.

Besides the kernel version, the core of Monkey just requires two basic libraries: pthreads and libc, if you use Linux, we are 99% sure that you should not care about this requirement.

1.2.2. Download

Monkey is mainly distributed in a compressed tarball which contains the full source code, the available releases can be found in the official site http://www.monkey-project.com. At the moment of this document is written, the 0.10.0 version is available. You can find more details in the Downloads section.

1.2.3. Configure and compile

Once you get the tarball you can use the following simple steps to configure and compile the source code:

• tar zxfv monkey-0.10.xyz.tar.gz

• cd monkey-0.10.xyz

• ./configure

• make

1.2.4. Specific configure options

Monkey uses a similar autotools scripts to configure and set the proper enviroment. Also, you can configure Monkey with your specific paths, just run './configure -h' to get a full list of the available options as:

monkey@monkey-project.com:~/MonkeyD$ ./configure -h

Usage: configure [--prefix=PREFIXDIR] [ --bindir=BINDIR]
         [--sysconfdir=SYSCONFDIR] [--datadir=DATADIR]
         [--logdir=LOGDIR] [--plugdir=PLUGDIR]

Options: 
 --help		           Display this help and exit
 --version		   Display version information and exit
 --debug		   Compile Monkey with debugging symbols
 --trace		   Compile Monkey with trace messages (don't use in production)
        
 --prefix=PREFIX	   Install Monkey under PREFIX directory
 --bindir=BINDIR	   Install Monkey binaries under BINDIR directory
 --sysconfdir=SYSCONFDIR   Install Monkey conf files under SYSCONFDIR dir
 --datadir=DATADIR	   Install Monkey data dir files under DATADIR directory
 --logdir=LOGDIR	   Install Monkey log files under LOGDIR directory
 --plugdir=PLUGDIR	   Target directory for Monkey plugins

1.2.5. Running Monkey web server

Monkey configuration system is designed to let run the service from the local directory without an installation process unless you specify an installation directory in the configuration step using the --prefix option.

If the compilation process has ended successfully, you are ready to run Monkey Web Server executing the following command:

      $ bin/monkey 
    

once the server has started up, you should get something like this in your console:

Monkey HTTP Daemon 0.11.0
Built : Jul 16 2010 14:35:22
Home  : http://www.monkey-project.com
* Process ID is 8532
* Server socket listening on Port 2001
* 5 threads, 202 client connections per thread, total 1010

by default, Monkey listen for incomming connections on TCP port 2001, give it a try using your favorite web browser at http://127.0.0.1:2001