Debian Codegraph @

doc/release/ApacheJServ.html

raw
1 <!doctype html public "-//w3c//dtd html 4.0 transitional//en">
2 <html>
3 <head>
4 <!--
5
6 Copyright (c) 2010, 2019 Oracle and/or its affiliates. All rights reserved.
7
8 This program and the accompanying materials are made available under the
9 terms of the Eclipse Public License v. 2.0, which is available at
10 http://www.eclipse.org/legal/epl-2.0.
11
12 This Source Code may also be made available under the following Secondary
13 Licenses when the conditions for such availability set forth in the
14 Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
15 version 2 with the GNU Classpath Exception, which is available at
16 https://www.gnu.org/software/classpath/license.html.
17
18 SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
19
20 -->
21
22 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
23 <meta name="Author" content="JavaSoftware">
24 <meta name="GENERATOR" content="Mozilla/4.61 [en] (WinNT; U) [Netscape]">
25 <title>ApacheJServ</title>
26 </head>
27 <body>
28 If you don't already have Apache web server and Apache JServ
29 module installed and running,
30 <br>you'll need to download them from the&nbsp; <a href="http://www.apache.org">Apache
31 Software Foundation</a>&nbsp; and install them. We
32 <br>were able to find binary versions of Apache web server for both the
33 Solaris and Windows NT
34 <br>operating systems, and Apache JServ 1.1.2 for Windows NT. However,
35 for Solaris,
36 <br>Apache JServ needed to be built from the source.
37 <p>(on Solaris)
38 <blockquote>Apache Web Server 1.3.9 (<a href="http://httpd.apache.org/dist/binaries/">binary</a>)
39 <br>Apache JServ 1.1.2 (built from <a href="http://java.apache.org/">source</a>)</blockquote>
40 (on NT)
41 <blockquote>Apache Web Server&nbsp; 1.3.14 (<a href="http://httpd.apache.org/dist/binaries/">binary</a>)
42 <br>Apache JServ 1.1.2 (<a href="http://java.apache.org/">binary</a>)</blockquote>
43 To run the JakartaMailServlet, you must add the Jakarta Mail and JavaBeans
44 Activation Framework
45 <br>jar files to the web server's system classpath. Apache JServ also requires
46 that the
47 <br>Java Servlet Development Kit&nbsp; 2.0 (<a href="http://java.sun.com/products/servlet/archive.html">JSDK2.0</a>)
48 is installed and also added to the web server's
49 <br>system classpath. JSDK2.0 is a reference implementation of the Servlet
50 API Specification Version 2.0.
51 <p>When running Apache JServ in automatic mode, add wrapper.classpath properties
52 for each
53 <br>of these jar files to the servlet engine's propeties file. The default
54 engine properties file is
55 <br>jserv.properties and is usually found in Apache JServ's 'conf' directory.
56 Wrapper properties
57 <br>are used to automatically start the servlet engine.
58 <p>(on Solaris)
59 <blockquote>wrapper.classpath=/files/java/lib/JSDK2.0/lib/jsdk.jar
60 <br>wrapper.classpath=/files/java/lib/jakartamail/jakarta.mail.jar
61 <br>wrapper.classpath=/files/java/lib/jaf/jakarta.activation.jar</blockquote>
62 (on NT)
63 <blockquote>wrapper.classpath=d:\java\lib\jsdk2.0\lib\jsdk.jar
64 <br>wrapper.classpath=d:\java\lib\jakartamail\jakarta.mail.jar
65 <br>wrapper.classpath=d:\java\lib\jaf\jakarta.activation.jar</blockquote>
66 When running Apache JServ in manual mode, add these jar files to the CLASSPATH
67 <br>environment variable (this is documented in the Jakarta Mail README file
68 and additional
69 <br>Windows NT information is provided <a href="classpath-NT.html">here</a>).
70 <p>Once this is done, restart the web server.
71 <br>&nbsp;
72 <p>Additional Notes
73 <blockquote>One thing to watch out for is how the web server is referenced
74 when using the
75 <br>JakartaMailServlet on this web server.&nbsp; It is important to use the
76 configured server
77 <br>name (i.e. the name assigned with the ServerName directive) in the
78 URL. If the
79 <br>configured server name includes a domain, it must be referenced including
80 the
81 <br>domain, even if the JakartaMail.html page can be accessed without it.
82 <p>For example, Apache is configured with the ServerName set to 'shadygrove'.
83 If the Jakarta Mail demo is referenced by:
84 <p>&nbsp;&nbsp;&nbsp; http://shadygrove.east/example/JakartaMail.html
85 <p>and the initail reference to the JakartaMailServlet being:
86 <p>&nbsp;&nbsp;&nbsp; http://shadygrove.east/example/JakartaMailServlet
87 <p>the user is successfully logged in. However, when an attempt is made
88 to access the INBOX, the user is instructed to login because there is no
89 current session. When this occurs, note that the URL referencing the JakartaMailServlet
90 no longer contains the domain originally used but the configured ServerName.
91 <p>&nbsp;&nbsp;&nbsp; http://shadygrove/example/JakartaMailServlet
92 <br>&nbsp;
93 <p>Also note that Apache JServ does not use a SecurityManager or enforce
94 any Java
95 <br>security policy.</blockquote>
96
97 </body>
98 </html>