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