~hww3/caudium

ref: 93d5a75fba08db71b832716377276978cdd7888d caudium/INSTALLING -rw-r--r-- 6.3 KiB
93d5a75fWilliam Welliver storage: method "None" was missing stop function. should fix error on shutdown 1 year, 12 days ago
                                                                                
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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
Before Installing:

There are a few required packages for installing Caudium.  Most are included
with your distribution.  The configure script should alert you to anything
that is missing, but here is a list of packages that you will most likely
have to install yourself.

NOTE: If you're upgrading from a previous version of Caudium, please read 
the README file, which contains a list of suggestions for ensuring a 
smooth and successful upgrade process.

Required Packages:
  Pike 7.6:
    You will need version 7.6.112 or newer. Caudium 1.4 will not be
    able to run with older pike (eg pike 7.5, 7.2, 7.1, 7.0, 7.4 or 0.6).

    NOTE: some users have reported difficulty using the Mysql support 
    included with versions of Pike between 7.6.66 and 7.6.112. A fix for 
    this bug has been submitted to the Pike team and should be available 
    with releases of Pike after 7.6.112.

    You may apply the change directly to your existing Pike 7.6.112  
    source directory; download the latest version of mysql.c from the Pike 
    website:

    http://pike.ida.liu.se/cvs/Pike/7.6/src/modules/Mysql/mysql.c?1.93

Optional Packages (recommended)
  Sablotron (requires expat)
    In order to use the XSLT parser you will need to get the Sablotron
    XSLT parser package.  This is highly recommended.  As of version 0.50,
    you will need to install the expat libraries.  You can get these two
    packages from:

      Expat:
       http://sourceforge.net/projects/expat/ 
      Sablotron:
        http://www.gingerall.com/

  MySQL or other SQL packages
    If you want to use an SQL database backend with Caudium, then you need
    to have it installed BEFORE building Pike.  You can get MySQL from
    http://www.mysql.com/

  PHP
    See http://caudium.net/server/docs/related/php4.rxml

Tuning Notes
++++++++++++

Caudium is designed to operate with a minimum of dedicated resources. 
However, as a non-forking webserver, there are some special considerations 
you should keep in mind when deploying Caudium. 

1. Most operating systems have a default limit of 256 file 
descriptors per process. This low limit most commonly results in a "No 
more file descriptors" error. This usually happens when you have many 
virtual servers or experience a spike in traffic. Setting this value to 
2048 or more usually provides better results.

Unfortunately, every operating system has different limits and means for 
altering these limits. On many modern operating systems, the system wide 
limit is set sufficiently high that you can use the "ulimit" command 
before starting Caudium to increase these limits. 

Some useful links are provided below that may provide additional insight 
into the file descriptor limit situation for your particular OS:

Solaris: http://www.unixguide.net/sun/faq/3.48.shtml
MacOS X: http://www.amug.org/~glguerin/howto/More-open-files.html
Linux: http://bloggerdigest.blogspot.com/2006/10/file-descriptors-vs-linux-performance.html
FreeBSD: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/configtuning-kernel-limits.html

----------------------------------------------------------------------------

Installing Caudium 1.4 from source:
+++++++++++++++++++++++++++++++++++

  1. Get the source server package.

  2. Issue the command to unpack the archive:

          .tar.gz:
               If you have GNU tar; "tar xzf Caudium-archive-name"
               If you don't have GNU tar: 
               "gunzip < Caudium-archive-name| tar xf -" 
          .tar.Z
               If you have GNU tar; "tar xzf Caudium-archive-name"
               If you don't have GNU tar: 
               "uncompress < Caudium-archive-name| tar xf -"
          .tar
               "tar xf Caudium-archive-name"

     (where "Caudium-archive-name" is the name of the Caudium archive
     file.).

  3. Type "cd <caudium_version>" to change to the new directory. This
     directory should contain at the very least four directories:
     server (Caudium server source), src (extra pike modules), extern
     (misc. programs used by Caudium) and tools (misc tools). See README
     for more information about the directory structure.

     (Where caudium_version is the name of the unarchived Caudium directory.)

 4.  Type ./configure --prefix=<wanted_base_path_for_caudium>
     (prefix is optional and defaults to /usr/local, thus placing Caudium in
     /usr/local/caudium/) followed by make and make install to build
     the binaries and copy them to the correct place.

!!!  By default, the configuration will fail if the Sablotron XSLT
!!!  library isn't found. If you are not interested in XSLT
!!!  functionality, just add the flag '--without-PiXSL' to the
!!!  configure script.

     You can later on move the 'caudium' directory that will be
     created when you type 'make install' to anywhere in your
     filesystem. Caudium does not keep any absolute paths.
     
  5. If everything worked fine and the compilation is done, type 
     cd <dir>/server.

     (Where <dir> is <wanted_base_path_for_caudium>/caudium if you used 4.)

  6. Start the install script by typing ./install. (skip this step if 
     you're upgrading from a previous version of Caudium).

  7. Answer the simple questions and wait for your client.

  9. If everything worked, configure the server, otherwise move on to the
     troubleshooting section on the Caudium WWW-pages. 

 10. In order to start your server in the future (from startup scripts, etc)
     cd to <dir>/server and run ./start-caudium. It often makes sense to 
     run this command with the --once option, so that you can see the 
     results of the startup on your terminal, making any troubleshooting 
     much simpler. Once everything is verified to be working, you can shut 
     down and restart without the --once option.

 Once you have installed the server, consider joining the Caudium
 mailing list by subscribing on the following URL :

   http://lists.oav.net/wws/subrequest/caudium-general

 For more information about Caudium, read the online documentation at
 http://caudium.net/

----------------------------------------------------------------------------
Example installation session:

bash$ tar xzf caudium-1.4.6.tar.gz
bash$ cd caudium-1.4.6
bash$ ../configure --prefix=/usr/www

<various checks...>

bash$ make 

<compilations>

bash$ make  install
bash$ cd /usr/www/caudium/server
bash$ ./install

<answer a few questions>