ApacheJServ.html revision 292
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey<html>
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey<head>
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey<!--
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey Copyright (c) 2010 Oracle and/or its affiliates. All rights reserved.
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey The contents of this file are subject to the terms of either the GNU
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey General Public License Version 2 only ("GPL") or the Common Development
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey and Distribution License("CDDL") (collectively, the "License"). You
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey may not use this file except in compliance with the License. You can
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey obtain a copy of the License at
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey or packager/legal/LICENSE.txt. See the License for the specific
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey language governing permissions and limitations under the License.
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey When distributing the software, include this License Header Notice in each
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey file and include the License file at packager/legal/LICENSE.txt.
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey GPL Classpath Exception:
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey Oracle designates this particular file as subject to the "Classpath"
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey exception as provided by Oracle in the GPL Version 2 section of the License
a90aba9cbcbb8e7fe95e45590d853959efe0d354Tom Rumsey file that accompanied this code.
a90aba9cbcbb8e7fe95e45590d853959efe0d354Tom Rumsey
a90aba9cbcbb8e7fe95e45590d853959efe0d354Tom Rumsey Modifications:
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey If applicable, add the following below the License Header, with the fields
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey enclosed by brackets [] replaced by your own identifying information:
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey "Portions Copyright [year] [name of copyright owner]"
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey Contributor(s):
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey If you wish your version of this file to be governed by only the CDDL or
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey only the GPL Version 2, indicate your decision by adding "[Contributor]
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey elects to include this software in this distribution under the [CDDL or GPL
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey Version 2] license." If you don't indicate a single choice of license, a
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey recipient has the option to distribute your version of this file under
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey either the CDDL, the GPL Version 2 or to extend the choice of license to
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey its licensees as provided above. However, if you add GPL Version 2 code
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey and therefore, elected the GPL Version 2 license, then the option applies
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey only if the new code is made subject to such option by the copyright
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey holder.
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey-->
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey <meta name="Author" content="JavaSoftware">
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey <meta name="GENERATOR" content="Mozilla/4.61 [en] (WinNT; U) [Netscape]">
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey <title>ApacheJServ</title>
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey</head>
7d46f125408af7521e0e8021e0da5609fb8f7ec2Tom Rumsey<body>
If you don't already have Apache web server and Apache JServ
module installed and running,
<br>you'll need to download them from the&nbsp; <a href="http://www.apache.org">Apache
Software Foundation</a>&nbsp; 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)
<blockquote>Apache Web Server 1.3.9 (<a href="http://httpd.apache.org/dist/binaries/">binary</a>)
<br>Apache JServ 1.1.2 (built from <a href="http://java.apache.org/">source</a>)</blockquote>
(on NT)
<blockquote>Apache Web Server&nbsp; 1.3.14 (<a href="http://httpd.apache.org/dist/binaries/">binary</a>)
<br>Apache JServ 1.1.2 (<a href="http://java.apache.org/">binary</a>)</blockquote>
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&nbsp; 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)
<blockquote>wrapper.classpath=/files/java/lib/JSDK2.0/lib/jsdk.jar
<br>wrapper.classpath=/files/java/lib/javamail-1.2/mail.jar
<br>wrapper.classpath=/files/java/lib/jaf-1.0.1/activation.jar</blockquote>
(on NT)
<blockquote>wrapper.classpath=d:\java\lib\jsdk2.0\lib\jsdk.jar
<br>wrapper.classpath=d:\java\lib\javamail-1.2\mail.jar
<br>wrapper.classpath=d:\java\lib\jaf-1.0.1\activation.jar</blockquote>
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
<br>Windows NT information is provided <a href="classpath-NT.html">here</a>).
<p>Once this is done, restart the web server.
<br>&nbsp;
<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.&nbsp; 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>&nbsp;&nbsp;&nbsp; http://shadygrove.east/example/JavaMail.html
<p>and the initail reference to the JavaMailServlet being:
<p>&nbsp;&nbsp;&nbsp; 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>&nbsp;&nbsp;&nbsp; http://shadygrove/example/JavaMailServlet
<br>&nbsp;
<p>Also note that Apache JServ does not use a SecurityManager or enforce
any Java
<br>security policy.</blockquote>
</body>
</html>