mod_jserv/3972: Some steps left out of the jserv installation docs

[jeff bowden <jl...@halcyon.com>]

>Number:         3972
>Category:       mod_jserv
>Synopsis:       Some steps left out of the jserv installation docs
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    jserv
>State:          open
>Class:          doc-bug
>Submitter-Id:   apache
>Arrival-Date:   Fri Feb 26 00:30:00 PST 1999
>Last-Modified:
>Originator:     jlb@halcyon.com
>Organization:
apache
>Release:        1.3.4
>Environment:
linux
>Description:
I'm new to mod_jserv and have just now managed to make it run.  There were a few
steps left out of the documentation and I thought you might like to know about
it.

The DSO configuration instructions are broken.  I'm not sure how exactly but I
tried following them and `make' never compiles anything in the src/c directory.
By reverting to the static linking instructions I got mod_jserv to build.

Must add
   AddModule mod_jserv.c
to httpd.conf.  This wasn't too hard to figure out but it might as well be in
the step-by-step instructions for the absent-minded.

Must add
   ApJServSecretKey DISABLED
to httpd.conf.  This was also not too hard since it apachectl tells you to do it.
Still, it ought to be mentioned.

Must copy jserv.properties from the `examples' directory to the apache `conf'
directory and then add the following to httpd.conf
   ApJServProperties /usr/local/apache/conf/jserv.properties
Also, it is necessary to edit ApJServProperties jserv.properties, changing the
line
  wrapper.classpath=
to
  wrapper.classpath=/usr/local/jdk117_v1a/lib/classes.zip

This was probably the least obvious thing.

Finally, in order to load the status page I had to add this to httpd.conf

<Location /status/jserv/>
  SetHandler jserv-status
  order deny,allow
  deny from all
  allow from 127.0.0.1
</Location>

All this stuff is documented in various places but it seems like it ought to be
the unix install howto (http://java.apache.org/jserv/install/howto.unix_install.html)

-jeff
>How-To-Repeat:

>Fix:

>Audit-Trail:
>Unformatted:
[In order for any reply to be added to the PR database, ]
[you need to include <ap...@Apache.Org> in the Cc line ]
[and leave the subject line UNCHANGED.  This is not done]
[automatically because of the potential for mail loops. ]
[If you do not include this Cc, your reply may be ig-   ]
[nored unless you are responding to an explicit request ]
[from a developer.                                      ]
[Reply only with text; DO NOT SEND ATTACHMENTS!         ]