You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-dev@james.apache.org by ba...@apache.org on 2006/11/15 12:20:59 UTC
svn commit: r475204 - in /james/server/branches/v2.3: ./ src/site/xdoc/
src/site/xdoc/stylesheets/
Author: bago
Date: Wed Nov 15 03:20:56 2006
New Revision: 475204
URL: http://svn.apache.org/viewvc?view=rev&rev=475204
Log:
Fixed a bunch of broken links on the new website (JAMES-691)
Added:
james/server/branches/v2.3/src/site/xdoc/usingTLS.xml (with props)
Modified:
james/server/branches/v2.3/pom.xml
james/server/branches/v2.3/src/site/xdoc/index.xml
james/server/branches/v2.3/src/site/xdoc/installation_instructions.xml
james/server/branches/v2.3/src/site/xdoc/provided_mailets.xml
james/server/branches/v2.3/src/site/xdoc/stylesheets/project.xml
james/server/branches/v2.3/src/site/xdoc/summary.xml
james/server/branches/v2.3/src/site/xdoc/using_database.xml
Modified: james/server/branches/v2.3/pom.xml
URL: http://svn.apache.org/viewvc/james/server/branches/v2.3/pom.xml?view=diff&rev=475204&r1=475203&r2=475204
==============================================================================
--- james/server/branches/v2.3/pom.xml (original)
+++ james/server/branches/v2.3/pom.xml Wed Nov 15 03:20:56 2006
@@ -31,7 +31,7 @@
<groupId>org.apache.james</groupId>
<artifactId>james-server</artifactId>
<name>Apache JAMES Server</name>
- <version>2.3.0-SNAPSHOT</version>
+ <version>2.3.1-SNAPSHOT</version>
<packaging>jar</packaging>
<description>
The Apache Java Enterprise Mail Server (a.k.a. JAMES Server)
Modified: james/server/branches/v2.3/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/james/server/branches/v2.3/src/site/xdoc/index.xml?view=diff&rev=475204&r1=475203&r2=475204
==============================================================================
--- james/server/branches/v2.3/src/site/xdoc/index.xml (original)
+++ james/server/branches/v2.3/src/site/xdoc/index.xml Wed Nov 15 03:20:56 2006
@@ -84,7 +84,6 @@
<li><a href="smtp_auth.html">Using SMTP AUTH</a></li>
<li><a href="using_database.html">Using a Database with James</a></li>
<li><a href="usingTLS.html">Using TLS/SSL</a></li>
-<li><a href="james_and_sendmail.html">James and Sendmail</a></li>
<li><a href="mailing_lists.html">Creating Mailing Lists</a></li>
</ul>
VI. Customizing James
Modified: james/server/branches/v2.3/src/site/xdoc/installation_instructions.xml
URL: http://svn.apache.org/viewvc/james/server/branches/v2.3/src/site/xdoc/installation_instructions.xml?view=diff&rev=475204&r1=475203&r2=475204
==============================================================================
--- james/server/branches/v2.3/src/site/xdoc/installation_instructions.xml (original)
+++ james/server/branches/v2.3/src/site/xdoc/installation_instructions.xml Wed Nov 15 03:20:56 2006
@@ -89,7 +89,7 @@
</ul>
<p>In addition to adjusting these parameters, you may wish to consult the documentation for a discussion of
common configurations. A list of such configurations, as well as the steps necessary to configure them, can
-be found <a href="documentation.html">here</a>.</p>
+be found <a href="index.html">here</a>.</p>
</section>
<section name="Starting James with Your Configuration">
<p>Once you have edited the configuration file you will need to restart James so that the changes take
Modified: james/server/branches/v2.3/src/site/xdoc/provided_mailets.xml
URL: http://svn.apache.org/viewvc/james/server/branches/v2.3/src/site/xdoc/provided_mailets.xml?view=diff&rev=475204&r1=475203&r2=475204
==============================================================================
--- james/server/branches/v2.3/src/site/xdoc/provided_mailets.xml (original)
+++ james/server/branches/v2.3/src/site/xdoc/provided_mailets.xml Wed Nov 15 03:20:56 2006
@@ -368,7 +368,7 @@
This mailet can produce listserver, forward and notify behaviour, with the
original message intact, attached, appended or left out altogether.<br/>
This built in functionality is controlled by the configuration as described
- <a href="javadocs/org/apache/james/transport/mailets/Redirect.html">here</a>.</p>
+ <a href="apidocs/org/apache/james/transport/mailets/Redirect.html">here</a>.</p>
<p>It is also intended to be easily subclassed to make providing bespoke redirection
mailets simple. <br/>
By extending it and overriding one or more of its methods new behaviour can
Modified: james/server/branches/v2.3/src/site/xdoc/stylesheets/project.xml
URL: http://svn.apache.org/viewvc/james/server/branches/v2.3/src/site/xdoc/stylesheets/project.xml?view=diff&rev=475204&r1=475203&r2=475204
==============================================================================
--- james/server/branches/v2.3/src/site/xdoc/stylesheets/project.xml (original)
+++ james/server/branches/v2.3/src/site/xdoc/stylesheets/project.xml Wed Nov 15 03:20:56 2006
@@ -38,7 +38,6 @@
<item name="Using SMTP AUTH" href="/smtp_auth.html" />
<item name="Using a Database with James" href="/using_database.html" />
<item name="Using TLS/SSL" href="/usingTLS.html" />
- <item name="James and Sendmail" href="/james_and_sendmail.html" />
<item name="Creating Mailing Lists" href="/mailing_lists.html" />
</menu>
Modified: james/server/branches/v2.3/src/site/xdoc/summary.xml
URL: http://svn.apache.org/viewvc/james/server/branches/v2.3/src/site/xdoc/summary.xml?view=diff&rev=475204&r1=475203&r2=475204
==============================================================================
--- james/server/branches/v2.3/src/site/xdoc/summary.xml (original)
+++ james/server/branches/v2.3/src/site/xdoc/summary.xml Wed Nov 15 03:20:56 2006
@@ -82,7 +82,7 @@
servers and deliver them to the local spool. This is useful for consolidating mail delivered to a
number of accounts on different machines to a single account.</p>
-<p>More information on configuring FetchMail can be found <a href="fetchpop_configuration.html">here</a>.</p>
+<p>More information on configuring FetchMail can be found <a href="fetchmail_configuration.html">here</a>.</p>
</section>
<section name="The SpoolManager, Matchers, and Mailets">
Added: james/server/branches/v2.3/src/site/xdoc/usingTLS.xml
URL: http://svn.apache.org/viewvc/james/server/branches/v2.3/src/site/xdoc/usingTLS.xml?view=auto&rev=475204
==============================================================================
--- james/server/branches/v2.3/src/site/xdoc/usingTLS.xml (added)
+++ james/server/branches/v2.3/src/site/xdoc/usingTLS.xml Wed Nov 15 03:20:56 2006
@@ -0,0 +1,89 @@
+<?xml version="1.0"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<document>
+
+ <properties>
+ <title>James 2.3 - Using TLS</title>
+ </properties>
+
+<body>
+
+<section name="James 2.3 - Using TLS">
+
+<p>
+This document explains how to enable James 2.3 services to use Transport Layer Security (TLS) for encrypted client-server communication.</p>
+
+<subsection name="Making TLS/SSL Server Sockets Available Inside James">
+<p>James uses the Sun Java Secure Sockets Extension (JSSE) infrastructure to provide TLS/SSL
+sockets. JSSE comes packaged with several vendor Java distributions (i.e. Sun Java 1.4.x,
+IBM Java 1.3.x). For these distributions, please follow the vendor provided instructions for
+configuring the JVM to use JSSE services.</p>
+
+<p>If you are using a Java distribution that does not include JSSE as part of the
+distribution you will need to download the JSSE package separately. It can be obtained from
+<a href="http://java.sun.com/products/jsse">here</a>. Please follow Sun's instructions for installation
+and configuration of JSSE.</p>
+<p>In either case, you will need to statically define a JSSE TLS provider. In general, this
+is the default installation.</p>
+<p>Once you've installed JSSE, James still needs to be configured to take advantage of the JSSE
+functionality.</p>
+</subsection>
+<subsection name="Certificate Keystores">
+<p>To use TLS/SSL inside James you will need a certificate keystore.</p>
+</subsection>
+<subsection name="Configuring the Server Socket Factory">
+<p>The out of the box configuration file contains a template for the SSL configuration in place. Specifically,
+in the sockets block, under the server-sockets element, there is a commented out factory with the
+name "ssl". The first step to configuring the server socket factory is uncommenting out this element.</p>
+<p>The factory element contains several children. Of these, it should only be necessary to adjust two or three children.</p>
+<p>The required file element specifies the location of the keystore to be used by the factory. This is specified
+as a file path using Unix-style formatting. The path is taken to be relative to the apps/james/ subdirectory of
+the application installation directory unless an absolute path is specified.</p>
+<p>The password element should be set to the keystore password. This password should have been specified
+when the keystore was created, and it is required to open the keystore. This value is required.</p>
+<p>Finally, it may be necessary to adjust the type element. This element can take on any keystore type
+supported by the JSSE provider being used (see the JSSE documentation for details). The out of the box
+configuration specifies JKS (Java Keystore).</p>
+<p>The remaining children should not need to be deleted or adjusted.</p>
+</subsection>
+<subsection name="Configuring a Service to Use TLS">
+<p>Each of the services - <a href="smtp_configuration.html">SMTP</a>,
+<a href="pop3_configuration.html">POP3</a>, <a href="nntp_configuration.html">NNTP</a>,
+and <a href="remotemanager_configuration.html">RemoteManager</a> - supports use of TLS. Each of
+these services has an optional boolean configuration element <b>useTLS</b> which is used to toggle
+use of TLS for the service. When this value is set to true, that particular service will use the "ssl"
+server socket factory to spawn server sockets.</p>
+</subsection>
+<subsection name="Verifying a TLS-enabled James Service">
+<p>After you've configured a particular service to use TLS/SSL connections, the service port
+should no longer accept unencrypted TCP/IP connections. This can be tested by using a telnet
+client to directly connect to the service port. The telnet connection should simply hang until
+the client times out.</p>
+<p>
+To validate that the port is properly accepting SSL connections an SSL client can be used to
+open a connection to the service port. One such client is OpenSSL, available from the
+<a href="http://www.openssl.org">OpenSSL web site</a>. Follow the instructions provided with
+the SSL client to create a connection to the service port. Upon connection, the usual
+service greeting should appear.</p>
+</subsection>
+</section>
+
+</body>
+</document>
Propchange: james/server/branches/v2.3/src/site/xdoc/usingTLS.xml
------------------------------------------------------------------------------
svn:eol-style = native
Modified: james/server/branches/v2.3/src/site/xdoc/using_database.xml
URL: http://svn.apache.org/viewvc/james/server/branches/v2.3/src/site/xdoc/using_database.xml?view=diff&rev=475204&r1=475203&r2=475204
==============================================================================
--- james/server/branches/v2.3/src/site/xdoc/using_database.xml (original)
+++ james/server/branches/v2.3/src/site/xdoc/using_database.xml Wed Nov 15 03:20:56 2006
@@ -135,7 +135,7 @@
<subsection name="Known Issues">
<p>There are some vendor-specific subtleties in using databases with James that have been observed
by some users. These issues (and methods to resolve them) are recorded on the
-<a href="FAQ.html">James FAQ</a> as they are reported. Please consult the FAQ if you encounter any
+<a href="../FAQ.html">James FAQ</a> as they are reported. Please consult the FAQ if you encounter any
difficulties.</p>
</subsection>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org