| 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 <a href="http://www.apache.org">Apache |
| 31 |
Software Foundation</a> 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 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 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> |
| 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. 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> http://shadygrove.east/example/JakartaMail.html |
| 85 |
<p>and the initail reference to the JakartaMailServlet being: |
| 86 |
<p> 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> http://shadygrove/example/JakartaMailServlet |
| 92 |
<br> |
| 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> |