AOLserver Wiki - User contributions [en]

AOLserver Wiki

2006-04-19T12:22:20Z

Jcollins:

'''[http://www.aolserver.com AOLserver] is a high performance web server with a powerful customization API. The AOLserver Wiki is a comprehensive resource for all things AOLserver.'''

If you're new to [[wiki]]'s, then [[Welcome, New Visitors]]! Before you start editing, you may want to read over the [[Formatting Rules]]. To find pages grouped by category, [[Special:Categories|start here]].

== Topics of Conversation ==

* [[What is AOLserver]]?
* What [[Web Applications for AOLserver]] would you like to see?
* What [[AOLserver Bugs and Problems]] are you experiencing?
* What features does AOLserver need? Add them to the [[AOLserver Wishlist]].

* [[What's new in 4.5]] -- New features in version 4.5 of AOLserver. This will be the next major release of AOLserver.

== AOLserver Resources: ==

* [[Downloads]] -- Access to various AOLserver files and resources.
* [[Modules]] -- Complete list of '''over 70''' AOLserver extension modules and other [[AOLserver Contributed Software]].
* [[Toolkits]] -- Everything you need to build a complete website, fast.
* [[Languages]] -- Build websites in a varierty of different programming languages.
* [[Documentation]] -- Tcl and C API references, tutorials and guides.
* [[FAQ]] -- Frequently Asked Questions about AOLserver.
* [[AOLserver Improvement Proposals]]
* The [[AOLserver Cookbook]] -- A collection of questions, and code examples to answer them.
* [[AOLserver Packages]] -- Binary distributions of AOLserver in popular package management formats.
* [[Useful Links]]
* [http://panoptic.com/wiki/aolserver/Special:Recentchanges?feed=rss RSS 2.0 syndication] of this wiki's recent changes.

== Developers' Guide (A Work In Progress) ==

* [[AOLserver Developer's Guide]] -- A growing, community generated guide on how to develop, deploy and maintain applications using AOLserver including discussions of internals, troubleshooting, debugging, testing and tuning.

== AOLserver Community ==

* The AOLserver project [[Roadmap]], as well as the planned [[Features]] and changes.
* The [[People]] who work on and contribute to AOLserver, organized into [[Project Teams]].
* Come join us in our [http://www.aolserver.com/chat/ online chat], or just read the [http://panoptic.com/aolserver/chat/ chat logs]. You can participate on the chat either via IRC (irc.freenode.net:6667 #aolserver) or via AIM.
* There's also an [http://www.livejournal.com/community/aolserver/ AOLserver LiveJournal community].
* [[Sites That Run On AOLserver]]
* The [[OpenACS]] Project.
* [[AOLserver User Groups]]
* [[AOLserver Jobs]]

== AOLserver Core Developers ==

* [[Vision Statement]]
* [[CVS Commit Guidelines]]
* [http://www.aolserver.com/docs/devel/tech/standards.html AOLserver Engineering Standards Manual]

__NOTOC__

What's new in 4.5

2006-04-19T12:20:17Z

Jcollins:

This is a partial list of new features and major changes in AOLserver 4.5 (compared to 4.0). If you know of anything that is missing, please add it.

=== Connection Management: ===

These two commands can be used together to map slow running requests to a specific pool and to set limits to avoid overload.

* New '''ns_pools''' command to map method/URL's to specific thread pools.
* New '''ns_limits''' command control the number of threads executing and/or waiting for execution by method/URL.

=== I/O Features: ===

* New '''Ns_QueueWait''' API to enable event-driven callbacks in the driver thread before dispatching to pools for processing.

:The allows drivers to augment data received from the client (headers, request, content) with additional data fetched over the network (likely stored in the new Ns_Cls "connection local storage" API's) before dispatching to the connection threads. An example would be to add certain personalization data received via a web service. The rationale here is that I/O events are cheap so do those upfront instead of having expensive connection threads burdened with wasteful blocking I/O. This is a somewhat obscure and technical interface.

* Added ability to manage larger file uploads by spooling to a temporary file.

=== ADP Improvements: ===

* Added a new execution caching technique at the '''ns_adp_include''' level which allows you to save the results of execution of an included ADP and includes below that for reuse on subsequent connections up to a specified time.
* Added '''singlescript''' config option which turns ADP pages into a single script enabling syntax such as "<% foreach e $list { %> element <%= $e %> here <% } %>".
* Added output buffer improvements via new Ns_ConnFlush.
* Added automatic UTF-8 to output charset encoding.
* Added gzip output compression.
* Added streaming output in chunked-encoding format instead of the previous "response with no length" HTTP/1.0 method.
* Enhanced ADP error handling and reporting.
* Added ability to trace ADP pages. Trace output is written to the server log.

=== Other Improvements: ===

* New '''Ns_TclRegisterTrace''' API to enable callbacks at key state transition points in a much more natural way. The [[ns_ictl]] command has been updated to support script-level traces.
* New '''Ns_Task''' API designed to replace the old Ns_SockCallback API which didn't do a very good job at managing timeouts along with I/O events.
* New '''ns_returnmoved''' command to return 301 http status code and redirect to a new URL.
* New '''ns_cache''' command based on ideas from the ns_cache module. This is not backward compatible with the ns_cache module.
* New '''ns_loop_ctl''' command to monitor and manage ''for'', ''while'', and ''foreach'' loops.
* Added '''ns_ictl package''' subcommand to [[ns_ictl]] command to handle loading of Tcl packages.
* Added new '''ns_register_fastpath''' command to re-enable fastpath after a previous call to '''ns_register_proc'''.
* Added ability to access more AOLserver functionality from a tclsh (nsv_*, ns_thread, etc).
* Stack checking has returned. In a multi-threaded application like AOLserver, stack checking is important for detecting buffer overruns and deep call trees blowing your thread stack, etc.
* More detailed information when logging uncaught Tcl errors. Especially for connection threads, details of the HTTP request are logged to make diagnosing the root cause of errors easier.

What's new in 4.5

2006-02-22T03:24:19Z

Jcollins:

This is a partial list of new features and major changes in AOLserver 4.5 (compared to 4.0). If you know of anything that is missing, please add it.

=== Connection Management: ===

These two commands can be used together to map slow running requests to a specific pool and to set limits to avoid overload.

* New '''ns_pools''' command to map method/URL's to specific thread pools.
* New '''ns_limits''' command control the number of threads executing and/or waiting for execution by method/URL.

=== I/O Features: ===

* New '''Ns_QueueWait''' API to enable event-driven callbacks in the driver thread before dispatching to pools for processing.

:The allows drivers to augment data received from the client (headers, request, content) with additional data fetched over the network (likely stored in the new Ns_Cls "connection local storage" API's) before dispatching to the connection threads. An example would be to add certain personalization data received via a web service. The rationale here is that I/O events are cheap so do those upfront instead of having expensive connection threads burdened with wasteful blocking I/O. This is a somewhat obscure and technical interface.

* Added ability to manage larger file uploads by spooling to a temporary file.

=== ADP Improvements: ===

* Added a new execution caching technique at the '''ns_adp_include''' level which allows you to save the results of execution of an included ADP and includes below that for reuse on subsequent connections up to a specified time.
* Added '''singlescript''' config option which turns ADP pages into a single script enabling syntax such as "<% foreach e $list { %> element <%= $e %> here <% } %>".
* Added output buffer improvements via new Ns_ConnFlush.
* Added automatic UTF-8 to output charset encoding.
* Added gzip output compression.
* Added streaming output in chunked-encoding format instead of the previous "response with no length" HTTP/1.0 method.
* Enhanced ADP error handling and reporting.
* Added ability to trace ADP pages. Trace output is written to the server log.

=== Other Improvements: ===

* New '''Ns_TclRegisterTrace''' API to enable callbacks at key state transition points in a much more natural way. The [[ns_ictl]] command has been updated to support script-level traces.
* New '''Ns_Task''' API designed to replace the old Ns_SockCallback API which didn't do a very good job at managing timeouts along with I/O events.
* New '''ns_returnmoved''' command to return 301 http status code and redirect to a new URL.
* New '''ns_cache''' command based on ideas from the ns_cache module. This is not backward compatible with the ns_cache module.
* Added new '''ns_register_fastpath''' command to re-enable fastpath after a previous call to '''ns_register_proc'''.
* Added ability to access more AOLserver functionality from a tclsh (nsv_*, ns_thread, etc).
* Stack checking has returned. In a multi-threaded application like AOLserver, stack checking is important for detecting buffer overruns and deep call trees blowing your thread stack, etc.
* More detailed information when logging uncaught Tcl errors. Especially for connection threads, details of the HTTP request are logged to make diagnosing the root cause of errors easier.

What's new in 4.5

2006-02-22T03:03:31Z

Jcollins:

This is a partial list of new features and major changes in AOLserver 4.5 (compared to 4.0). If you know of anything that is missing, please add it.

=== Connection Management: ===

These two commands can be used together to map slow running requests to a specific pool and to set limits to avoid overload.

* New '''ns_pools''' command to map method/URL's to specific thread pools.
* New '''ns_limits''' command control the number of threads executing and/or waiting for execution by method/URL.

=== I/O Features: ===

* New '''Ns_QueueWait''' API to enable event-driven callbacks in the driver thread before dispatching to pools for processing.

:The allows drivers to augment data received from the client (headers, request, content) with additional data fetched over the network (likely stored in the new Ns_Cls "connection local storage" API's) before dispatching to the connection threads. An example would be to add certain personalization data received via a web service. The rationale here is that I/O events are cheap so do those upfront instead of having expensive connection threads burdened with wasteful blocking I/O. This is a somewhat obscure and technical interface.

* Added ability to manage larger file uploads by spooling to a temporary file.

=== ADP Improvements: ===

* Added a new execution caching technique at the '''ns_adp_include''' level which allows you to save the results of execution of an included ADP and includes below that for reuse on subsequent connections up to a specified time.
* Added '''singlescript''' config option which turns ADP pages into a single script enabling syntax such as "<% foreach e $list { %> element <%= $e %> here <% } %>".
* Added output buffer improvements via new Ns_ConnFlush.
* Added automatic UTF-8 to output charset encoding.
* Added gzip output compression.
* Added streaming output in chunked-encoding format instead of the previous "response with no length" HTTP/1.0 method.
* Enhanced ADP error handling and reporting.

=== Other Improvements: ===

* New '''Ns_TclRegisterTrace''' API to enable callbacks at key state transition points in a much more natural way. The [[ns_ictl]] command has been updated to support script-level traces.
* New '''Ns_Task''' API designed to replace the old Ns_SockCallback API which didn't do a very good job at managing timeouts along with I/O events.
* New '''ns_returnmoved''' command to return 301 http status code and redirect to a new URL.
* New '''ns_cache''' command based on ideas from the ns_cache module. This is not backward compatible with the ns_cache module.
* Added new '''ns_register_fastpath''' command to re-enable fastpath after a previous call to '''ns_register_proc'''.
* Added ability to access more AOLserver functionality from a tclsh (nsv_*, ns_thread, etc).
* Stack checking has returned. In a multi-threaded application like AOLserver, stack checking is important for detecting buffer overruns and deep call trees blowing your thread stack, etc.
* More detailed information when logging uncaught Tcl errors. Especially for connection threads, details of the HTTP request are logged to make diagnosing the root cause of errors easier.

What's new in 4.5

2006-02-22T02:56:14Z

Jcollins:

This is a partial list of new features and major changes in AOLserver 4.5 (compared to 4.0). If you know of anything that is missing, please add it.

=== Connection Management: ===

* New '''ns_pools''' command to map method/URL's to specific thread pools.
* New '''ns_limits''' command control the number of threads executing and/or waiting for execution by method/URL.

=== I/O Features: ===

* New '''Ns_QueueWait''' API to enable event-driven callbacks in the driver thread before dispatching to pools for processing.
* Added ability to manage larger file uploads by spooling to a temporary file.

=== ADP Improvements: ===

* Added a new execution caching technique at the '''ns_adp_include''' level which allows you to save the results of execution of an included ADP and includes below that for reuse on subsequent connections up to a specified time.
* Added '''singlescript''' config option which turns ADP pages into a single script enabling syntax such as "<% foreach e $list { %> element <%= $e %> here <% } %>".
* Added output buffer improvements via new Ns_ConnFlush.
* Added automatic UTF-8 to output charset encoding.
* Added gzip output compression.
* Added streaming output in chunked-encoding format instead of the previous "response with no length" HTTP/1.0 method.
* Enhanced ADP error handling and reporting.

=== Other Improvements: ===

* New '''Ns_TclRegisterTrace''' API to enable callbacks at key state transition points in a much more natural way. The [[ns_ictl]] command has been updated to support script-level traces.
* New '''Ns_Task''' API designed to replace the old Ns_SockCallback API which didn't do a very good job at managing timeouts along with I/O events.
* New '''ns_returnmoved''' command to return 301 http status code and redirect to a new URL.
* New '''ns_cache''' command based on ideas from the ns_cache module. This is not backward compatible with the ns_cache module.
* Added new '''ns_register_fastpath''' command to re-enable fastpath after a previous call to '''ns_register_proc'''.
* Added ability to access more AOLserver functionality from a tclsh (nsv_*, ns_thread, etc).
* Stack checking has returned. In a multi-threaded application like AOLserver, stack checking is important for detecting buffer overruns and deep call trees blowing your thread stack, etc.
* More detailed information when logging uncaught Tcl errors. Especially for connection threads, details of the HTTP request are logged to make diagnosing the root cause of errors easier.

What's new in 4.5

2006-02-22T02:53:05Z

Jcollins:

This is a partial list of new features and major changes in AOLserver 4.5 (compared to 4.0). If you know of anything that is missing, please add it.

=== Connection Management: ===

* New '''ns_pools''' command to map method/URL's to specific thread pools.
* New '''ns_limits''' command control the number of threads executing and/or waiting for execution by method/URL.

=== I/O Features: ===

* New '''Ns_QueueWait''' API to enable event-driven callbacks in the driver thread before dispatching to pools for processing.
* Added ability to manage larger file uploads by spooling to a temporary file.

=== ADP Improvements: ===

* Added a new execution caching technique at the '''ns_adp_include''' level which allows you to save the results of execution of an included ADP and includes below that for reuse on subsequent connections up to a specified time.
* Added '''singlescript''' config option which turns ADP pages into a single script enabling syntax such as "<% foreach e $list { %> element <%= $e %> here <% } %>".
* Added output buffer improvements via new Ns_ConnFlush.
* Added automatic UTF-8 to output charset encoding.
* Added gzip output compression.
* Added streaming output in chunked-encoding format instead of the previous "response with no length" HTTP/1.0 method.
* Enhanced ADP error handling and reporting.

=== Other Improvements: ===

* New '''Ns_TclRegisterTrace''' API to enable callbacks at key state transition points in a much more natural way. The [[ns_ictl]] command has been updated to support script-level traces.
* New '''Ns_Task''' API designed to replace the old Ns_SockCallback API which didn't do a very good job at managing timeouts along with I/O events.
* New '''ns_returnmoved''' command to return 301 http status code and redirect to a new URL.
* New '''ns_cache''' command based on ideas from the ns_cache module. This is not backward compatible with the ns_cache module.
* Added new '''ns_register_fastpath'''' command to re-enable fastpath after a previous call to '''ns_register_proc'''.
* Added ability to access more AOLserver functionality from a tclsh (nsv_*, ns_thread, etc).
* Stack checking has returned. In a multi-threaded application like AOLserver, stack checking is important for detecting buffer overruns and deep call trees blowing your thread stack, etc.
* More detailed information when logging uncaught Tcl errors. Especially for connection threads, details of the HTTP request are logged to make diagnosing the root cause of errors easier.

What's new in 4.5

2006-02-22T02:37:18Z

Jcollins:

This is a partial list of new features and major changes in AOLserver 4.5 (compared to 4.0). If you know of anything that is missing, please add it.

=== Connection Management: ===

* New '''ns_pools''' command to map method/URL's to specific thread pools.
* New '''ns_limits''' command control the number of threads executing and/or waiting for execution by method/URL.

=== I/O Features: ===

* New '''Ns_QueueWait''' API to enable event-driven callbacks in the driver thread before dispatching to pools for processing.
* Added ability to manage larger file uploads by spooling to a temporary file.

=== ADP Improvements: ===

* Added a new execution caching technique at the '''ns_adp_include''' level which allows you to save the results of execution of an included ADP and includes below that for reuse on subsequent connections up to a specified time.
* Added '''singlescript''' config option which turns ADP pages into a single script enabling syntax such as "<% foreach e $list { %> element <%= $e %> here <% } %>".
* Added output buffer improvements via new Ns_ConnFlush.
* Added automatic UTF-8 to output charset encoding.
* Added gzip output compression.
* Added streaming output in chunked-encoding format instead of the previous "response with no length" HTTP/1.0 method.

=== Other Improvements: ===

* New '''Ns_TclRegisterTrace''' API to enable callbacks at key state transition points in a much more natural way. The [[ns_ictl]] command has been updated to support script-level traces.
* New '''Ns_Task''' API designed to replace the old Ns_SockCallback API which didn't do a very good job at managing timeouts along with I/O events.
* Stack checking has returned. In a multi-threaded application like AOLserver, stack checking is important for detecting buffer overruns and deep call trees blowing your thread stack, etc.
* More detailed information when logging uncaught Tcl errors. Especially for connection threads, details of the HTTP request are logged to make diagnosing the root cause of errors easier.

What's new in 4.5

2006-02-22T02:35:05Z

Jcollins:

This is a partial list of new features and major changes in AOLserver 4.5 (compared to 4.0). If you know of anything that is missing, please add it.

* Stack checking has returned. In a multi-threaded application like AOLserver, stack checking is important for detecting buffer overruns and deep call trees blowing your thread stack, etc.
* More detailed information when logging uncaught Tcl errors. Especially for connection threads, details of the HTTP request are logged to make diagnosing the root cause of errors easier.

=== Connection Management ===

* New '''ns_pools''' command to map method/URL's to specific thread pools.
* New '''ns_limits''' command control the number of threads executing and/or waiting for execution by method/URL.

=== I/O Features ===

* New '''Ns_QueueWait''' API to enable event-driven callbacks in the driver thread before dispatching to pools for processing.
* Added ability to manage larger file uploads by spooling to a temporary file.
* Added a new execution caching technique at the '''ns_adp_include''' level which allows you to save the results of execution of an included ADP and includes below that for reuse on subsequent connections up to a specified time.

=== ADP Improvements: ===

* Added '''singlescript''' config option which turns ADP pages into a single script enabling syntax such as "<% foreach e $list { %> element <%= $e %> here <% } %>".
* Added output buffer improvements via new Ns_ConnFlush.
* Added automatic UTF-8 to output charset encoding.
* Added gzip output compression.
* Added streaming output in chunked-encoding format instead of the previous "response with no length" HTTP/1.0 method.

=== Tcl Improvements: ===

* New '''Ns_TclRegisterTrace''' API to enable callbacks at key state transition points in a much more natural way. The [[ns_ictl]] command has been updated to support script-level traces.
* New '''Ns_Task''' API designed to replace the old Ns_SockCallback API which didn't do a very good job at managing timeouts along with I/O events.

User:Jcollins/monobook.css

2006-02-16T14:52:33Z

Jcollins:

body {
margin: 0;
font-family: "Trebuchet MS";
}

h1 {
color: #335D66;
font-size: 14pt;
border-bottom: 1px solid #999;
}

h3 {
color: #488E48;
}

a {
color: #336633;
}

a:hover {
background: #ffffcc;
}

.contentSub li {
list-style-type: square;
}

User:Jcollins/monobook.css

2006-02-16T14:51:11Z

Jcollins:

body {
margin: 0;
font-family: "Trebuchet MS";
}

h1 {
color: #335D66;
font-size: 14pt;
}

h3 {
color: #488E48;
}

a {
color: #336633;
}

a:hover {
background: #ffffcc;
}

.contentSub li {
list-style-type: square;
}

Documentation

2006-02-16T14:49:25Z

Jcollins: /* Community-supported documentation */

There is an effort underway to update and prepare documentation for AOLserver 4.0. This wiki will be the canonical source for documentation under revision, which will then get commited to CVS in the doc/ directory in roff format. From there, HTML will be forward-generated from the roff and made available from http://aolserver.com/docs/.

If there is documentation you feel is not complete, represented accurately, or is entirely omitted, please add it to the appropriate place and make a note of it on the [[Documentation Wishlist]] so that people know that someone wants it.

== API documentation ==

* [[Tcl API]]
* [[C API]] - [http://aolserver.am.net/cvs/tcl C source for Tcl commands]
* [[Private C API]]

== General documentation ==

* [[Modules]]
* [[Languages]]
* [[Toolkits]]
* [[Tutorials]]
* [[Administration]]

== Guides ==

* [[AOLserver Tuning, Troubleshooting and Scaling]] by [[Kriston J. Rehberg]].
* [[Virtual Hosting]] in AOLserver.
* Using upvar: http://dqd.com/~mayoff/notes/tcl/upvar.html
* [http://www.fpx.de/fp/Software/tcl-c++/tcl-c++.html Making C++ Loadable Modules Work] in Tcl.

== HOWTOs ==

* [[How to set up PHP under AOLserver]]
* [[How to set up WiKit under AOLserver]]
* [http://www.rexx.com/~dkuhlman/aolserver_howto.html Beginner's How-to for AOLserver, PyWX, and PostgreSQL]
* [[How to build AOLserver on Win32]]
* [[How to set up Project Liberty (IPL) under AOLserver]]
* [http://www.manicai.net/comp/how/svn/ How to set up ViewCVS for Subversion under AOLserver]
* [[How to set up SQL-Ledger to serve from AOLserver]]
* [[How to generate self-signed SSL certificates]]

== Community-supported documentation ==

* Notes describing the differences between ArsDigita [[ad13 vs. 3.5.1]].

[[Category:Documentation]]

User:Jcollins/monobook.css

2006-02-16T14:47:25Z

Jcollins:

body {
margin: 0;
font-family: "Trebuchet MS";
}

h1 {
color: #335D66;
font-size: 14pt;
}

h3 {
color: #488E48;
}

a {
color: #336633;
}

a:hover {
background: #ffffcc;
}

li {
list-style-type: square;
}

User:Jcollins/monobook.css

2006-02-16T14:47:00Z

Jcollins:

body {
margin: 0;
font-family: "Trebuchet MS";
font-size: medium;
}

h1 {
color: #335D66;
font-size: 14pt;
}

h3 {
color: #488E48;
}

a {
color: #336633;
}

a:hover {
background: #ffffcc;
}

li {
list-style-type: square;
}

User:Jcollins/monobook.css

2006-02-16T14:45:29Z

Jcollins:

body {
font-family: "Trebuchet MS";
}