| 1 |
== link:index.html[Index] -> link:basics.html[Getting started] -> link:basics_installation.html[Installation] |
|---|
| 2 |
|
|---|
| 3 |
Installation on Unix |
|---|
| 4 |
-------------------- |
|---|
| 5 |
|
|---|
| 6 |
If you have a prepackaged version of Cherokee available in your |
|---|
| 7 |
Unix/Linux favorite variant, please use the provided installation |
|---|
| 8 |
mechanism of choice. This will provide you with automatic bootup |
|---|
| 9 |
scripts, consistency and dependency checks, and an easy upgrade path |
|---|
| 10 |
tailored to your system whenever a new package is available. |
|---|
| 11 |
|
|---|
| 12 |
If you do not find a prepackaged version that suits your needs, you |
|---|
| 13 |
can always download and compile your own. |
|---|
| 14 |
|
|---|
| 15 |
[[quickstart]] |
|---|
| 16 |
Quickstart |
|---|
| 17 |
~~~~~~~~~~ |
|---|
| 18 |
|
|---|
| 19 |
. link:basics_download.html[Download] a fresh copy of Cherokee |
|---|
| 20 |
. Configure the package for your system: |
|---|
| 21 |
+ |
|---|
| 22 |
----------------------------------------- |
|---|
| 23 |
./configure --localstatedir=/var \ |
|---|
| 24 |
--prefix=/usr \ |
|---|
| 25 |
--sysconfdir=/etc \ |
|---|
| 26 |
--with-wwwroot=/var/www |
|---|
| 27 |
----------------------------------------- |
|---|
| 28 |
|
|---|
| 29 |
. Compile the package: |
|---|
| 30 |
+ |
|---|
| 31 |
----------------------------------------- |
|---|
| 32 |
make |
|---|
| 33 |
----------------------------------------- |
|---|
| 34 |
|
|---|
| 35 |
. Install the programs and any data files: |
|---|
| 36 |
+ |
|---|
| 37 |
----------------------------------------- |
|---|
| 38 |
make install |
|---|
| 39 |
----------------------------------------- |
|---|
| 40 |
|
|---|
| 41 |
. Start link:bundle_cherokee-admin.html[cherokee-admin] |
|---|
| 42 |
|
|---|
| 43 |
[[advanced]] |
|---|
| 44 |
Advanced parameters |
|---|
| 45 |
~~~~~~~~~~~~~~~~~~~ |
|---|
| 46 |
|
|---|
| 47 |
If you want to learn more about 'configure' you can run `./configure |
|---|
| 48 |
--help`. |
|---|
| 49 |
|
|---|
| 50 |
[grid="rows"] |
|---|
| 51 |
``~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 52 |
Parameter, Description |
|---|
| 53 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 54 |
`--with-wwwroot=DIR` , Specify the webserver root directory |
|---|
| 55 |
`--disable-epoll` , Disable epoll() support |
|---|
| 56 |
`--disable-pthread` , Disable threading support |
|---|
| 57 |
`--disable-readdir_r`, Disable readdir_r usage |
|---|
| 58 |
`--disable-ipv6` , Disable IPv6 support |
|---|
| 59 |
`--disable-pam` , Disable PAM support |
|---|
| 60 |
`--enable-trace` , Allows debugging options |
|---|
| 61 |
`--disable-admin` , Skips cherokee-admin installation |
|---|
| 62 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 63 |
|
|---|
| 64 |
[[autostart]] |
|---|
| 65 |
Autostart |
|---|
| 66 |
~~~~~~~~~ |
|---|
| 67 |
|
|---|
| 68 |
If you need the cherokee webserver to start at boot (through init's |
|---|
| 69 |
runlevel) you can find a start/stop script in the contrib source |
|---|
| 70 |
directory: |
|---|
| 71 |
|
|---|
| 72 |
----------------------------------------- |
|---|
| 73 |
cp contrib/cherokee /etc/init.d/ |
|---|
| 74 |
----------------------------------------- |
|---|
| 75 |
|
|---|
| 76 |
Additionally, you need to create symlinks at the correct rc directory |
|---|
| 77 |
of the appropriate runlevel. This can be done in many ways and usually |
|---|
| 78 |
each distribution offers its own tools to do so. |
|---|
| 79 |
|
|---|