1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
<html>
<head>
<title>Compiling and installing on Unix</title>
<link href="media/css/documentation.css" type="text/css" rel="stylesheet" />
</head>
<body>
<h1>Compiling and installing on Unix</h1>
<div class="section" id="dependencies">
<h1>Dependencies</h1>
<p>The following requirements exist for building Cherokee:</p>
<ul class="simple">
<li>Building tools: Cherokee is built on top of the autoconf and automake
tools, hence your systems has to have some basic system programs like a sh
shell, make and an ANSI C compiler. We have compiled Cherokee in various
platforms with different compilers, so it shouldn't be a problem.</li>
<li>Optional:<ul>
<li>Python: Cherokee includes a number of Quality Assurance tests
written in Python language. If you are planning to contribute code
into the project, or you just want to test everything is working in
the server, you will need a Python interpreter installed on your system.<ul>
<li>Python docutils: in order to generate the documentation from text files.</li>
</ul>
</li>
<li>TLS libraries: Cherokee supports two different SSL/TLS
libraries: OpenSSL and GNUTLS. You need to have one of those libraries
with its development files.</li>
</ul>
</li>
</ul>
</div>
<div class="section" id="the-simplest-way">
<h1>The simplest way</h1>
<p>First, <a class="reference external" href="download.html">download</a> a fresh copy of Cherokee, then run:</p>
<ul class="simple">
<li>$> <strong>./configure --localstatedir=/var --prefix=/usr --sysconfdir=/etc
--with-wwwroot=/var/www</strong> To configure the package for your system.</li>
<li>$> <strong>make</strong> To compile the package.</li>
<li>$> <strong>make install</strong> To install the programs and any data files.</li>
</ul>
</div>
<div class="section" id="others-parameters">
<h1>Others parameters</h1>
<p>If you want to learn more about <tt class="docutils literal"><span class="pre">configure</span></tt> you can run <strong>./configure --help</strong></p>
<table class="docutils">
<colgroup>
<col width="39%" />
<col width="61%" />
</colgroup>
<thead valign="bottom">
<tr><th class="head">Parameters</th>
<th class="head">Description</th>
</tr>
</thead>
<tbody valign="top">
<tr><td><tt class="docutils literal"><span class="pre">--with-wwwroot=DIR</span></tt></td>
<td>Specifies the Root directory</td>
</tr>
<tr><td><tt class="docutils literal"><span class="pre">--disable-epoll</span></tt></td>
<td>Disable epoll() support</td>
</tr>
<tr><td><tt class="docutils literal"><span class="pre">--disable-pthread</span></tt></td>
<td>Disable threading support</td>
</tr>
<tr><td><tt class="docutils literal"><span class="pre">--disable-readdir_r</span></tt></td>
<td>Disable readdir_r usage</td>
</tr>
<tr><td><tt class="docutils literal"><span class="pre">--disable-ipv6</span></tt></td>
<td>Disable IPv6 support</td>
</tr>
<tr><td><tt class="docutils literal"><span class="pre">--disable-pam</span></tt></td>
<td>Disable PAM support</td>
</tr>
<tr><td><tt class="docutils literal"><span class="pre">--disable-tls</span></tt></td>
<td>Disable TLS/SSL support</td>
</tr>
<tr><td><tt class="docutils literal"><span class="pre">--enable-tls=</span></tt></td>
<td>gnutls|openssl</td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="install-and-config-directories">
<h1>Install and config directories</h1>
<p>If you need to auto-start cherokee at boot (through init's runlevel) you can
find a start/stop script in the contrib source directory:</p>
<pre class="literal-block">
cp contrib/cherokee /etc/init.d/
</pre>
<p>Additionally, you need to create symlinks at the correct rc directory of the
appropiate runlevel. This can can be done in many ways and usually each distribution
offers its own tools to do so.</p>
</div>
</body>
</html>
|
