http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/feature-mailetcontainer.html ---------------------------------------------------------------------- diff --git a/content/server/feature-mailetcontainer.html b/content/server/feature-mailetcontainer.html index bc0e1ce..6ab63e9 100644 --- a/content/server/feature-mailetcontainer.html +++ b/content/server/feature-mailetcontainer.html @@ -18,12 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - - Apache James Server 3 - Mailet API</title> + <title>Apache James Project – Apache James Server 3 - Mailet API</title> <style type="text/css" media="all"> @import url("../css/james.css"); @import url("../css/maven-base.css"); @@ -37,11 +36,9 @@ <script type="text/javascript" src="../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - + <!-- Google Analytics --> <script type="text/javascript"> @@ -77,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../index.html" title="Home">Home</a> | @@ -188,7 +185,7 @@ <a href="../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../other-versions.html" title="Other versions">Other versions</a> + <a href="../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -243,31 +240,16 @@ </div> <div id="bodyColumn"> <div id="contentBox"> - <!-- 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. --> + <div class="section"> -<h2>MailetContainer<a name="MailetContainer"></a></h2> +<h2><a name="MailetContainer"></a>MailetContainer</h2> <div class="section"> -<h3>Introduction<a name="Introduction"></a></h3> +<h3><a name="Introduction"></a>Introduction</h3> <p>James separates the services that deliver mail to James (i.e. SMTP, FetchMail) @@ -282,7 +264,7 @@ <div class="section"> -<h3>Matchers and Mailets<a name="Matchers_and_Mailets"></a></h3> +<h3><a name="Matchers_and_Mailets"></a>Matchers and Mailets</h3> <p>Core to the SpoolManager operation are Matchers and Mailets. A Matcher is a @@ -292,23 +274,26 @@ to a local repository, or handling remote delivery. Both the Matcher and Mailet APIs are public, allowing James users to write their own custom matchers and mailets. James comes with a large set of pre-built matchers and mailets.</p> + - -<p>Matchers and mailets are used in pairs. At each stage in processing a message is checked +<p>Matchers and mailets are used in pairs. At each stage in processing a message is checked against a matcher. The matcher will attempt to match the mail message. The match is not simply - a yes or no issue. Instead, the match method returns a collection of matched recipients. If the + a yes or no issue. Instead, the match method returns a collection of matched recipients. If the this collection of matched recipients is empty, the mailet is not invoked. If the collection of - matched recipients is the entire set of original recipients, the mail is then processed by the + matched recipients is the entire set of original recipients, the mail is then processed by the associated mailet. Finally, if the matcher only matches a proper subset of the original recipients, the original mail is duplicated. The recipients for one message are set to the matched recipients, and that message is processed by the mailet. The recipients for the other mail are set to the non-matching recipients, and that message is not processed by the mailet.</p> + + +<p>Note that you can specify per mailet and per matcher specific <a href="config-mailetcontainer.html#Error_handling">error handling logic.</a></p> </div> <div class="section"> -<h3>Processors<a name="Processors"></a></h3> +<h3><a name="Processors"></a>Processors</h3> <p>One level up from the matchers and mailets are the processors. Each processor @@ -328,7 +313,7 @@ <div class="section"> -<h3>SpoolManager<a name="SpoolManager"></a></h3> +<h3><a name="SpoolManager"></a>SpoolManager</h3> <p>The SpoolManager continually checks for mail in the spool repository. When @@ -343,8 +328,8 @@ <p>More on configuration of the SpoolManager can be found <a href="config-mailetcontainer.html">here</a>.</p> -<p>Much of the power of James lies in the SpoolManager component. Custom matchers and - mailets can be easily developed to address an administrator's particular needs. The +<p>Much of the power of James lies in the SpoolManager component. <a href="dev-extend-matcher.html">Custom matchers</a> and + <a href="dev-extend-mailet.html">custom mailets</a> can be easily developed to address an administrator's particular needs. The processor tree can easily be configured to sort, filter, and deliver mail based on any number of criteria. Mail administrators new to James should spend some time learning how to configure the SpoolManager to meet their needs.</p> @@ -353,7 +338,7 @@ <div class="section"> -<h3>Mailet API<a name="Mailet_API"></a></h3> +<h3><a name="Mailet_API"></a>Mailet API</h3> <p>The Mailet API is a simple API used to build mail processing applications. James is a Mailet @@ -383,14 +368,10 @@ <p>The Javadoc for the Mailet API can be found <a class="externalLink" href="http://james.apache.org/mailet/api/apidocs/";>here</a>.</p> - - -<p>James bundles a number of Matchers and Mailets in its distribution. Descriptions of provided matchers - can be found <a href="dev-provided-matchers.html">here</a>, while descriptions of provided mailets can be found - <a href="dev-provided-mailets.html">here</a>.</p> -<p>You can retrieve the full list of mailets and matchers packaged in James <a href="dev-provided-mailets.html">here</a></p> +<p>James bundles a number of Matchers and Mailets in its distribution. You can retrieve the full list of mailets + and matchers packaged in James <a href="dev-provided-mailets.html">here</a></p> <p>You can read more on mailets on following web sites:</p> @@ -422,7 +403,7 @@ <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved.
http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/feature-performance.html ---------------------------------------------------------------------- diff --git a/content/server/feature-performance.html b/content/server/feature-performance.html index 1d3717f..aaa4140 100644 --- a/content/server/feature-performance.html +++ b/content/server/feature-performance.html @@ -18,12 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - - Apache James Server 3 - Performance</title> + <title>Apache James Project – Apache James Server 3 - Performance</title> <style type="text/css" media="all"> @import url("../css/james.css"); @import url("../css/maven-base.css"); @@ -37,11 +36,9 @@ <script type="text/javascript" src="../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - + <!-- Google Analytics --> <script type="text/javascript"> @@ -77,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../index.html" title="Home">Home</a> | @@ -188,7 +185,7 @@ <a href="../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../other-versions.html" title="Other versions">Other versions</a> + <a href="../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -243,31 +240,16 @@ </div> <div id="bodyColumn"> <div id="contentBox"> - <!-- 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. --> + <div class="section"> -<h2>Performance<a name="Performance"></a></h2> +<h2><a name="Performance"></a>Performance</h2> <div class="section"> -<h3>Gatling load testing<a name="Gatling_load_testing"></a></h3> +<h3><a name="Gatling_load_testing"></a>Gatling load testing</h3> <p>In mail servers, performance do matters. Users expect good, and fast responding commands. Thus performance is a priority concern for Apache James developers.</p> @@ -302,7 +284,7 @@ <div class="section"> -<h3>Metric collection<a name="Metric_collection"></a></h3> +<h3><a name="Metric_collection"></a>Metric collection</h3> <p> Additionally, we added metrics a bit everywhere in James using the brand new metrics API. We collect and export everything in ElasticSearch using <a class="externalLink" href="http://metrics.dropwizard.io/3.2.1/";>Dropwizard metrics</a>. Then we @@ -342,7 +324,7 @@ <div class="section"> -<h3>Measuring dequeueing speed<a name="Measuring_dequeueing_speed"></a></h3> +<h3><a name="Measuring_dequeueing_speed"></a>Measuring dequeueing speed</h3> <p>James can spool more than 65 mails per second (configured with Maildir mail storage and the FileMailQueue).</p> @@ -383,7 +365,7 @@ gatling:testOnly org.apache.james.gatling.smtp.scenari.NoAuthenticationNoEncrypt <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved. http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/feature-persistence.html ---------------------------------------------------------------------- diff --git a/content/server/feature-persistence.html b/content/server/feature-persistence.html index a1e34c3..6f6d6f4 100644 --- a/content/server/feature-persistence.html +++ b/content/server/feature-persistence.html @@ -18,12 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - - Apache James Server 3 - Persistence</title> + <title>Apache James Project – Apache James Server 3 - Persistence</title> <style type="text/css" media="all"> @import url("../css/james.css"); @import url("../css/maven-base.css"); @@ -37,11 +36,9 @@ <script type="text/javascript" src="../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - + <!-- Google Analytics --> <script type="text/javascript"> @@ -77,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../index.html" title="Home">Home</a> | @@ -188,7 +185,7 @@ <a href="../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../other-versions.html" title="Other versions">Other versions</a> + <a href="../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -243,31 +240,16 @@ </div> <div id="bodyColumn"> <div id="contentBox"> - <!-- 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. --> + <div class="section"> -<h2>Mailbox and Mail Repository Store for Mail Persistence<a name="Mailbox_and_Mail_Repository_Store_for_Mail_Persistence"></a></h2> +<h2><a name="Mailbox_and_Mail_Repository_Store_for_Mail_Persistence"></a>Mailbox and Mail Repository Store for Mail Persistence</h2> <div class="section"> -<h3>Introduction<a name="Introduction"></a></h3> +<h3><a name="Introduction"></a>Introduction</h3> <p>The <b>Mailbox</b> persists users' Inbox, Sent Items, Trash... folders with their mails.</p> @@ -282,7 +264,7 @@ <div class="section"> -<h3>Mailbox Persistence<a name="Mailbox_Persistence"></a></h3> +<h3><a name="Mailbox_Persistence"></a>Mailbox Persistence</h3> <p>Apache James Server uses the <a class="externalLink" href="http://james.apache.org/mailbox";>Apache James Mailbox</a> storage system @@ -300,7 +282,7 @@ <div class="section"> -<h3>Mail Repository Store Persistence<a name="Mail_Repository_Store_Persistence"></a></h3> +<h3><a name="Mail_Repository_Store_Persistence"></a>Mail Repository Store Persistence</h3> <p>Available Mail Repository Store are defined in mailrepositorystore.xml. @@ -321,7 +303,7 @@ <div class="section"> -<h2>Domain Persistence<a name="Domain_Persistence"></a></h2> +<h2><a name="Domain_Persistence"></a>Domain Persistence</h2> <p>Read more on how to configure <a href="config-domainlist.html">domain persistence</a>.</p> @@ -330,7 +312,7 @@ <div class="section"> -<h2>User Persistence<a name="User_Persistence"></a></h2> +<h2><a name="User_Persistence"></a>User Persistence</h2> <p>Read more on how to configure <a href="config-users.html">users persistence</a>.</p> @@ -346,7 +328,7 @@ <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved. http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/feature-protocols.html ---------------------------------------------------------------------- diff --git a/content/server/feature-protocols.html b/content/server/feature-protocols.html index 94ea4dd..45c3310 100644 --- a/content/server/feature-protocols.html +++ b/content/server/feature-protocols.html @@ -18,12 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - - Apache James Server 3 - Feature - Servers</title> + <title>Apache James Project – Apache James Server 3 - Feature - Servers</title> <style type="text/css" media="all"> @import url("../css/james.css"); @import url("../css/maven-base.css"); @@ -37,11 +36,9 @@ <script type="text/javascript" src="../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - + <!-- Google Analytics --> <script type="text/javascript"> @@ -77,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../index.html" title="Home">Home</a> | @@ -188,7 +185,7 @@ <a href="../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../other-versions.html" title="Other versions">Other versions</a> + <a href="../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -243,31 +240,16 @@ </div> <div id="bodyColumn"> <div id="contentBox"> - <!-- 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. --> + <div class="section"> -<h2>Servers<a name="Servers"></a></h2> +<h2><a name="Servers"></a>Servers</h2> <div class="section"> -<h3>Introduction<a name="Introduction"></a></h3> +<h3><a name="Introduction"></a>Introduction</h3> <p>Apache James is an open source project intended to produce a robust, flexible, and powerful @@ -289,7 +271,7 @@ <div class="section"> -<h3>SMTP Protocol<a name="SMTP_Protocol"></a></h3> +<h3><a name="SMTP_Protocol"></a>SMTP Protocol</h3> <p>SMTP (Simple Mail Transport Protocol) is the standard method of sending and delivering @@ -308,7 +290,7 @@ <div class="section"> -<h3>IMAP4 Protocol<a name="IMAP4_Protocol"></a></h3> +<h3><a name="IMAP4_Protocol"></a>IMAP4 Protocol</h3> <p>The IMAP4 protocol allows users to retrieve email messages. It is the method @@ -356,7 +338,7 @@ <div class="section"> -<h3>POP3 Protocol<a name="POP3_Protocol"></a></h3> +<h3><a name="POP3_Protocol"></a>POP3 Protocol</h3> <p>The POP3 protocol allows users to retrieve email messages. It is the method @@ -379,7 +361,7 @@ <div class="section"> -<h3>FetchMail<a name="FetchMail"></a></h3> +<h3><a name="FetchMail"></a>FetchMail</h3> <p>FetchMail, unlike the other Apache James components, is not an implementation of an RFC. Instead, it's a @@ -394,7 +376,7 @@ <div class="section"> -<h3>JMX<a name="JMX"></a></h3> +<h3><a name="JMX"></a>JMX</h3> <p>JMX (Java Management Extension) is used for the management.</p> @@ -412,7 +394,7 @@ <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved. http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/feature-queue-priority.html ---------------------------------------------------------------------- diff --git a/content/server/feature-queue-priority.html b/content/server/feature-queue-priority.html index 18e930c..1873c50 100644 --- a/content/server/feature-queue-priority.html +++ b/content/server/feature-queue-priority.html @@ -18,12 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - - Apache James Server 3 - Queue Priority</title> + <title>Apache James Project – Apache James Server 3 - Queue Priority</title> <style type="text/css" media="all"> @import url("../css/james.css"); @import url("../css/maven-base.css"); @@ -37,11 +36,9 @@ <script type="text/javascript" src="../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - + <!-- Google Analytics --> <script type="text/javascript"> @@ -77,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../index.html" title="Home">Home</a> | @@ -188,7 +185,7 @@ <a href="../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../other-versions.html" title="Other versions">Other versions</a> + <a href="../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -243,27 +240,12 @@ </div> <div id="bodyColumn"> <div id="contentBox"> - <!-- 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. --> + <div class="section"> -<h2>Priority in the Spooling Queues<a name="Priority_in_the_Spooling_Queues"></a></h2> +<h2><a name="Priority_in_the_Spooling_Queues"></a>Priority in the Spooling Queues</h2> <p>Priority is supported when James (de)queues the mails during the spooling process.</p> @@ -291,7 +273,7 @@ <div class="section"> -<h2>Usage Scenario<a name="Usage_Scenario"></a></h2> +<h2><a name="Usage_Scenario"></a>Usage Scenario</h2> <p>There are two scenarios to set priority in the queue.</p> @@ -316,7 +298,7 @@ <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved. http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/feature-security.html ---------------------------------------------------------------------- diff --git a/content/server/feature-security.html b/content/server/feature-security.html index c0b6fca..e0f1055 100644 --- a/content/server/feature-security.html +++ b/content/server/feature-security.html @@ -18,12 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - - Apache James Server 3 - Security</title> + <title>Apache James Project – Apache James Server 3 - Security</title> <style type="text/css" media="all"> @import url("../css/james.css"); @import url("../css/maven-base.css"); @@ -37,11 +36,9 @@ <script type="text/javascript" src="../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - + <!-- Google Analytics --> <script type="text/javascript"> @@ -77,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../index.html" title="Home">Home</a> | @@ -188,7 +185,7 @@ <a href="../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../other-versions.html" title="Other versions">Other versions</a> + <a href="../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -243,27 +240,12 @@ </div> <div id="bodyColumn"> <div id="contentBox"> - <!-- 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. --> + <div class="section"> -<h2>SMTP Security<a name="SMTP_Security"></a></h2> +<h2><a name="SMTP_Security"></a>SMTP Security</h2> <p>Apache James Server is configured by default to avoid being an SMTP open-relay.</p> @@ -275,7 +257,7 @@ <div class="section"> -<h2>Encryption Security<a name="Encryption_Security"></a></h2> +<h2><a name="Encryption_Security"></a>Encryption Security</h2> <p>Apache James Server supports SSL/TLS (<a href="config-ssl-tls.html">read more</a>).</p> @@ -284,12 +266,41 @@ <div class="section"> -<h2>User Credential Security<a name="User_Credential_Security"></a></h2> +<h2><a name="User_Credential_Security"></a>User Credential Security</h2> -<p>Apache James Server supports different user storage (<a href="config-users.html">read more</a>) - LDAP support is partail (work in progress).</p> +<p>Apache James Server supports different user storage (<a href="config-users.html">read more</a>) - LDAP support is partial (work in progress).</p> </div> + + +<div class="section"> +<h2><a name="Reported_vulnerabilities"></a>Reported vulnerabilities</h2> + +<div class="section"> +<h3><a name="Apache_James_3.0.0"></a>Apache James 3.0.0</h3> + +<p>The Apache James Server version 3.0.0 is vulnerable to Java deserialization issues.</p> + +<p>One can use this for privilege escalation.</p> + +<p>This issue can be mitigated by:</p> + +<ul> + +<li>Upgrading to James 3.0.1</li> + +<li>Using a recent JRE (Exploit could not be reproduced on OpenJdk 8 u141)</li> + +<li>Exposing JMX socket only to localhost (default behaviour)</li> + +<li>Possibly running James in a container</li> + </ul> + +<p>Read more <a class="externalLink" href="http://james.apache.org//james/update/2017/10/20/james-3.0.1.html";>here</a>.</p> + </div> + + </div> @@ -300,7 +311,7 @@ <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved. http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/feature-smtp-hooks.html ---------------------------------------------------------------------- diff --git a/content/server/feature-smtp-hooks.html b/content/server/feature-smtp-hooks.html index ec154d9..e8c3680 100644 --- a/content/server/feature-smtp-hooks.html +++ b/content/server/feature-smtp-hooks.html @@ -18,12 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - - Apache James Server 3 - James - Features - SMTP Hooks</title> + <title>Apache James Project – Apache James Server 3 - James - Features - SMTP Hooks</title> <style type="text/css" media="all"> @import url("../css/james.css"); @import url("../css/maven-base.css"); @@ -37,11 +36,9 @@ <script type="text/javascript" src="../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - + <!-- Google Analytics --> <script type="text/javascript"> @@ -77,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../index.html" title="Home">Home</a> | @@ -188,7 +185,7 @@ <a href="../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../other-versions.html" title="Other versions">Other versions</a> + <a href="../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -243,27 +240,12 @@ </div> <div id="bodyColumn"> <div id="contentBox"> - <!-- 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. --> + <div class="section"> -<h2>SMTP Hooks<a name="SMTP_Hooks"></a></h2> +<h2><a name="SMTP_Hooks"></a>SMTP Hooks</h2> <p>The James SMTP Server Component allows to easy write your own code which will get executed @@ -292,7 +274,7 @@ <div class="section"> -<h2>Provided SMTP Hooks<a name="Provided_SMTP_Hooks"></a></h2> +<h2><a name="Provided_SMTP_Hooks"></a>Provided SMTP Hooks</h2> Read more on the <a href="dev-provided-smtp-hooks.html">provided SMTP Hooks</a>. @@ -300,7 +282,7 @@ <div class="section"> -<h2>Create your own SMTP Hooks<a name="Create_your_own_SMTP_Hooks"></a></h2> +<h2><a name="Create_your_own_SMTP_Hooks"></a>Create your own SMTP Hooks</h2> Read more on how to create your <a href="dev-extend-smtp-hook.html">own SMTP Hook</a>. @@ -315,7 +297,7 @@ <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved. http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/features.html ---------------------------------------------------------------------- diff --git a/content/server/features.html b/content/server/features.html index f096554..7adf3be 100644 --- a/content/server/features.html +++ b/content/server/features.html @@ -18,12 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - - Apache James Server 3 - Features</title> + <title>Apache James Project – Apache James Server 3 - Features</title> <style type="text/css" media="all"> @import url("../css/james.css"); @import url("../css/maven-base.css"); @@ -37,11 +36,9 @@ <script type="text/javascript" src="../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - + <!-- Google Analytics --> <script type="text/javascript"> @@ -77,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../index.html" title="Home">Home</a> | @@ -188,7 +185,7 @@ <a href="../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../other-versions.html" title="Other versions">Other versions</a> + <a href="../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -243,22 +240,7 @@ </div> <div id="bodyColumn"> <div id="contentBox"> - <!-- 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. --> + <h1>Features</h1> @@ -865,7 +847,7 @@ <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved. http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/index.html ---------------------------------------------------------------------- diff --git a/content/server/index.html b/content/server/index.html index d357e50..966b006 100644 --- a/content/server/index.html +++ b/content/server/index.html @@ -18,12 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - - Apache James Server 3 - Index</title> + <title>Apache James Project – Apache James Server 3 - Index</title> <style type="text/css" media="all"> @import url("../css/james.css"); @import url("../css/maven-base.css"); @@ -37,11 +36,9 @@ <script type="text/javascript" src="../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - <script type="text/javascript" src="./js/index.js"></script> + <script type="text/javascript" src="./js/index.js"></script> <!-- Google Analytics --> <script type="text/javascript"> @@ -77,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../index.html" title="Home">Home</a> | @@ -139,7 +136,7 @@ <a href="../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../other-versions.html" title="Other versions">Other versions</a> + <a href="../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -194,35 +191,20 @@ </div> <div id="bodyColumn"> <div id="contentBox"> - <!-- 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. --> + - + <p>The server project wires together the different libraries composing James to provide a running service. It introduces for example Netty wrappers for protocols, the Mail Queue component as well as Mailet container for mail processing, and storage API for server related storage. Wiring is done thanks to Inversion of Control using either Guice or Spring.</p> - -<p>This documentation is intended to be an introduction to the concepts behind the Apache James Server usage, as well - as a guide to <a href="install.html">install</a>, <a href="config.html">configure</a> , - <a href="manage.html">manage</a>, <a href="monitor.html">monitor</a> - and <a href="dev.html">develop</a> Apache James Server.</p> + +<p>This documentation is intended to be an introduction to the concepts behind the Apache James Server usage, as well + as a guide to <a href="install.html">install</a>, <a href="config.html">configure</a> , + <a href="manage.html">manage</a>, <a href="monitor.html">monitor</a> + and <a href="dev.html">develop</a> Apache James Server.</p> <p>Download Apache James Mail Server 3.0.0 and <a href="quick-start.html">quick-start</a> it!</p> @@ -258,7 +240,7 @@ <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved. http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/install.html ---------------------------------------------------------------------- diff --git a/content/server/install.html b/content/server/install.html index 299da1f..5f8a4bd 100644 --- a/content/server/install.html +++ b/content/server/install.html @@ -18,12 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - - Apache James Server 3 - Installation</title> + <title>Apache James Project – Apache James Server 3 - Installation</title> <style type="text/css" media="all"> @import url("../css/james.css"); @import url("../css/maven-base.css"); @@ -37,11 +36,9 @@ <script type="text/javascript" src="../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - + <!-- Google Analytics --> <script type="text/javascript"> @@ -77,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../index.html" title="Home">Home</a> | @@ -176,7 +173,7 @@ <a href="../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../other-versions.html" title="Other versions">Other versions</a> + <a href="../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -231,42 +228,24 @@ </div> <div id="bodyColumn"> <div id="contentBox"> - <!-- 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. --> + <div class="section"> -<h2>Requirements<a name="Requirements"></a></h2> +<h2><a name="Requirements"></a>Requirements</h2> <div class="section"> -<h3>Java Virtual Machine<a name="Java_Virtual_Machine"></a></h3> +<h3><a name="Java_Virtual_Machine"></a>Java Virtual Machine</h3> -<p>James requires a Java Runtime Environment. Java version 1.6 or higher is required to run the +<p>James 3.0 requires a Java Runtime Environment. Java version 1.6 or higher is required to run the James application. The exact JREs available depends on the platform. In addition, the environment variable JAVA_HOME should be set to the JRE home directory before running James.</p> - + -<p>If you run JDK7, James will not start due to a bug in JAXB. As temporary workaround, you can - download the latest 2.1 version of JAXB from <a class="externalLink" href="http://jaxb.java.net/2.1.13/JAXB2_20100510.jar";> - http://jaxb.java.net/2.1.13/JAXB2_20100510.jar</a> - and copy the extracted jaxb-impl.jar into conf/lib.</p> +<p>After James 3.0 release, James requires Java version 1.8 or higher.</p> <p>James 3.0 has been successfully tested on OpenJDK, Sun JDK and IBM JDK</p> @@ -275,7 +254,7 @@ <div class="section"> -<h3>User Privileges<a name="User_Privileges"></a></h3> +<h3><a name="User_Privileges"></a>User Privileges</h3> <p>On Linux/Unix platforms, root access will be required to run James (access to ports @@ -290,7 +269,7 @@ <div class="section"> -<h3>Libc6<a name="Libc6"></a></h3> +<h3><a name="Libc6"></a>Libc6</h3> <p>On Linux, to run the startup/shutdown script via the 'james' command, you also need <tt>libc6</tt> @@ -300,7 +279,7 @@ <div class="section"> -<h3>System Resources<a name="System_Resources"></a></h3> +<h3><a name="System_Resources"></a>System Resources</h3> <p>Obviously James also requires sufficient disk space, processor power, and network bandwidth. But, @@ -320,7 +299,7 @@ <div class="section"> -<h2>Build instructions<a name="Build_instructions"></a></h2> +<h2><a name="Build_instructions"></a>Build instructions</h2> <p>Checkout code from the chosen version on <a class="externalLink" href="https://github.com/apache/james-project/tree/9502cfebfd9a4eaebbba7dda802d1fe0ad3589b7";> GitHub</a>. Follow <a class="externalLink" href="https://github.com/apache/james-project/blob/9502cfebfd9a4eaebbba7dda802d1fe0ad3589b7/README.adoc";>README instructions</a> about compilation.</p> @@ -353,13 +332,13 @@ <div class="section"> -<h2>Install Step by Step<a name="Install_Step_by_Step"></a></h2> +<h2><a name="Install_Step_by_Step"></a>Install Step by Step</h2> This guide documents how to install a Spring flavoured JAMES server. <div class="section"> -<h3>Step 1: Download James<a name="Step_1:_Download_James"></a></h3> +<h3><a name="Step_1:_Download_James"></a>Step 1: Download James</h3> <p>Obtain the full James binary (or source) distribution from @@ -378,7 +357,7 @@ <div class="section"> -<h3>Step 2: Deploy James<a name="Step_2:_Deploy_James"></a></h3> +<h3><a name="Step_2:_Deploy_James"></a>Step 2: Deploy James</h3> <p>Unpack the archive into your James installation directory.</p> @@ -387,19 +366,8 @@ <div class="section"> -<h3>Step 3: Configure James<a name="Step_3:_Configure_James"></a></h3> - <!-- <div class="ui-widget"> - <div class="ui-state-error ui-corner-all" style="padding: 0 .7em;"> - <p><span class="ui-icon ui-icon-alert" style="float: left; margin-right: .3em;"></span> - <strong>Preliminary step for JMX on Windows: </strong> - to let windows start with JMX username/password enabled, - you need to modify the security settings for the JMX files (./conf/jmx.password and ./conf/jmx.access) - like described here: - <a href="http://download.oracle.com/javase/1.5.0/docs/guide/management/security-windows.html";> - http://download.oracle.com/javase/1.5.0/docs/guide/management/security-windows.html</a> - </p> - </div> - </div> --> +<h3><a name="Step_3:_Configure_James"></a>Step 3: Configure James</h3> + <p>After unpacking the binary, the next step is to adjust the initial configuration. All configuration files are embedded in jars. We ship in the conf folder the configuration files that can be edited to match your needs. @@ -435,7 +403,7 @@ <div class="section"> -<h3>Step 4: Start James<a name="Step_4:_Start_James"></a></h3> +<h3><a name="Step_4:_Start_James"></a>Step 4: Start James</h3> <p>Go to the bin subdirectory of the installation directory and run <tt>$ ./james start</tt>.</p> @@ -451,7 +419,7 @@ <div class="section"> -<h3>Step 5: Create Domains and Users<a name="Step_5:_Create_Domains_and_Users"></a></h3> +<h3><a name="Step_5:_Create_Domains_and_Users"></a>Step 5: Create Domains and Users</h3> <p>Finally, after launch, it will be necessary to create domain and user accounts @@ -483,7 +451,7 @@ <div class="section"> -<h3>Step 6: Test James<a name="Step_6:_Test_James"></a></h3> +<h3><a name="Step_6:_Test_James"></a>Step 6: Test James</h3> <p>Once you have some local users registered, try sending mail to one of them @@ -541,7 +509,7 @@ Connection closed by foreign host. <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved. http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/install/guice-cassandra.html ---------------------------------------------------------------------- diff --git a/content/server/install/guice-cassandra.html b/content/server/install/guice-cassandra.html index 68976b8..757ea93 100644 --- a/content/server/install/guice-cassandra.html +++ b/content/server/install/guice-cassandra.html @@ -18,11 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - </title> + <title>Apache James Project – Guice-Cassandra installation guide</title> <style type="text/css" media="all"> @import url("../../css/james.css"); @import url("../../css/maven-base.css"); @@ -36,11 +36,9 @@ <script type="text/javascript" src="../../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - + <!-- Google Analytics --> <script type="text/javascript"> @@ -76,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../../index.html" title="Home">Home</a> | @@ -175,7 +173,7 @@ <a href="../../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../../other-versions.html" title="Other versions">Other versions</a> + <a href="../../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -232,9 +230,9 @@ <div id="contentBox"> <h1>Guice-Cassandra installation guide</h1> <div class="section"> -<h2>Building<a name="Building"></a></h2> +<h2><a name="Building"></a>Building</h2> <div class="section"> -<h3>Requirements<a name="Requirements"></a></h3> +<h3><a name="Requirements"></a>Requirements</h3> <ul> @@ -245,7 +243,7 @@ <li>Maven 3</li> </ul></div> <div class="section"> -<h3>Building the artifacts<a name="Building_the_artifacts"></a></h3> +<h3><a name="Building_the_artifacts"></a>Building the artifacts</h3> <p>An usual compilation using maven will produce two artifacts into server/container/guice/cassandra-guice/target directory:</p> <ul> @@ -257,12 +255,13 @@ <p>You can for example run in the base of <a class="externalLink" href="https://github.com/apache/james-project";>this git repository</a>:</p> <div class="source"> +<div class="source"> <pre>mvn clean install -</pre></div></div></div> +</pre></div></div></div></div> <div class="section"> -<h2>Running<a name="Running"></a></h2> +<h2><a name="Running"></a>Running</h2> <div class="section"> -<h3>Requirements<a name="Requirements"></a></h3> +<h3><a name="Requirements"></a>Requirements</h3> <ul> @@ -271,39 +270,43 @@ <li>ElasticSearch 1.5.2</li> </ul></div> <div class="section"> -<h3>James Launch<a name="James_Launch"></a></h3> +<h3><a name="James_Launch"></a>James Launch</h3> <p>To run james, you have to create a directory containing required configuration files.</p> <p>James requires the configuration to be in a subfolder of working directory that is called <b>conf</b>. You can get a sample directory for configuration from <a class="externalLink" href="https://github.com/apache/james-project/tree/master/dockerfiles/run/guice/cassandra/destination/conf";>dockerfiles/run/guice/cassandra/destination/conf</a>. You might need to adapt it to your needs.</p> <p>You also need to generate a keystore in your conf folder with the following command:</p> <div class="source"> +<div class="source"> <pre>$ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore -</pre></div> +</pre></div></div> <p>You need to have a Cassandra and an ElasticSearch instance running. You can either install the servers or launch them via docker:</p> <div class="source"> +<div class="source"> <pre>$ docker run -d --port 9042:9042 --name=cassandra cassandra:2.2.3 $ docker run -d --port 9200:9200 --port 9300:9300 --name=elasticsearch elasticsearch:2.2.1 -</pre></div> +</pre></div></div> <p>Once everything is set up, you just have to run the jar with:</p> <div class="source"> +<div class="source"> <pre>$ java -Dworking.directory=. -jar target/james-server-cassandra-guice.jar -</pre></div></div></div> +</pre></div></div></div></div> <div class="section"> -<h2>Guice-cassandra-ldap<a name="Guice-cassandra-ldap"></a></h2> +<h2><a name="Guice-cassandra-ldap"></a>Guice-cassandra-ldap</h2> <p>You can follow the same guide to build and run guice-cassandra-ldap artifact, except that: - The <b>jar</b> and <b>libs</b> needs to be retrieve from server/container/guice/cassandra-ldap-guice/target after compilation - The sample configuration can be found in <a class="externalLink" href="https://github.com/apache/james-project/tree/master/dockerfiles/run/guice/cassandra-ldap/destination/conf";>dockerfiles/run/guice/cassandra-ldap/destination/conf</a> - You need a running LDAP server to connect to. - You can then launch James via this command:</p> <div class="source"> +<div class="source"> <pre>$ java -Dworking.directory=. -jar target/james-server-cassandra-ldap-guice.jar -</pre></div></div> +</pre></div></div></div> </div> </div> <div class="clear"> <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved. http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/install/guice-jpa-smtp.html ---------------------------------------------------------------------- diff --git a/content/server/install/guice-jpa-smtp.html b/content/server/install/guice-jpa-smtp.html index 570cbc5..9df6252 100644 --- a/content/server/install/guice-jpa-smtp.html +++ b/content/server/install/guice-jpa-smtp.html @@ -18,11 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - </title> + <title>Apache James Project – Guice-JPA-SMTP installation guide</title> <style type="text/css" media="all"> @import url("../../css/james.css"); @import url("../../css/maven-base.css"); @@ -36,11 +36,9 @@ <script type="text/javascript" src="../../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - + <!-- Google Analytics --> <script type="text/javascript"> @@ -76,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../../index.html" title="Home">Home</a> | @@ -175,7 +173,7 @@ <a href="../../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../../other-versions.html" title="Other versions">Other versions</a> + <a href="../../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -232,9 +230,9 @@ <div id="contentBox"> <h1>Guice-JPA-SMTP installation guide</h1> <div class="section"> -<h2>Building<a name="Building"></a></h2> +<h2><a name="Building"></a>Building</h2> <div class="section"> -<h3>Requirements<a name="Requirements"></a></h3> +<h3><a name="Requirements"></a>Requirements</h3> <ul> @@ -245,7 +243,7 @@ <li>Maven</li> </ul></div> <div class="section"> -<h3>Building the artifacts<a name="Building_the_artifacts"></a></h3> +<h3><a name="Building_the_artifacts"></a>Building the artifacts</h3> <p>An usual compilation using maven of this <a class="externalLink" href="https://github.com/apache/james-project";>Git repository content</a> will produce two artifacts into server/container/guice/jpa-smtp/target directory :</p> <ul> @@ -255,28 +253,30 @@ <li>james-server-jpa-smtp-${version}.lib</li> </ul></div></div> <div class="section"> -<h2>Running<a name="Running"></a></h2> +<h2><a name="Running"></a>Running</h2> <div class="section"> -<h3>James Launch<a name="James_Launch"></a></h3> +<h3><a name="James_Launch"></a>James Launch</h3> <p>To run james, you have to create a directory containing required configuration files names <b>conf</b>.</p> <p>A <a class="externalLink" href="https://github.com/apache/james-project/tree/master/server/container/guice/jpa-smtp/sample-configuration";>sample directory</a> is provided with some default value you may need to replace.</p> <p>You also need to generate a keystore with the following command :</p> <div class="source"> +<div class="source"> <pre>$ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore -</pre></div> +</pre></div></div> <p>Once everything is set up, you just have to run the jar with :</p> <div class="source"> +<div class="source"> <pre>$ java -Dworking.directory=. -jar target/james-server-jpa-smtp-${version}.jar -</pre></div></div></div> +</pre></div></div></div></div> </div> </div> <div class="clear"> <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved. http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/install/guice-jpa.html ---------------------------------------------------------------------- diff --git a/content/server/install/guice-jpa.html b/content/server/install/guice-jpa.html index 3d21b3f..a502d4a 100644 --- a/content/server/install/guice-jpa.html +++ b/content/server/install/guice-jpa.html @@ -18,11 +18,11 @@ under the License. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> -<!-- Generated by Apache Maven Doxia at 2017-08-09 --> +<!-- Generated by Apache Maven Doxia at 2018-01-18 --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache James Project - </title> + <title>Apache James Project – Guice-JPA installation guide</title> <style type="text/css" media="all"> @import url("../../css/james.css"); @import url("../../css/maven-base.css"); @@ -36,11 +36,9 @@ <script type="text/javascript" src="../../js/jquery/js/jquery-ui-1.8.5.custom.min.js"></script> <script type="text/javascript" src="../../js/fancybox/jquery.fancybox-1.3.4.js"></script> <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20170809" /> + <meta name="Date-Revision-yyyymmdd" content="20180118" /> <meta http-equiv="Content-Language" content="en" /> - -<link rel="meta" href="http://james.apache.org//doap_james-project.rdf"; title="DOAP" type="application/rdf+xml"/> - + <!-- Google Analytics --> <script type="text/javascript"> @@ -76,7 +74,7 @@ <div class="xleft"> - <span id="publishDate">Last Published: 2017-08-09</span> + <span id="publishDate">Last Published: 2018-01-18</span> </div> <div class="xright"> <a href="../../index.html" title="Home">Home</a> | @@ -175,7 +173,7 @@ <a href="../../server/rfcs.html" title="RFCs">RFCs</a> </li> <li class="none"> - <a href="../../other-versions.html" title="Other versions">Other versions</a> + <a href="../../server/other-versions.html" title="Other versions">Other versions</a> </li> <li class="none"> <a href="../../download.cgi#Apache_James_Server" title="Download releases">Download releases</a> @@ -232,9 +230,9 @@ <div id="contentBox"> <h1>Guice-JPA installation guide</h1> <div class="section"> -<h2>Building<a name="Building"></a></h2> +<h2><a name="Building"></a>Building</h2> <div class="section"> -<h3>Requirements<a name="Requirements"></a></h3> +<h3><a name="Requirements"></a>Requirements</h3> <ul> @@ -245,7 +243,7 @@ <li>Maven 3</li> </ul></div> <div class="section"> -<h3>Building the artifacts<a name="Building_the_artifacts"></a></h3> +<h3><a name="Building_the_artifacts"></a>Building the artifacts</h3> <p>An usual compilation using maven of this <a class="externalLink" href="https://github.com/apache/james-project";>Git repository content</a> will produce two artifacts into server/container/guice/jpa-guice/target directory:</p> <ul> @@ -257,31 +255,34 @@ <p>You can for example run in the base of this git repository:</p> <div class="source"> +<div class="source"> <pre>mvn clean install -</pre></div></div></div> +</pre></div></div></div></div> <div class="section"> -<h2>Running<a name="Running"></a></h2> +<h2><a name="Running"></a>Running</h2> <div class="section"> -<h3>James Launch<a name="James_Launch"></a></h3> +<h3><a name="James_Launch"></a>James Launch</h3> <p>To run james, you have to create a directory containing required configuration files.</p> <p>James requires the configuration to be in a subfolder of working directory that is called <b>conf</b>. You can get a sample directory for configuration from <a class="externalLink" href="https://github.com/apache/james-project/tree/master/dockerfiles/run/guice/jpa/destination/conf";>dockerfiles/run/guice/jpa/destination/conf</a>. You might need to adapt it to your needs.</p> <p>You also need to generate a keystore in your conf folder with the following command:</p> <div class="source"> +<div class="source"> <pre>$ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore -</pre></div> +</pre></div></div> <p>Once everything is set up, you just have to run the jar with:</p> <div class="source"> +<div class="source"> <pre>$ java -Dworking.directory=. -jar target/james-server-jpa-guice.jar -</pre></div></div></div> +</pre></div></div></div></div> </div> </div> <div class="clear"> <hr/> </div> <div id="footer"> - <div class="xright">Copyright © 2006-2017 + <div class="xright">Copyright © 2006-2018 <a href="https://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved. --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
