Caudium HOWTO

David Gourdelier

And other contributors 
Caudium Group

September 2002

Revision History
Revision 2.22002-09-20dg
Few more fixes, document now contains images and icons. See revision history for more information.
Revision 2.12002-06-14dg
Document is now well-formed XML, one more example. See revision history for more information.
Revision 2.02002-06-14Tab
Converted to DocBook XML 4.1.2. See revision history for more information.
Revision 1.02002-06-06dg
Initial release
Revision 0.91 
Indentation of the SGML document and one more paragraph. See revision history for more.
Revision 0.9 
This Howto is going into stable state. See the revision history for more information.
Revision 0.052002-04-04 
This HOWTO is in the DocBook format. See the revision history for more information.
Revision 0.04 
Added Introduction and license. See the revision history for more information.
Revision 0.03 
Added some useful corrections. See the revision history for more information.
Revision 0.02 
Minor correction in other answers. See the revision history for more information.
Revision 0.012002-03-11 
Initial revision. See the revision history for more information.

Abstract

This is the Caudium HOWTO. This document will give an overview of the Caudium server. New users will learn how to set a basic virtual server up. More experienced users will find useful tips on development and optimization. Finally at the end I give some documentation on Caudium top priorities for people who want to contribute.


Table of Contents

1. License
2. Overview
1. What is Caudium?
2. Caudium vs Roxen: Why a fork?
3. Comparing Caudium with Apache
4. Advantages of Caudium
5. Disadvantages of Caudium
3. Getting packages
1. How to get packages for Debian GNU/Linux
2. How to get packages for FreeBSD
3. How to get packages for Solaris
4. How to get CAMAS from CVS/source
4. Creating your first server
1. Installing Caudium from sources
2. Starting
3. Stopping from command line
4. Directory organization
5. Upgrading Caudium
6. Configuration InterFace (CIF.)
7. Adding your first server
7.1. Server variables
7.2. Selecting file system
7.3. Creating a virtual server
5. Customizing your server
1. How to run Caudium as a non-privileged user; How to secure Caudium
2. How to benchmark a web server
3. How to tune your system for best Caudium performances
3.1. Linux
3.2. FreeBSD
3.3. Solaris 2.x
4. How to use your own fonts
5. How to get UltraLog working
6. Developing with Caudium
1. Your first RXML file
2. The Pike tag
3. Your first Pike script
4. Your first module
5. How to use a backtrace
6. How to print something to debug log file
7. How to help the Caudium community
1. How to promote Caudium
2. How to write documentation
3. How to get a CVS account
4. How to test Caudium
5. How to send a bug report
8. Revision History/Credits/The End
1. Revision History
2. Credits and contributors
3. The End
A. GNU Free Documentation License
1. PREAMBLE
2. APPLICABILITY AND DEFINITIONS
3. VERBATIM COPYING
4. COPYING IN QUANTITY
5. MODIFICATIONS
6. COMBINING DOCUMENTS
7. COLLECTIONS OF DOCUMENTS
8. AGGREGATION WITH INDEPENDENT WORKS
9. TRANSLATION
10. TERMINATION
11. FUTURE REVISIONS OF THIS LICENSE
12. How to use this License for your documents

List of Figures

4.1. Ports in the CIF
4.2. Filesystem in the CIF
4.3. Example of output

List of Examples

4.1. Your user filesystem.
4.2. A simple virtual hosting regular expression.
4.3. A better and quicker regular expression.
6.1. Some simple RXML tags.
6.2. The PHP documentation as a Pike tag.
6.3. A basic Pike script.
6.4. A real world script.
6.5. A script for the power user.
6.6. A sample module.