| 1 | .. _kernel-installation-prereq: |
|---|
| 2 | |
|---|
| 3 | Prerequisites |
|---|
| 4 | ============= |
|---|
| 5 | |
|---|
| 6 | :Last Updated: $Date: 2011-07-16 13:26:31 +0000 (Sat, 16 Jul 2011) $ |
|---|
| 7 | :Id: $Id: install-prerequisites.txt 272 2011-07-16 13:26:31Z djay $ |
|---|
| 8 | :Author: $Author: djay $ |
|---|
| 9 | :HeadURL: $HeadURL: trunk/docs/kernel/install-prerequisites.txt $ |
|---|
| 10 | |
|---|
| 11 | .. contents:: Table of Contents |
|---|
| 12 | :depth: 2 |
|---|
| 13 | :backlinks: top |
|---|
| 14 | |
|---|
| 15 | Obtaining the ZOO Kernel Source |
|---|
| 16 | ------------------------------- |
|---|
| 17 | |
|---|
| 18 | .. _svn: |
|---|
| 19 | |
|---|
| 20 | Use the following command to get the ZOO Kernel source code through Subversion: |
|---|
| 21 | |
|---|
| 22 | :: |
|---|
| 23 | |
|---|
| 24 | svn checkout http://svn.zoo-project.org/svn/trunk zoo-project |
|---|
| 25 | |
|---|
| 26 | For users which get a developer account, use the following: |
|---|
| 27 | |
|---|
| 28 | :: |
|---|
| 29 | |
|---|
| 30 | sed "s:\[tunnels\]:\[tunnels\]\nzoosvn = /usr/bin/ssh -p 1046:g" -i ~/.subversion/config |
|---|
| 31 | svn co svn+zoosvn://svn.zoo-project.org/var/svn/repos/trunk zoo-project |
|---|
| 32 | |
|---|
| 33 | The first line of the instruction above defines a specific tunnel to access the svn server through |
|---|
| 34 | the SSH protocol. Indeed, the ZOO SVN server listens on the 1046 (1024+22) port rather than the default one (22). |
|---|
| 35 | |
|---|
| 36 | Prerequisites |
|---|
| 37 | ------------- |
|---|
| 38 | |
|---|
| 39 | The following libraries are required on your system before you can install the ZOO Kernel: |
|---|
| 40 | |
|---|
| 41 | - autoconf ( http://www.gnu.org/software/autoconf/ ) |
|---|
| 42 | - cgic ( http://www.boutell.com/cgic ) |
|---|
| 43 | - cURL ( http://curl.haxx.se ) |
|---|
| 44 | - FastCGI ( http://www.fastcgi.com ) |
|---|
| 45 | - Flex & Bison ( http://flex.sourceforge.net/ http://www.gnu.org/software/bison/ ) |
|---|
| 46 | - libxml2 ( http://xmlsoft.org ) |
|---|
| 47 | - OpenSSL ( http://www.openssl.org ) |
|---|
| 48 | - Python ( http://www.python.org ) |
|---|
| 49 | |
|---|
| 50 | Optional libraries include: |
|---|
| 51 | |
|---|
| 52 | - PHP Embedded (optional) ( http://www.php.net ) |
|---|
| 53 | - Java SDK (optional) ( http://java.sun.com ) |
|---|
| 54 | - SpiderMonkey (optional) ( http://www.mozilla.org/js/spidermonkey/ ) |
|---|
| 55 | |
|---|
| 56 | Compile libcgic |
|---|
| 57 | --------------- |
|---|
| 58 | |
|---|
| 59 | The first step is to compile libcgic from the ``zoo-project/thirds`` directory. For such a task, please use |
|---|
| 60 | the following command: |
|---|
| 61 | |
|---|
| 62 | :: |
|---|
| 63 | |
|---|
| 64 | cd thirds/cgic206 |
|---|
| 65 | make |
|---|
| 66 | |
|---|
| 67 | Make sure that a ``libcgic.a`` is created in your ``zoo-project/thirds/cgic206`` directory. If yes, then |
|---|
| 68 | you can go to the next step. |
|---|
| 69 | |
|---|
| 70 | On Windows, rather than using the make command, please use: |
|---|
| 71 | |
|---|
| 72 | :: |
|---|
| 73 | |
|---|
| 74 | nmake /f makefile.vc. |
|---|
| 75 | |
|---|
| 76 | .. warning:: |
|---|
| 77 | If you don't compile libcgic first, and try to compile the ZOO Kernel, you will get an error such as *cannot find -lcgic* |
|---|
