Updated modules arc with dtrace is attached.
The interfaces of modules are changed to Volatile as these are
controlled by external organizations.
[Jyri Virkki:]
| rahul wrote:
| >
| > | Since the other apache modules case is still in the queue, I suggest
| > | combining this one with it since it's more of the same (just 1 more
| > | module). Saves the work of having separate cases.
| >
| > It would be nice to tackle dtrace separately as the work for others is
| > already done (except for ARC) and they are waiting to be putback. I
| > would rather not touch those if it is ok with you.
|
| The case for the other modules has not been filed yet so there it no
| gain in filing 2 cases at the same time for essentially the same
| ("more apache modules") thing.
|
| > More over dtrace OSR has not been approved (and if the previous
| > experience is any thing to go by it should take one or two months)
|
| The OSR is approved (unfortunately not visible on the opensolaris site)...
|
| > | List the exported probes in the exported interfaces. And from the
| > | above, sounds like they are Volatile?
| >
| > This is more of a concern, perhaps we should wait until (either) it moves
out
| > of its alpha stage (or) one of us are willing to contribute to the
| > development (given that it is on solaris) and move it to stable land.
|
| True, the options are to either not include the dtrace support at all
| or add it as a Volatile interface for now until it is seen to
| stabilize (there is a third option, which is to support it at a more
| stable level at the risk of forking, but IMO we shouldn't consider
| that, since we want to avoid any forks).
|
| I think it'll be useful to include it as Volatile, since there is
| interest in dtrace support for all components.
|
rahul
--
1. e4 _
-------------- next part --------------
Additional Apache Modules
13 December 2007
1. Summary and motivation
1.1. Introduction
This FastTrack delivers Apache modules mod_jk, mod_fcgid,
mod_security and mod_dtrace to the Apache2 in OpenSolaris.
Modules allow Apache to integrate and provide functionality
during runtime that were not available during compile time.
This project integrates the most recent stable releases of
mod_jk[1] tomcat-connectors-1.2.25, mod_fcgid[2] 2.2,
mod_security[3] 2.1.3 and mod_dtrace[4] 0.3a
This case seeks Minor Release Binding.
2. Technical issues
2.1. Key objects
/usr/apache2/2.2/libexec/mod_jk.so
/usr/apache2/2.2/libexec/mod_fcgid.so
/usr/apache2/2.2/libexec/mod_security2.so
/usr/apache2/2.2/libexec/mod_dtrace.so
/usr/apache2/2.2/libexec/${ISAINFO}/mod_jk.so
/usr/apache2/2.2/libexec/${ISAINFO}/mod_fcgid.so
/usr/apache2/2.2/libexec/${ISAINFO}/mod_security2.so
/usr/apache2/2.2/libexec/${ISAINFO}/mod_dtrace.so
2.2 Versioning
mod_jk, mod_fcgid, mod_security and mod_dtrace have a single active
release. (There was a module named mod_jk2 which was deprecated. It
was not the successor to mod_jk.)
It is not possible to query the modules to find out their
versions. The only way to do that is to look at the package
description for the package including it.
2.2 Directory Naming and Structure
This project delivers the shared libraries of 32 bit and 64 bit
into /usr/apache2/2.2/libexec and /usr/apache2/2.2/libexec/${ISAINFO}/
directories of apache. This is in keeping with the approach taken
by the Apache2 integration project for OpenSolaris (PSARC/2007/586).
3. Documentation
The modules mod_jk, mod_fcgid, mod_security and mod_dtrace do not
install documentation into apache though they come with some
documentation in their source. The recommended way to access their
documentation is to look at their websites (mod_fcgid[5] ,mod_jk[6],
mod_security[7] and mod_dtrace[8] ). A list of external apache modules
that has been added and their corresponding sites will be part of the
release document.
4. Packaging and Delivery
The modules will be delivered under the cluster SUNWCapch22m. This
cluster consists of SUNWapch22m-fcgid, SUNWapch22m-jk,
SUNWapch22m-security and SUNWapch22m-dtrace respectively.
5. Interfaces
5.1. Interface Stability
The interface stability of each component is described as Volatile
as these are controled by external organizations over which Sun
has no control. The specific researches regarding stability of
each module are captured below.
5.1.1 mod_jk
The mod_jk developers will try to keep the releases of 1.2.X
line compatible with each other. But this is not guaranteed in
case of new features that may need to be retracted due to some
bugs or vulnerabilities.
5.1.2 mod_security
The mod_security developers will keep the compatibility
between releases of the same major number. (ie 2.y.z with 2 being
the major number.) But there is no guarantee that meaning of a
rule set (configuration directive) would be exactly the same
across any two releases.
5.1.3 mod_fcgid
There were no commitments from mod_fcgid developers in this
regard. (The mod_fcgid does not seem to have broken the
configuration compatibility with any of its earlier releases
yet [9])
5.1.4 mod_dtrace
The mod_dtrace has had just two releases (0.2a and 0.3a) and
is possibly very unstable.
5.2. Imported Interfaces
These Apache modules imports interfaces from
NAME STABILITY NOTES
Apache2 Uncommitted PSARC/2007/586/
LDAP Evolving PSARC/2000/362/
PCRE Uncommitted PSARC/2007/164/
SUNWlxml Committed PSARC/2001/175/
Dtrace Uncommitted PSARC/2001/466/
5.3. Exported Interfaces
NAME STABILITY
/usr/apache2/2.2/libexec/mod_jk.so Volatile
/usr/apache2/2.2/libexec/mod_fcgid.so Volatile
/usr/apache2/2.2/libexec/mod_security.so Volatile
/usr/apache2/2.2/libexec/mod_dtrace.so Volatile
/usr/apache2/2.2/libexec/${ISAINFO}/mod_jk.so Volatile
/usr/apache2/2.2/libexec/${ISAINFO}/mod_fcgid.so Volatile
/usr/apache2/2.2/libexec/${ISAINFO}/mod_dtrace.so Volatile
6. References
1. http://fastcgi.coremail.cn/
2. http://tomcat.apache.org/connectors-doc/
3. http://www.modsecurity.org/projects/modsecurity/apache/index.html
4. http://prefetch.net/projects/apache_modtrace/index.html
5. http://fastcgi.coremail.cn/doc.htm
6. http://tomcat.apache.org/connectors-doc/generic_howto/quick.html
7. http://www.modsecurity.org/documentation/index.html
8. http://prefetch.net/projects/apache_modtrace/mod_dtrace.c
9. http://fastcgi.coremail.cn/download.htm
