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. Some useful options available are:

1.2.5. Get development branch

If you want to experiment the incomming features of the next releases... this section is for you XD. We strongly recommend use stable versions for production environments.

Our development branches of Monkey are located in a GIT repository, in order to get the development code please install the git tools and perform the following command:

        $ git clone git://repo.or.cz/MonkeyD.git
      

1.2.6. 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.10.0-git
      Built : Oct 26 2009 14:35:22
      Home  : http://monkeyd.sourceforge.net
      * 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