<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<!--
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
The contents of this file are subject to the terms of either the GNU
General Public License Version 2 only ("GPL") or the Common Development
and Distribution License("CDDL") (collectively, the "License"). You
may not use this file except in compliance with the License. You can
obtain a copy of the License at
or packager/legal/LICENSE.txt. See the License for the specific
language governing permissions and limitations under the License.
When distributing the software, include this License Header Notice in each
file and include the License file at packager/legal/LICENSE.txt.
GPL Classpath Exception:
Oracle designates this particular file as subject to the "Classpath"
exception as provided by Oracle in the GPL Version 2 section of the License
file that accompanied this code.
Modifications:
If applicable, add the following below the License Header, with the fields
enclosed by brackets [] replaced by your own identifying information:
"Portions Copyright [year] [name of copyright owner]"
Contributor(s):
If you wish your version of this file to be governed by only the CDDL or
only the GPL Version 2, indicate your decision by adding "[Contributor]
elects to include this software in this distribution under the [CDDL or GPL
Version 2] license." If you don't indicate a single choice of license, a
recipient has the option to distribute your version of this file under
either the CDDL, the GPL Version 2 or to extend the choice of license to
its licensees as provided above. However, if you add GPL Version 2 code
and therefore, elected the GPL Version 2 license, then the option applies
only if the new code is made subject to such option by the copyright
holder.
-->
<meta name="Author" content="JavaSoftware">
<title>ApacheJServ</title>
</head>
<body>
If you don't already have Apache web server and Apache JServ
module installed and running,
Software Foundation</a> and install them. We
<br>were able to find binary versions of Apache web server for both the
Solaris and Windows NT
<br>operating systems, and Apache JServ 1.1.2 for Windows NT. However,
for Solaris,
<br>Apache JServ needed to be built from the source.
<p>(on Solaris)
(on NT)
<blockquote>Apache Web Server 1.3.14 (<a href="http://httpd.apache.org/dist/binaries/">binary</a>)
To run the JavaMailServlet, you must add the JavaMail and JavaBeans Activation
Framework
<br>jar files to the web server's system classpath. Apache JServ also requires
that the
<br>Java Servlet Development Kit 2.0 (<a href="http://java.sun.com/products/servlet/archive.html">JSDK2.0</a>)
is installed and also added to the web server's
<br>system classpath. JSDK2.0 is a reference implementation of the Servlet
API Specification Version 2.0.
<p>When running Apache JServ in automatic mode, add wrapper.classpath properties
for each
<br>of these jar files to the servlet engine's propeties file. The default
engine properties file is
<br>jserv.properties and is usually found in Apache JServ's 'conf' directory.
Wrapper properties
<br>are used to automatically start the servlet engine.
<p>(on Solaris)
(on NT)
When running Apache JServ in manual mode, add these jar files to the CLASSPATH
<br>environment variable (this is documented in the JavaMail README file
and additional
<p>Once this is done, restart the web server.
<br>
<p>Additional Notes
<blockquote>One thing to watch out for is how the web server is referenced
when using the
<br>JavaMailServlet on this web server. It is important to use the
configured server
<br>name (i.e. the name assigned with the ServerName directive) in the
URL. If the
<br>configured server name includes a domain, it must be referenced including
the
<br>domain, even if the JavaMail.html page can be accessed without it.
<p>For example, Apache is configured with the ServerName set to 'shadygrove'.
If the JavaMail demo is referenced by:
<p> http://shadygrove.east/example/JavaMail.html
<p>and the initail reference to the JavaMailServlet being:
<p> http://shadygrove.east/example/JavaMailServlet
<p>the user is successfully logged in. However, when an attempt is made
to access the INBOX, the user is instructed to login because there is no
current session. When this occurs, note that the URL referencing the JavaMailServlet
no longer contains the domain originally used but the configured ServerName.
<p> http://shadygrove/example/JavaMailServlet
<br>
<p>Also note that Apache JServ does not use a SecurityManager or enforce
any Java
<br>security policy.</blockquote>
</body>
</html>