https://issues.apache.org/bugzilla/show_bug.cgi?id=46923

           Summary: AJP/1.3 Connector code/documentation mismatch
           Product: Tomcat 6
           Version: 6.0.18
          Platform: PC
        OS/Version: Linux
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Connectors
        AssignedTo: dev@tomcat.apache.org
        ReportedBy: j...@ucar.edu


The docs for the ajp/1.3 connector:

http://tomcat.apache.org/tomcat-6.0-doc/config/ajp.html

make it seem like there is only 1 implementation for the protocol class but
there are really 3. The docs describe the properties for the APR-enabled class
org.apache.coyote.ajp.AjpAprProtocol.

They don't mention that if APR is not initialized, the class used for
protocol="AJP/1.3" is actually org.apache.jk.server.JkCoyoteHandler which does
not have the same interface/properties as the docs describe. In particular, I
cannot use the executor, getting exceptions like:

[DATE] org.apache.catalina.startup.ConnectorCreateRule _setExecutor
WARNING: Connector [org.apache.catalina.connector.connec...@11e1e67] does not
support external executors. Method setExecutor(java.util.concurrent.Executor)

which is confusing because the docs make it sound like it works. The one
message I found on tomcat-users seemed to be confused with another issue and
ignored.


There is however the class org.apache.coyote.ajp.AjpProtocol which matches the
AjpAprProtocol interface and seems to work fine.

I suggest at least making the config/ajp.html page clear and including
JkCoyoteHandler documenation, or changing
org.apache.catalina.connector.Connector to use AjpProtocol.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org

Reply via email to