http://git-wip-us.apache.org/repos/asf/james-site/blob/836f91b1/content/server/manage-cli.html ---------------------------------------------------------------------- diff --git a/content/server/manage-cli.html b/content/server/manage-cli.html index 19c14fc..1ca9e47 100644 --- a/content/server/manage-cli.html +++ b/content/server/manage-cli.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 – Manage James via the Command Line</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> @@ -235,68 +233,78 @@ <p>To use it enter, for Spring distrubution:</p> <div class="source"> +<div class="source"> <pre>./bin/james-cli.sh -h 127.0.0.1 -p 9999 COMMAND -</pre></div> +</pre></div></div> <p>And for Guice distributions:</p> <div class="source"> +<div class="source"> <pre>java -jar /root/james-cli.jar -h 127.0.0.1 -p 9999 COMMAND -</pre></div> +</pre></div></div> <p>The following document will explain you which are the available options for <b>COMMAND</b>.</p> <p>Note: the command line before <b>COMMAND</b> will be documente as <i>{cli}</i>.</p> <div class="section"> -<h2>Manage Domains<a name="Manage_Domains"></a></h2> +<h2><a name="Manage_Domains"></a>Manage Domains</h2> <p>Domains represent the domain names handled by your server.</p> <p>You can add a domain:</p> <div class="source"> +<div class="source"> <pre>{cli} AddDomain domain.tld -</pre></div> +</pre></div></div> <p>You can remove a domain:</p> <div class="source"> +<div class="source"> <pre>{cli} RemoveDomain domain.tld -</pre></div> +</pre></div></div> <p>(Note: associated users are not removed automatically)</p> <p>Check if a domain is handled:</p> <div class="source"> +<div class="source"> <pre>{cli} ContainsDomain domain.tld -</pre></div> +</pre></div></div> <p>And list your domains:</p> <div class="source"> +<div class="source"> <pre>{cli} ListDomains -</pre></div></div> +</pre></div></div></div> <div class="section"> -<h2>Managing users<a name="Managing_users"></a></h2> +<h2><a name="Managing_users"></a>Managing users</h2> <p>Note: the following commands are explained with virtual hosting turned on.</p> <p>Users are accounts on the mail server. James can maintain mailboxes for them.</p> <p>You can add a user:</p> <div class="source"> +<div class="source"> <pre>{cli} AddUser [email protected] password -</pre></div> +</pre></div></div> <p>Note: the domain used should have been previously created.</p> <p>You can delete a user:</p> <div class="source"> +<div class="source"> <pre>{cli} RemoveUser [email protected] -</pre></div> +</pre></div></div> <p>(Note: associated mailboxes are not removed automatically)</p> <p>And change a user password:</p> <div class="source"> +<div class="source"> <pre>{cli} SetPassword [email protected] password -</pre></div> +</pre></div></div> <p>Note: All these write operations can not be performed on LDAP backend, as the implementation is read-only.</p> <p>Finally, you can list users:</p> <div class="source"> +<div class="source"> <pre>{cli} ListUsers -</pre></div> +</pre></div></div> <div class="section"> -<h3>Virtual hosting<a name="Virtual_hosting"></a></h3> +<h3><a name="Virtual_hosting"></a>Virtual hosting</h3> <p>James supports virtualhosting.</p> <ul> @@ -315,12 +323,13 @@ <p>Here are some sample commands for managing users when virtual hosting is turned off:</p> <div class="source"> +<div class="source"> <pre>{cli} AddUser user password {cli} RemoveUser user {cli} SetPassword user password -</pre></div></div></div> +</pre></div></div></div></div> <div class="section"> -<h2>Managing mailboxes<a name="Managing_mailboxes"></a></h2> +<h2><a name="Managing_mailboxes"></a>Managing mailboxes</h2> <p>An administrator can perform some basic operation on user mailboxes.</p> <p>Note on mailbox formatting: mailboxes are composed of three parts.</p> @@ -335,33 +344,38 @@ <p>An administrator can delete all of the mailboxes of a user, which is not done automatically when removing a user (to avoid data loss):</p> <div class="source"> +<div class="source"> <pre>{cli} DeleteUserMailboxes [email protected] -</pre></div> +</pre></div></div> <p>He can delete a specific mailbox:</p> <div class="source"> +<div class="source"> <pre>{cli} DeleteMailbox #private [email protected] INBOX.toBeDeleted -</pre></div> +</pre></div></div> <p>He can list the mailboxes of a specific user:</p> <div class="source"> +<div class="source"> <pre>{cli} ListUserMailboxes [email protected] -</pre></div> +</pre></div></div> <p>And finally can create a specific mailbox:</p> <div class="source"> +<div class="source"> <pre>{cli} CreateMailbox #private [email protected] INBOX.newFolder -</pre></div></div> +</pre></div></div></div> <div class="section"> -<h2>Adding a message in a mailbox<a name="Adding_a_message_in_a_mailbox"></a></h2> +<h2><a name="Adding_a_message_in_a_mailbox"></a>Adding a message in a mailbox</h2> <p>The administrator can use the CLI to add a message in a mailbox. this can be done using:</p> <div class="source"> +<div class="source"> <pre>{cli} ImportEml #private [email protected] INBOX.newFolder /full/path/to/file.eml -</pre></div> +</pre></div></div> <p>This command will add a message having the content specified in file.eml (that needs to be at the EML format). It will get added in the INBOX.subFolder mailbox belonging to user <a class="externalLink" href="mailto:[email protected]";>[email protected]</a>.</p></div> <div class="section"> -<h2>Managing mappings<a name="Managing_mappings"></a></h2> +<h2><a name="Managing_mappings"></a>Managing mappings</h2> <p>A mapping is a recipient rewritting rule. There is several kind of rewritting rules:</p> <ul> @@ -373,120 +387,138 @@ <p>You can manage address mapping like (redirects email from <a class="externalLink" href="mailto:[email protected]";>[email protected]</a> to <a class="externalLink" href="mailto:[email protected]";>[email protected]</a>, then deletes the mapping):</p> <div class="source"> +<div class="source"> <pre>{cli} AddAddressMapping redirected domain.new [email protected] {cli} RemoveAddressMapping redirected domain.new [email protected] -</pre></div> +</pre></div></div> <p>You can manage regex mapping like this:</p> <div class="source"> +<div class="source"> <pre>{cli} AddRegexMapping redirected domain.new .*@domain.tld {cli} RemoveRegexMapping redirected domain.new .*@domain.tld -</pre></div> +</pre></div></div> <p>You can view mapping for a mail address:</p> <div class="source"> +<div class="source"> <pre>{cli} ListUserDomainMappings user domain.tld -</pre></div> +</pre></div></div> <p>And all mappings defined on the server:</p> <div class="source"> +<div class="source"> <pre>{cli} ListMappings -</pre></div></div> +</pre></div></div></div> <div class="section"> -<h2>Manage quotas<a name="Manage_quotas"></a></h2> +<h2><a name="Manage_quotas"></a>Manage quotas</h2> <p>Quotas are limitations on a group of mailboxes. They can limit the <b>size</b> or the <b>messages count</b> in a group of mailboxes.</p> <p>James groups by defaults mailboxes by user (but it can be overridden), and labels each group with a quotaroot.</p> <p>To get the quotaroot a given mailbox belongs to:</p> <div class="source"> +<div class="source"> <pre>{cli} GetQuotaroot #private [email protected] INBOX -</pre></div> +</pre></div></div> <p>Then you can get the specific quotaroot limitations.</p> <p>For the number of messages:</p> <div class="source"> +<div class="source"> <pre>{cli} GetMessageCountQuota quotaroot -</pre></div> +</pre></div></div> <p>And for the storage space available:</p> <div class="source"> +<div class="source"> <pre>{cli} GetStorageQuota quotaroot -</pre></div> +</pre></div></div> <p>You see the maximum allowed for these values:</p> <p>For the number of messages:</p> <div class="source"> +<div class="source"> <pre>{cli} GetMaxMessageCountQuota quotaroot -</pre></div> +</pre></div></div> <p>And for the storage space available:</p> <div class="source"> +<div class="source"> <pre>{cli} GetMaxStorageQuota quotaroot -</pre></div> +</pre></div></div> <p>You can also specify maximum for these values.</p> <p>For the number of messages:</p> <div class="source"> +<div class="source"> <pre>{cli} SetMaxMessageCountQuota quotaroot value -</pre></div> +</pre></div></div> <p>And for the storage space available:</p> <div class="source"> +<div class="source"> <pre>{cli} SetMaxStorageQuota quotaroot value -</pre></div> +</pre></div></div> <p>With value being an integer. Please note the use of units for storage (K, M, G). For instance:</p> <div class="source"> +<div class="source"> <pre>{cli} SetMaxStorageQuota [email protected] 4G -</pre></div> +</pre></div></div> <p>Moreover, James allows to specify defaults maximum values, at the server level. Note: syntax is similar to what was exposed previously.</p> <div class="source"> +<div class="source"> <pre>{cli} SetDefaultMaxMessageCountQuota value {cli} GetDefaultMaxMessageCountQuota {cli} SetDefaultMaxStorageQuota value {cli} GetDefaultMaxStorageQuota -</pre></div></div> +</pre></div></div></div> <div class="section"> -<h2>Re-indexing<a name="Re-indexing"></a></h2> +<h2><a name="Re-indexing"></a>Re-indexing</h2> <p>James allow you to index your emails in a search engine, for making search faster. Both ElasticSearch and Lucene are supported.</p> <p>For some reasons, you might want to re-index your mails (inconsistencies across datastore, migrations).</p> <p>To re-index all mails of all mailboxes of all users, type:</p> <div class="source"> +<div class="source"> <pre>{cli} ReindexAll -</pre></div> +</pre></div></div> <p>And for a precise mailbox:</p> <div class="source"> +<div class="source"> <pre>{cli} Reindex #private [email protected] INBOX -</pre></div></div> +</pre></div></div></div> <div class="section"> -<h2>Sieve scripts quota<a name="Sieve_scripts_quota"></a></h2> +<h2><a name="Sieve_scripts_quota"></a>Sieve scripts quota</h2> <p>James implements Sieve (RFC-5228). Your users can then writte scripts and upload them to the server. Thus they can define the desired behavior upon email reception. James defines a Sieve mailet for this, and stores Sieve scripts. You can update them via the ManageSieve protocol, or via the ManageSieveMailet.</p> <p>You can define quota for the total size of Sieve scripts, per user.</p> <p>Syntax is similar to what was exposed for quotas. For defaults values:</p> <div class="source"> +<div class="source"> <pre>{cli} GetSieveQuota {cli} SetSieveQuota value {cli} RemoveSieveQuota -</pre></div> +</pre></div></div> <p>And for specific user quotas:</p> <div class="source"> +<div class="source"> <pre>{cli} GetSieveUserQuota [email protected] {cli} SetSieveQuota [email protected] value {cli} RemoveSieveUserQuota [email protected] -</pre></div></div> +</pre></div></div></div> <div class="section"> -<h2>Switching of mailbox implementation<a name="Switching_of_mailbox_implementation"></a></h2> +<h2><a name="Switching_of_mailbox_implementation"></a>Switching of mailbox implementation</h2> <p>Migration is experimental for now. You would need to customize <b>Spring</b> configuration to add a new mailbox manager with a different bean name.</p> <p>You can then copy data accross mailbox managers using:</p> <div class="source"> +<div class="source"> <pre>{cli} CopyMailbox srcBean dstBean -</pre></div> +</pre></div></div> <p>You will then need to reconfigure James to use the new mailbox manager.</p></div> </div> </div> @@ -494,7 +526,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/manage-jmx.html ---------------------------------------------------------------------- diff --git a/content/server/manage-jmx.html b/content/server/manage-jmx.html index 3238731..7a1e465 100644 --- a/content/server/manage-jmx.html +++ b/content/server/manage-jmx.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 - Manage Domains</title> + <title>Apache James Project – Apache James Server 3 - Manage Domains</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> | @@ -159,27 +156,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>Manage via JMX<a name="Manage_via_JMX"></a></h2> +<h2><a name="Manage_via_JMX"></a>Manage via JMX</h2> <p>James can be managed via JMX.</p> @@ -219,7 +201,7 @@ <div class="section"> -<h2>Manage Domains via JMX<a name="Manage_Domains_via_JMX"></a></h2> +<h2><a name="Manage_Domains_via_JMX"></a>Manage Domains via JMX</h2> <p>Use a JMX client to access the DomainList management function.</p> @@ -241,7 +223,7 @@ <div class="section"> -<h2>Manage Users via JMX<a name="Manage_Users_via_JMX"></a></h2> +<h2><a name="Manage_Users_via_JMX"></a>Manage Users via JMX</h2> <p>Use and JMX client to access the Users management function.</p> @@ -263,7 +245,7 @@ <div class="section"> -<h2>Manage Virtual Users via JMX<a name="Manage_Virtual_Users_via_JMX"></a></h2> +<h2><a name="Manage_Virtual_Users_via_JMX"></a>Manage Virtual Users via JMX</h2> <p>Use and JMX client to access the Virtual User management function.</p> @@ -285,7 +267,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/manage-webadmin.html ---------------------------------------------------------------------- diff --git a/content/server/manage-webadmin.html b/content/server/manage-webadmin.html index aaba4c8..625ff4e 100644 --- a/content/server/manage-webadmin.html +++ b/content/server/manage-webadmin.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 – Web administration for JAMES</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> @@ -234,14 +232,26 @@ <p>The web administration supports for now the CRUD operations on the domains,the users, their mailboxes and their quotas, as described in the following sections.</p> <p><b>WARNING</b>: This API allow authentication only via the use of JWT. If not configured with JWT, an administrator should ensure an attacker can not use this API.</p> <p>Please also note <b>webadmin</b> is only enabled with <b>Guice</b>. You can not use it when using James with <b>Spring</b>, as the required injections are not implemented.</p> +<p>In case of any error, the system will return an error message which is json format like this:</p> + +<div class="source"> +<div class="source"> +<pre>{ + statusCode: <error_code>, + type: <error_type>, + message: <the_error_message> + cause: <the_detail_message_from_throwable> +} +</pre></div></div> <div class="section"> -<h2>Administrating domains<a name="Administrating_domains"></a></h2> +<h2><a name="Administrating_domains"></a>Administrating domains</h2> <div class="section"> -<h3>Create a domain<a name="Create_a_domain"></a></h3> +<h3><a name="Create_a_domain"></a>Create a domain</h3> <div class="source"> +<div class="source"> <pre>curl -XPUT http://ip:port/domains/domainToBeCreated -</pre></div> +</pre></div></div> <p>Resource name domainToBeCreated:</p> <ul> @@ -265,11 +275,12 @@ <li>500: Internal error while adding the domain</li> </ul></div> <div class="section"> -<h3>Delete a domain<a name="Delete_a_domain"></a></h3> +<h3><a name="Delete_a_domain"></a>Delete a domain</h3> <div class="source"> +<div class="source"> <pre>curl -XDELETE http://ip:port/domains/domainToBeDeleted -</pre></div> +</pre></div></div> <p>Response codes:</p> <ul> @@ -279,11 +290,12 @@ <li>500: Internal error while removing the domain</li> </ul></div> <div class="section"> -<h3>Test if a domain exists<a name="Test_if_a_domain_exists"></a></h3> +<h3><a name="Test_if_a_domain_exists"></a>Test if a domain exists</h3> <div class="source"> +<div class="source"> <pre>curl -XGET http://ip:port/domains/domainName -</pre></div> +</pre></div></div> <p>Response codes:</p> <ul> @@ -295,16 +307,18 @@ <li>500: Internal error while accessing the domains</li> </ul></div> <div class="section"> -<h3>Get the list of domains<a name="Get_the_list_of_domains"></a></h3> +<h3><a name="Get_the_list_of_domains"></a>Get the list of domains</h3> <div class="source"> +<div class="source"> <pre>curl -XGET http://ip:port/domains -</pre></div> +</pre></div></div> <p>Possible response:</p> <div class="source"> +<div class="source"> <pre>{"domains":["domain1", "domain2"]} -</pre></div> +</pre></div></div> <p>Response codes:</p> <ul> @@ -314,13 +328,14 @@ <li>500: Internal error while accessing the domains</li> </ul></div></div> <div class="section"> -<h2>Administrating users<a name="Administrating_users"></a></h2> +<h2><a name="Administrating_users"></a>Administrating users</h2> <div class="section"> -<h3>Create a user<a name="Create_a_user"></a></h3> +<h3><a name="Create_a_user"></a>Create a user</h3> <div class="source"> +<div class="source"> <pre>curl -XPUT http://ip:port/users/usernameToBeUsed -d '{"password":"passwordToBeUsed"}' -</pre></div> +</pre></div></div> <p>Resource name usernameToBeUsed:</p> <ul> @@ -345,15 +360,16 @@ </ul> <p>Note: if the user is already, its password will be updated.</p></div> <div class="section"> -<h3>Updating a user password<a name="Updating_a_user_password"></a></h3> +<h3><a name="Updating_a_user_password"></a>Updating a user password</h3> <p>Same than Create, but a user need to exist.</p> <p>If the user do not exist, then it will be created.</p></div> <div class="section"> -<h3>Deleting a user<a name="Deleting_a_user"></a></h3> +<h3><a name="Deleting_a_user"></a>Deleting a user</h3> <div class="source"> +<div class="source"> <pre>curl -XDELETE http://ip:port/users/userToBeDeleted -</pre></div> +</pre></div></div> <p>Response codes:</p> <ul> @@ -363,16 +379,18 @@ <li>500: Internal error while deleting the user</li> </ul></div> <div class="section"> -<h3>Retrieving the user list<a name="Retrieving_the_user_list"></a></h3> +<h3><a name="Retrieving_the_user_list"></a>Retrieving the user list</h3> <div class="source"> +<div class="source"> <pre>curl -XGET http://ip:port/users -</pre></div> +</pre></div></div> <p>The answer looks like:</p> <div class="source"> +<div class="source"> <pre>[{"username":"[email protected]"},{"username":"[email protected]"}] -</pre></div> +</pre></div></div> <p>Response codes:</p> <ul> @@ -382,13 +400,14 @@ <li>500: Internal error while retrieving the users</li> </ul></div></div> <div class="section"> -<h2>Administrating user mailboxes<a name="Administrating_user_mailboxes"></a></h2> +<h2><a name="Administrating_user_mailboxes"></a>Administrating user mailboxes</h2> <div class="section"> -<h3>Creating a mailbox<a name="Creating_a_mailbox"></a></h3> +<h3><a name="Creating_a_mailbox"></a>Creating a mailbox</h3> <div class="source"> +<div class="source"> <pre>curl -XPUT http://ip:port/users/usernameToBeUsed/mailboxes/mailboxNameToBeCreated -</pre></div> +</pre></div></div> <p>Resource name usernameToBeUsed should be an existing user Resource name mailboxNameToBeCreated should not be empty, nor contain # & % * characters.</p> <p>Response codes:</p> @@ -405,14 +424,16 @@ <p>To create nested mailboxes, for instance a work mailbox inside the INBOX mailbox, people should use the . separator. The sample query is:</p> <div class="source"> +<div class="source"> <pre>curl -XDELETE http://ip:port/users/usernameToBeUsed/mailboxes/INBOX.work -</pre></div></div> +</pre></div></div></div> <div class="section"> -<h3>Deleting a mailbox and its children<a name="Deleting_a_mailbox_and_its_children"></a></h3> +<h3><a name="Deleting_a_mailbox_and_its_children"></a>Deleting a mailbox and its children</h3> <div class="source"> +<div class="source"> <pre>curl -XDELETE http://ip:port/users/usernameToBeUsed/mailboxes/mailboxNameToBeCreated -</pre></div> +</pre></div></div> <p>Resource name usernameToBeUsed should be an existing user Resource name mailboxNameToBeCreated should not be empty</p> <p>Response codes:</p> @@ -427,11 +448,12 @@ <li>500: Internal error</li> </ul></div> <div class="section"> -<h3>Testing existence of a mailbox<a name="Testing_existence_of_a_mailbox"></a></h3> +<h3><a name="Testing_existence_of_a_mailbox"></a>Testing existence of a mailbox</h3> <div class="source"> +<div class="source"> <pre>curl -XGET http://ip:port/users/usernameToBeUsed/mailboxes/mailboxNameToBeCreated -</pre></div> +</pre></div></div> <p>Resource name usernameToBeUsed should be an existing user Resource name mailboxNameToBeCreated should not be empty</p> <p>Response codes:</p> @@ -446,16 +468,18 @@ <li>500: Internal error</li> </ul></div> <div class="section"> -<h3>Listing user mailboxes<a name="Listing_user_mailboxes"></a></h3> +<h3><a name="Listing_user_mailboxes"></a>Listing user mailboxes</h3> <div class="source"> +<div class="source"> <pre>curl -XGET http://ip:port/users/usernameToBeUsed/mailboxes -</pre></div> +</pre></div></div> <p>The answer looks like:</p> <div class="source"> +<div class="source"> <pre>[{"mailboxName":"INBOX"},{"mailboxName":"outbox"}] -</pre></div> +</pre></div></div> <p>Resource name usernameToBeUsed should be an existing user</p> <p>Response codes:</p> @@ -468,11 +492,12 @@ <li>500: Internal error</li> </ul></div> <div class="section"> -<h3>Deleting user mailboxes<a name="Deleting_user_mailboxes"></a></h3> +<h3><a name="Deleting_user_mailboxes"></a>Deleting user mailboxes</h3> <div class="source"> +<div class="source"> <pre>curl -XDELETE http://ip:port/users/usernameToBeUsed/mailboxes -</pre></div> +</pre></div></div> <p>Resource name usernameToBeUsed should be an existing user</p> <p>Response codes:</p> @@ -485,26 +510,29 @@ <li>500: Internal error</li> </ul></div></div> <div class="section"> -<h2>Administrating quotas<a name="Administrating_quotas"></a></h2> +<h2><a name="Administrating_quotas"></a>Administrating quotas</h2> <p>A quota with a value of -1 means unlimited</p> <div class="section"> -<h3>Reading per quotaroot mail count limitation<a name="Reading_per_quotaroot_mail_count_limitation"></a></h3> +<h3><a name="Reading_per_quotaroot_mail_count_limitation"></a>Reading per quotaroot mail count limitation</h3> <div class="source"> +<div class="source"> <pre>curl -XGET http://ip:port/quota/count -</pre></div> +</pre></div></div> <p>The answer looks like:</p> <div class="source"> +<div class="source"> <pre>100000 -</pre></div> +</pre></div></div> <p>Response codes: - 200: Nothing special - 500: Internal error</p></div> <div class="section"> -<h3>Updating per quotaroot mail count limitation<a name="Updating_per_quotaroot_mail_count_limitation"></a></h3> +<h3><a name="Updating_per_quotaroot_mail_count_limitation"></a>Updating per quotaroot mail count limitation</h3> <div class="source"> +<div class="source"> <pre>curl -XPUT http://ip:port/quota/count -d '1024000000' -</pre></div> +</pre></div></div> <p>Response codes:</p> <ul> @@ -516,12 +544,13 @@ <li>500: Internal error</li> </ul></div> <div class="section"> -<h3>Removing per quotaroot mail count limitation<a name="Removing_per_quotaroot_mail_count_limitation"></a></h3> +<h3><a name="Removing_per_quotaroot_mail_count_limitation"></a>Removing per quotaroot mail count limitation</h3> <p>It removes the limitation, and the quota becomes UNILIMITED.</p> <div class="source"> +<div class="source"> <pre>curl -XDELETE http://ip:port/quota/count -</pre></div> +</pre></div></div> <p>Response codes:</p> <ul> @@ -531,16 +560,18 @@ <li>500: Internal error</li> </ul></div> <div class="section"> -<h3>Reading per quotaroot size limitation<a name="Reading_per_quotaroot_size_limitation"></a></h3> +<h3><a name="Reading_per_quotaroot_size_limitation"></a>Reading per quotaroot size limitation</h3> <div class="source"> +<div class="source"> <pre>curl -XGET http://ip:port/quota/size -</pre></div> +</pre></div></div> <p>The answer looks like:</p> <div class="source"> +<div class="source"> <pre>100000 -</pre></div> +</pre></div></div> <p>It represent the allowed Byte count of the mailboxes belonging to this quotaroot.</p> <p>Response codes:</p> @@ -551,11 +582,12 @@ <li>500: Internal error</li> </ul></div> <div class="section"> -<h3>Updating per quotaroot size limitation<a name="Updating_per_quotaroot_size_limitation"></a></h3> +<h3><a name="Updating_per_quotaroot_size_limitation"></a>Updating per quotaroot size limitation</h3> <div class="source"> +<div class="source"> <pre>curl -XPUT http://ip:port/quota/size -d '1024000000' -</pre></div> +</pre></div></div> <p>Response codes:</p> <ul> @@ -567,12 +599,13 @@ <li>500: Internal error</li> </ul></div> <div class="section"> -<h3>Removing per quotaroot size limitation<a name="Removing_per_quotaroot_size_limitation"></a></h3> +<h3><a name="Removing_per_quotaroot_size_limitation"></a>Removing per quotaroot size limitation</h3> <p>It removes the limitation, and the quota becomes UNILIMITED.</p> <div class="source"> +<div class="source"> <pre>curl -XDELETE http://ip:port/quota/size -</pre></div> +</pre></div></div> <p>Response codes:</p> <ul> @@ -582,16 +615,18 @@ <li>500: Internal error</li> </ul></div> <div class="section"> -<h3>Managing count and size at the same time<a name="Managing_count_and_size_at_the_same_time"></a></h3> +<h3><a name="Managing_count_and_size_at_the_same_time"></a>Managing count and size at the same time</h3> <div class="source"> +<div class="source"> <pre>curl -XGET http://ip:port/quota/ -</pre></div> +</pre></div></div> <p>Will return:</p> <div class="source"> +<div class="source"> <pre>{"count":52,"size":42} -</pre></div> +</pre></div></div> <p>Response codes:</p> <ul> @@ -603,8 +638,9 @@ <p>You can also write the value the same way:</p> <div class="source"> +<div class="source"> <pre>curl -XPUT http://ip:port/quota/ -d '{"count":52,"size":42}' -</pre></div> +</pre></div></div> <p>Response codes:</p> <ul> @@ -616,23 +652,25 @@ <li>500: Internal error</li> </ul></div></div> <div class="section"> -<h2>Cassandra Schema upgrades<a name="Cassandra_Schema_upgrades"></a></h2> +<h2><a name="Cassandra_Schema_upgrades"></a>Cassandra Schema upgrades</h2> <p>Cassandra upgrades implies the creation of a new table. Thus restarting James is needed, as new tables are created on restart.</p> <p>Once done, we ship code that tries to read from new tables, and if not possible backs up to old tables. You can thus safely run without running additional migrations.</p> <p>On the fly migration can be enabled. However, one might want to force the migration in a controlled fashion, and update automatically current schema version used (assess in the database old versions is no more used, as the corresponding tables are empty). Note that this process is safe: we ensure the service is not running concurrently on this James instance, that it does not bump version upon partial failures, that race condition in version upgrades will be idempotent, etc…</p> <p>These schema updates can be triggered by webadmin using the Cassandra backend.</p> <p>Note that currently the progress can be tracked by logs.</p> <div class="section"> -<h3>Retrieving current Cassandra schema version<a name="Retrieving_current_Cassandra_schema_version"></a></h3> +<h3><a name="Retrieving_current_Cassandra_schema_version"></a>Retrieving current Cassandra schema version</h3> <div class="source"> +<div class="source"> <pre>curl -XGET http://ip:port/cassandra/version -</pre></div> +</pre></div></div> <p>Will return:</p> <div class="source"> +<div class="source"> <pre>2 -</pre></div> +</pre></div></div> <p>Where the number corresponds to the current schema version of the database you are using.</p> <p>Response codes:</p> @@ -643,16 +681,18 @@ <li>500: Internal error</li> </ul></div> <div class="section"> -<h3>Retrieving latest available Cassandra schema version<a name="Retrieving_latest_available_Cassandra_schema_version"></a></h3> +<h3><a name="Retrieving_latest_available_Cassandra_schema_version"></a>Retrieving latest available Cassandra schema version</h3> <div class="source"> +<div class="source"> <pre>curl -XGET http://ip:port/cassandra/version -</pre></div> +</pre></div></div> <p>Will return:</p> <div class="source"> +<div class="source"> <pre>3 -</pre></div> +</pre></div></div> <p>Where the number corresponds to the latest available schema version of the database you are using. This means you can be migrating to this schema version.</p> <p>Response codes:</p> @@ -663,52 +703,348 @@ <li>500: Internal error</li> </ul></div> <div class="section"> -<h3>Upgrading to a specific version<a name="Upgrading_to_a_specific_version"></a></h3> +<h3><a name="Upgrading_to_a_specific_version"></a>Upgrading to a specific version</h3> <div class="source"> +<div class="source"> <pre>curl -XPOST http://ip:port/cassandra/version/upgrade -d '3' -</pre></div> -<p>Will run the migrations you need to reach schema version 3.</p> +</pre></div></div> +<p>Will schedule the run of the migrations you need to reach schema version 3. The <tt>taskId</tt> will allow you to monitor and manage this process.</p> + +<div class="source"> +<div class="source"> +<pre>{"taskId":"3294a976-ce63-491e-bd52-1b6f465ed7a2"} +</pre></div></div> <p>Response codes:</p> <ul> -<li>204: Success</li> +<li>200: Success. The scheduled task taskId is returned.</li> <li>400: The version is invalid. The version should be a strictly positive number.</li> -<li>410: Error running the migration. This resource is gone away. Reason is mentionned in the body.</li> +<li>410: Error while planning this migration. This resource is gone away. Reason is mentionned in the body.</li> -<li>500: Internal error. This can result from a partial migration, in which case the reason is contained in the body.</li> +<li>500: Internal error while creating the migration task.</li> </ul> <p>Note that several calls to this endpoint will be run in a sequential pattern.</p> -<p>If the server restarts during the migration, the migration is silently aborted.</p></div> +<p>If the server restarts during the migration, the migration is silently aborted.</p> +<p>The scheduled task will have the following type <tt>CassandraMigration</tt> and the following <tt>additionalInformation</tt>:</p> + +<div class="source"> +<div class="source"> +<pre>{"toVersion":3} +</pre></div></div></div> <div class="section"> -<h3>Upgrading to the latest version<a name="Upgrading_to_the_latest_version"></a></h3> +<h3><a name="Upgrading_to_the_latest_version"></a>Upgrading to the latest version</h3> <div class="source"> +<div class="source"> <pre>curl -XPOST http://ip:port/cassandra/version/upgrade/latest -</pre></div> -<p>Will run the migrations you need to reach the latest schema version.</p> +</pre></div></div> +<p>Will schedule the run of the migrations you need to reach the latest schema version. The <tt>taskId</tt> will allow you to monitor and manage this process.</p> + +<div class="source"> +<div class="source"> +<pre>{"taskId":"3294a976-ce63-491e-bd52-1b6f465ed7a2"} +</pre></div></div> +<p>Positionned headers:</p> + +<ul> + +<li>Location header indicates the location of the resource associated with the scheduled task. Example:</li> +</ul> + +<div class="source"> +<div class="source"> +<pre>Location: /tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2 +</pre></div></div> <p>Response codes:</p> <ul> -<li>204: Success</li> +<li>200: Success. The scheduled task taskId is returned.</li> -<li>410: Error running the migration. This resource is gone away. Reason is mentionned in the body.</li> +<li>410: Error while planning this migration. This resource is gone away. Reason is mentionned in the body.</li> -<li>500: Internal error. This can result from a partial migration, in which case the reason is contained in the body.</li> +<li>500: Internal error while creating the migration task.</li> </ul> <p>Note that several calls to this endpoint will be run in a sequential pattern.</p> -<p>If the server restarts during the migration, the migration is silently aborted.</p></div></div> +<p>If the server restarts during the migration, the migration is silently aborted.</p> +<p>The scheduled task will have the following type <tt>CassandraMigration</tt> and the following <tt>additionalInformation</tt>:</p> + +<div class="source"> +<div class="source"> +<pre>{"toVersion":2} +</pre></div></div></div></div> +<div class="section"> +<h2><a name="Correcting_ghost_mailbox"></a>Correcting ghost mailbox</h2> +<p>This is a temporary workaround for the <b>Ghost mailbox</b> bug encountered using the Cassandra backend, as described in MAILBOX-322.</p> +<p>You can use the mailbox merging feature in order to merge the old “ghosted” mailbox with the new one.</p> + +<div class="source"> +<div class="source"> +<pre>curl -XPOST http://ip:port/cassandra/mailbox/merging -d '{"mergeOrigin":"id1", "mergeDestination":"id2"}' +</pre></div></div> +<p>Will scedule a task for :</p> + +<ul> + +<li>Delete references to <tt>id1</tt> mailbox</li> + +<li>Move it’s messages into <tt>id2</tt> mailbox</li> + +<li>Union the rights of both mailboxes</li> +</ul> +<p>The response to that request will be the scheduled <tt>taskId</tt> :</p> + +<div class="source"> +<div class="source"> +<pre>{"taskId":"5641376-02ed-47bd-bcc7-76ff6262d92a"} +</pre></div></div> +<p>Positionned headers:</p> + +<ul> + +<li>Location header indicates the location of the resource associated with the scheduled task. Example:</li> +</ul> + +<div class="source"> +<div class="source"> +<pre>Location: /tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2 +</pre></div></div> +<p>Response codes:</p> + +<ul> + +<li>201: Success. Corresponding task id is returned.</li> + +<li>400: Unable to parse the body.</li> +</ul> +<p>The scheduled task will have the following type <tt>mailboxMerging</tt> and the following <tt>additionalInformation</tt>:</p> + +<div class="source"> +<div class="source"> +<pre>{ + "oldMailboxId":"5641376-02ed-47bd-bcc7-76ff6262d92a", + "newMailboxId":"4555159-52ae-895f-ccb7-586a4412fb50", + "totalMessageCount": 1, + "messageMovedCount": 1, + "messageFailedCount": 0 +} +</pre></div></div></div> +<div class="section"> +<h2><a name="Creating_address_group"></a>Creating address group</h2> +<p>You can use <b>webadmin</b> to define address groups.</p> +<p>When a specific email is sent to the group mail address, every group member will receive it.</p> +<p>This feature uses <a href="/server/config-recipientrewritetable.html">Recipients rewrite table</a> and requires the <a class="externalLink" href="https://github.com/apache/james-project/blob/master/server/mailet/mailets/src/main/java/org/apache/james/transport/mailets/RecipientRewriteTable.java";>RecipientRewriteTable mailet</a> to be configured.</p> +<p>Note that email addresses are restricted to ASCII character set. Mail addresses not matching this criteria will be rejected.</p> +<div class="section"> +<h3><a name="Listing_groups"></a>Listing groups</h3> + +<div class="source"> +<div class="source"> +<pre>curl -XGET http://ip:port/address/groups +</pre></div></div> +<p>Will return the groups as a list of JSON Strings representing mail addresses. For instance:</p> + +<div class="source"> +<div class="source"> +<pre>["[email protected]", "[email protected]"] +</pre></div></div> +<p>Response codes:</p> + +<ul> + +<li>200: Success</li> + +<li>500: Internal error</li> +</ul></div> +<div class="section"> +<h3><a name="Listing_members_of_a_group"></a>Listing members of a group</h3> + +<div class="source"> +<div class="source"> +<pre>curl -XGET http://ip:port/address/groups/[email protected] +</pre></div></div> +<p>Will return the group members as a list of JSON Strings representing mail addresses. For instance:</p> + +<div class="source"> +<div class="source"> +<pre>["[email protected]", "[email protected]"] +</pre></div></div> +<p>Response codes:</p> + +<ul> + +<li>200: Success</li> + +<li>400: Group structure is not valid</li> + +<li>404: The group does not exist</li> + +<li>500: Internal error</li> +</ul></div> +<div class="section"> +<h3><a name="Adding_a_group_member"></a>Adding a group member</h3> + +<div class="source"> +<div class="source"> +<pre>curl -XPUT http://ip:port/address/groups/[email protected]/[email protected] +</pre></div></div> +<p>Will add <a class="externalLink" href="mailto:[email protected]";>[email protected]</a> to <a class="externalLink" href="mailto:[email protected]";>[email protected]</a>, creating the group if needed</p> +<p>Response codes:</p> + +<ul> + +<li>200: Success</li> + +<li>400: Group structure or member is not valid</li> + +<li>403: Server does not own the requested domain</li> + +<li>409: Requested group address is already used for another purpose</li> + +<li>500: Internal error</li> +</ul></div> +<div class="section"> +<h3><a name="Removing_a_group_member"></a>Removing a group member</h3> + +<div class="source"> +<div class="source"> +<pre>curl -XDELETE http://ip:port/address/groups/[email protected]/[email protected] +</pre></div></div> +<p>Will remove <a class="externalLink" href="mailto:[email protected]";>[email protected]</a> from <a class="externalLink" href="mailto:[email protected]";>[email protected]</a>, removing the group if group is empty after deletion</p> +<p>Response codes:</p> + +<ul> + +<li>200: Success</li> + +<li>400: Group structure or member is not valid</li> + +<li>500: Internal error</li> +</ul></div></div> +<div class="section"> +<h2><a name="Task_management"></a>Task management</h2> +<p>Some webadmin features schedules tasks. The task management API allow to monitor and manage the execution of the following tasks.</p> +<p>Note that the <tt>taskId</tt> used in the following APIs is returned by other WebAdmin APIs scheduling tasks.</p> +<div class="section"> +<h3><a name="Getting_a_task_details"></a>Getting a task details</h3> + +<div class="source"> +<div class="source"> +<pre>curl -XGET http://ip:port/tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2 +</pre></div></div> +<p>An Execution Report will be returned:</p> + +<div class="source"> +<div class="source"> +<pre>{ + "submitDate": "2017-12-27T15:15:24.805+0700", + "startedDate": "2017-12-27T15:15:24.809+0700", + "completedDate": "2017-12-27T15:15:24.815+0700", + "cancelledDate": null, + "failedDate": null, + "taskId": "3294a976-ce63-491e-bd52-1b6f465ed7a2", + "additionalInformation": {}, + "status": "completed", + "type": "typeOfTheTask" +} +</pre></div></div> +<p>Note that:</p> + +<ul> + +<li> +<p><tt>status</tt> can have the value:</p> + +<ul> + +<li><tt>waiting</tt>: The task is scheduled but its execution did not start yet</li> + +<li><tt>inProgress</tt>: The task is currently executed</li> + +<li><tt>cancelled</tt>: The task had been cancelled</li> + +<li><tt>completed</tt>: The task execution is finished, and this execution is a success</li> + +<li><tt>failed</tt>: The task execution is finished, and this execution is a failure</li> + </ul></li> + +<li> +<p><tt>additionalInformation</tt> is a task specific object giving additional information and context about that task. The structure of this <tt>additionalInformation</tt> field is provided along the specific task submission endpoint.</p></li> +</ul> +<p>Response codes:</p> + +<ul> + +<li>200: The specific task was found and the execution report exposed above is returned</li> + +<li>400: Invalid task ID</li> + +<li>404: Task ID was not found</li> +</ul></div> +<div class="section"> +<h3><a name="Awaiting_a_task"></a>Awaiting a task</h3> +<p>One can await the end of a task, then receive it’s final execution report.</p> +<p>That feature is especially usefull for testing purpose but still can serve real-life scenari.</p> + +<div class="source"> +<div class="source"> +<pre>curl -XGET http://ip:port/tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2/await +</pre></div></div> +<p>An Execution Report will be returned.</p> +<p>Response codes:</p> + +<ul> + +<li>200: The specific task was found and the execution report exposed above is returned</li> + +<li>400: Invalid task ID</li> + +<li>404: Task ID was not found</li> +</ul></div> +<div class="section"> +<h3><a name="Cancelling_a_task"></a>Cancelling a task</h3> +<p>You can cancel a task by calling:</p> + +<div class="source"> +<div class="source"> +<pre>curl -XDELETE http://ip:port/tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2 +</pre></div></div> +<p>Response codes: - 204: Task had been cancelled - 400: Invalid task ID</p></div> +<div class="section"> +<h3><a name="Listing_tasks"></a>Listing tasks</h3> +<p>A list of all tasks can be retrieved:</p> + +<div class="source"> +<div class="source"> +<pre>curl -XGET /tasks +</pre></div></div> +<p>Will return a list of Execution reports</p> +<p>One can filter the above results by status. For example:</p> + +<div class="source"> +<div class="source"> +<pre>curl -XGET /tasks?status=inProgress +</pre></div></div> +<p>Will return a list of Execution reports that are currently in progress.</p> +<p>Response codes:</p> + +<ul> + +<li>200: A list of corresponding tasks is returned</li> + +<li>400: Invalid status value</li> +</ul></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/manage.html ---------------------------------------------------------------------- diff --git a/content/server/manage.html b/content/server/manage.html index 1281ea6..f0e9f2d 100644 --- a/content/server/manage.html +++ b/content/server/manage.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 - Manage James Server</title> + <title>Apache James Project – Apache James Server 3 - Manage James Server</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,27 +228,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>Manage James Server<a name="Manage_James_Server"></a></h2> +<h2><a name="Manage_James_Server"></a>Manage James Server</h2> <p>You need to make sure that your user/domain/mail repository configuration is correct before managing. If @@ -287,7 +269,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/metrics.html ---------------------------------------------------------------------- diff --git a/content/server/metrics.html b/content/server/metrics.html index ee9d4be..0ca15a4 100644 --- a/content/server/metrics.html +++ b/content/server/metrics.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 - Metrics</title> + <title>Apache James Project – Apache James Server 3 - Metrics</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,27 +228,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>Presentation<a name="Presentation"></a></h2> +<h2><a name="Presentation"></a>Presentation</h2> <p>James relies on the <a class="externalLink" href="http://metrics.dropwizard.io/3.1.0/manual/core/";>Dropwizard metric library</a> @@ -261,11 +243,17 @@ <p>Such metrics are made available via JMX. You can connect for instance using VisualVM and the associated mbean plugins.</p> + +<p> + You can also export the metrics to ElasticSearch and visualize them with <a class="externalLink" href="https://grafana.com/";>Grafana</a>. + See <a href="config-elasticsearch.html">elaticseach.properties</a> documentation for more details on how to set this up. + </p> + </div> <div class="section"> -<h2>Available metrics<a name="Available_metrics"></a></h2> +<h2><a name="Available_metrics"></a>Available metrics</h2> <p> @@ -273,6 +261,8 @@ </p> <ul> +<li>James JVM metrics</li> + <li>Number of active SMTP connections</li> <li>Number of SMTP commands received</li> @@ -304,7 +294,11 @@ <li>Per mailet and per matcher Response time percentiles</li> <li>Diverse Response time percentiles, counts and rates for DNS</li> + +<li>Cassandra Java driver metrics</li> </ul> + + Retrieve <a class="externalLink" href="https://github.com/apache/james-project/tree/master/grafana-reporting";>available boards</a> for Grafana. <img src="images/performances/metrics.png" alt="" /> @@ -319,7 +313,7 @@ <div class="section"> -<h2>Limitations<a name="Limitations"></a></h2> +<h2><a name="Limitations"></a>Limitations</h2> <p>Those metrics are only available with Guice.</p> @@ -335,7 +329,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/monitor-folders.html ---------------------------------------------------------------------- diff --git a/content/server/monitor-folders.html b/content/server/monitor-folders.html index 36faaca..8e21e4a 100644 --- a/content/server/monitor-folders.html +++ b/content/server/monitor-folders.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 - Monitor Folders</title> + <title>Apache James Project – Apache James Server 3 - Monitor Folders</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,31 +228,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>Monitor Folders<a name="Monitor_Folders"></a></h2> +<h2><a name="Monitor_Folders"></a>Monitor Folders</h2> <div class="section"> -<h3>Monitor ./var Folder Usage<a name="Monitor_.var_Folder_Usage"></a></h3> +<h3><a name="Monitor_.var_Folder_Usage"></a>Monitor ./var Folder Usage</h3> <p>The directory structure in ./var is shown hereafter.</p> @@ -356,7 +338,7 @@ jackrabbit <div class="section"> -<h3>Monitor tmp Folder Usage<a name="Monitor_tmp_Folder_Usage"></a></h3> +<h3><a name="Monitor_tmp_Folder_Usage"></a>Monitor tmp Folder Usage</h3> <p>For some certain functions, James uses the system temporary folder (/tmp on linux). @@ -376,7 +358,7 @@ jackrabbit <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/monitor-jmx.html ---------------------------------------------------------------------- diff --git a/content/server/monitor-jmx.html b/content/server/monitor-jmx.html index 1f32319..1820c23 100644 --- a/content/server/monitor-jmx.html +++ b/content/server/monitor-jmx.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 - Monitor via JMX</title> + <title>Apache James Project – Apache James Server 3 - Monitor via JMX</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,44 +228,13 @@ </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>Monitor via JMX<a name="Monitor_via_JMX"></a></h2> -<!-- Additional Notes to be documented -- - - - - - - - - - - - - - - - - - what you mean with how I see permanent errors ? - unknow users are in ValidRcptHandler - but if someone would just ignore the 5xx return code on rcpt and suply the data it would return a permanent error - so yes it could be in there too - maybe we should only count the first 5xx in a transaction - - for the rejected message, I would except to be counted as ok in the stats - why - it's not an smtp protocol error - 5xx is an error - thats the whole point of the stats - see how many messages are rejected via permanent error and how many via temporary error - what's the difference between permanet and temporary ? - temporary will get try to redelivered later - like greylisting is temporary --> +<h2><a name="Monitor_via_JMX"></a>Monitor via JMX</h2> + <p>You can monitor James Server via JMX.</p> @@ -309,7 +275,7 @@ <div class="section"> -<h2>Statistics via JMX<a name="Statistics_via_JMX"></a></h2> +<h2><a name="Statistics_via_JMX"></a>Statistics via JMX</h2> <p>You can enable satistics collection for SMTP/LMPT/POP3 Servers via JMX. @@ -331,7 +297,7 @@ <div class="section"> -<h2>Statistics via JMX<a name="Statistics_via_JMX"></a></h2> +<h2><a name="Statistics_via_JMX"></a>Statistics via JMX</h2> <p>You can enable satistics collection for SMTP/LMPT/POP3 Servers via JMX. @@ -344,7 +310,7 @@ <div class="section"> -<h2>JMX Remote Access<a name="JMX_Remote_Access"></a></h2> +<h2><a name="JMX_Remote_Access"></a>JMX Remote Access</h2> <p>If you want a remote access, you can install a web application management tool such as jmanage. @@ -370,7 +336,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/monitor-logging.html ---------------------------------------------------------------------- diff --git a/content/server/monitor-logging.html b/content/server/monitor-logging.html index 2c1d7df..862f532 100644 --- a/content/server/monitor-logging.html +++ b/content/server/monitor-logging.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 - Monitor via Logging</title> + <title>Apache James Project – Apache James Server 3 - Monitor via Logging</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,27 +228,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>Monitor via Logging<a name="Monitor_via_Logging"></a></h2> +<h2><a name="Monitor_via_Logging"></a>Monitor via Logging</h2> <p>Use the well-known log4j system.</p> @@ -591,7 +573,7 @@ log4j.logger.james.domainlist=INFO, DOMAINLIST <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/monitor.html ---------------------------------------------------------------------- diff --git a/content/server/monitor.html b/content/server/monitor.html index 3e7e689..f0b02ae 100644 --- a/content/server/monitor.html +++ b/content/server/monitor.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 - Monitor James Server</title> + <title>Apache James Project – Apache James Server 3 - Monitor James Server</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,38 +228,23 @@ </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>Monitor James Server<a name="Monitor_James_Server"></a></h2> +<h2><a name="Monitor_James_Server"></a>Monitor James Server</h2> <div class="section"> -<h3>Live Grafana metrics<a name="Live_Grafana_metrics"></a></h3> +<h3><a name="Live_Grafana_metrics"></a>Live Grafana metrics</h3> <p>You can monitor James Server via live Grafana metrics - <a href="metrics.html">read more</a>.</p> </div> <div class="section"> -<h3>Monitor James Server via Loging<a name="Monitor_James_Server_via_Loging"></a></h3> +<h3><a name="Monitor_James_Server_via_Loging"></a>Monitor James Server via Loging</h3> <p>You can monitor James Server via logging - <a href="monitor-logging.html">read more</a>.</p> @@ -271,7 +253,7 @@ <div class="section"> -<h3>Monitor James Server via JMX<a name="Monitor_James_Server_via_JMX"></a></h3> +<h3><a name="Monitor_James_Server_via_JMX"></a>Monitor James Server via JMX</h3> <p>You can monitor James Server via JMX - <a href="monitor-jmx.html">read more</a>.</p> @@ -280,7 +262,7 @@ <div class="section"> -<h3>Monitor James Server Folders Usage<a name="Monitor_James_Server_Folders_Usage"></a></h3> +<h3><a name="Monitor_James_Server_Folders_Usage"></a>Monitor James Server Folders Usage</h3> <p>You also should monitor folder usage - <a href="monitor-folders.html">read more</a>.</p> @@ -298,7 +280,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/objectives.html ---------------------------------------------------------------------- diff --git a/content/server/objectives.html b/content/server/objectives.html index f8f4b97..808e347 100644 --- a/content/server/objectives.html +++ b/content/server/objectives.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 - Objectives</title> + <title>Apache James Project – Apache James Server 3 - Objectives</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> | @@ -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,27 +191,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>Design goals<a name="Design_goals"></a></h2> +<h2><a name="Design_goals"></a>Design goals</h2> <p> <i> @@ -266,7 +248,7 @@ <div class="section"> -<h2>Standard compliance<a name="Standard_compliance"></a></h2> +<h2><a name="Standard_compliance"></a>Standard compliance</h2> <p>It is the existence of published "open" standards which allows independent teams to develop interoperable software. @@ -325,7 +307,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. --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
